도움말 · 에이전트 (MCP)

Mokbi MCP 서버 설정하기.

요약. 서버를 에이전트에 추가하고 터미널에서 한 번 로그인한 다음 /mokbi:screenshots를 요청하세요. 에이전트가 당신 컴퓨터에서 앱을 모든 언어로 캡처해 세트를 Mokbi 프로젝트에 올려둡니다. 당신은 에디터에서 한 번의 클릭으로 적용하면 됩니다.

필요한 것

Node 20 이상, 에이전트가 돌아가는 컴퓨터에서요. node --version으로 확인하세요.
MCP를 지원하는 에이전트. Claude Code, Cursor, Codex, Windsurf 모두 됩니다. Model Context Protocol을 말하는 것이면 무엇이든 좋아요.
Android Studio의 SDK Platform-Tools와 에뮬레이터, Android 13 이상(API 33+). 그 아래에서는 앱별 언어 설정이 없어 언어마다 기기를 재시작해야 합니다. 도구가 PATH에 없다면 ANDROID_HOME을 설정하세요.
채우려는 프로젝트가 있는 Mokbi 계정. 결과는 프로젝트 안에 올라가므로, 없다면 먼저 만들어 두세요.
iOS 캡처는 아직 포함되지 않았습니다. macOS가 필요해 따로 나올 예정이고, 지금 캡처 쪽은 Android입니다.

1. 컴퓨터 점검하기

npx -y @mokbi/mcp doctor를 실행하세요. Node 버전, adb와 에뮬레이터를 찾는 위치, 로그인 여부를 보여 줍니다. ✗ 표시가 붙은 건 먼저 해결하세요 — 캡처 도구는 없는 SDK를 우회하지 못합니다.

2. 서버를 에이전트에 추가하기

Claude Code에서는 명령 하나면 됩니다:

claude mcp add mokbi -- npx -y @mokbi/mcp

Cursor, Codex, Windsurf 등 다른 호스트에서는 MCP 설정에 명령 npx, 인자 ["-y","@mokbi/mcp"]로 서버를 추가하세요. 그런 다음 호스트를 재시작해 서버를 인식시키면 됩니다.

3. 한 번만 로그인하기

npx -y @mokbi/mcp login을 실행하세요. 브라우저가 Mokbi를 열고, 당신이 요청을 승인하면 토큰이 127.0.0.1로 돌아옵니다 — 절대 URL에 실려 다니지 않아요. 승인 화면에 포트 번호가 표시되니, 승인 전에 터미널이 출력한 번호와 같은지 확인하세요.

그 컴퓨터에 브라우저가 없나요? npx -y @mokbi/mcp login --paste를 실행하고 Mokbi → 메뉴 → 에이전트 (MCP) → "에이전트 액세스" → "새 토큰"에서 직접 토큰을 만드세요. 토큰은 한 번만 보이니 바로 복사해 두세요.

토큰은 ~/.mokbi/config.json에 권한 0600으로 저장됩니다. 당신의 세션이 아니라서, 취소해도 계정에는 영향이 없어요. CI에서는 환경 변수 MOKBI_TOKEN이 파일보다 우선합니다.

4. 첫 라운드

에이전트에게 스크린샷 흐름을 요청하세요. 서버는 슬래시 명령 세 개를 함께 제공하고, Claude Code에서는 그대로 나타납니다:

/mokbi:screenshots — 저장소를 읽고, 어떤 화면을 캡처할지 제안하고, 확인용으로 한 언어를 돌린 다음, 당신이 승인하면 모든 언어를 돌려 세트를 올려둡니다.
/mokbi:localize — 각 스토어의 글자 수 제한 안에서 스토어 텍스트를 작성합니다.
/mokbi:check — 무엇이 준비됐고 언어별·스토어별로 무엇이 빠졌는지 알려 줍니다.

그냥 원하는 걸 설명해도 됩니다. 서버가 에이전트에게 흐름이 어떠해야 하는지 직접 알려 주니까요. 첫 라운드는 한 언어만 다루게 하세요. 그러면 잘못 누른 화면 하나가 스무 라운드가 아니라 한 라운드만 잡아먹습니다.

5. 에이전트가 올려둔 결과 적용하기

에디터에서 프로젝트를 여세요. 전달된 항목은 "에이전트에서" 아래에 기다리고 있습니다 — 툴바의 로봇 버튼, 메뉴 → 에이전트 (MCP) → "에이전트 액세스"와 같은 패널, 그리고 스크린샷 메뉴의 "에이전트에서" 버튼입니다. 그 버튼의 배지가 대기 중인 개수를 알려 줘요.

"적용"은 버튼 위에 표시된 계획대로 스크린샷을 배치합니다. 어떤 이미지가 어느 패널에, 어떤 언어로 들어가는지죠. Ctrl+Z 한 번이면 세트 전체가 되돌아갑니다.
"적용하고 디자인"은 에이전트가 앱에 대한 짧은 브리프를 함께 보냈을 때 나타납니다. 에디터의 주황색 버튼과 같은 AI Designer 라운드를, 같은 2 크레딧으로, 올려둔 스크린샷을 써서 실행해요.
"모두 수락"은 스토어 텍스트나 캡션 번역이 한꺼번에 대기 중일 때 나옵니다. 한 단계로 적용하고, 한 번의 실행 취소로 전부 되돌립니다.
"버리기"는 원하지 않는 항목을 지웁니다. 에이전트는 언제든 다시 보낼 수 있어요.

자동으로 적용되는 건 없고, 그건 의도된 설계입니다. 프로젝트를 기록하는 주체는 에디터 하나뿐이라, 열려 있는 탭은 문서 전체를 되저장합니다. 전달된 항목이 곧장 디자인에 들어간다면, 다른 곳에 열어 둔 에디터 탭이 그것을 조용히 덮어쓸 수 있어요.

문제가 생겼을 때

"adb not found". SDK Platform-Tools가 설치되지 않았거나 PATH에 없습니다. Android Studio의 SDK Manager로 설치하거나 ANDROID_HOME을 SDK 폴더로 지정하세요.
에뮬레이터가 켜자마자 'offline'으로 보입니다. 새로 띄운 에뮬레이터는 준비됐다고 알린 뒤에도 한동안 부팅을 계속합니다. 서버는 부팅 신호 세 개를 기다리고 재시도하니, 끊기 전에 1분쯤 기다려 주세요.
"언어가 바뀌지 않았습니다". 설정한 뒤 기기가 보고하는 값을 다시 읽습니다. 어긋난다면 앱에 그 언어가 없거나, 앱이 이미 다른 언어로 떠 있었을 가능성이 큽니다. 그 언어의 라운드를 다시 돌리세요.
두 언어가 똑같아 보입니다. 검사가 제 일을 한 겁니다. 화면이 같다면 그 언어로 앱이 번역되지 않은 것이니, 앱이 준비됐을 때 그 언어를 내보내세요.
브라우저 로그인이 끝나지 않습니다. npx -y @mokbi/mcp login --paste를 쓰고, 에디터에서 만든 토큰을 붙여 넣으세요.
에디터에 대기 중인 게 없습니다. 에이전트가 보낸 프로젝트와 같은 프로젝트를 열었는지, 토큰이 아직 유효한지 확인하세요: npx -y @mokbi/mcp doctor.
앱이 도달하지 않는 화면에서 라운드가 멈춥니다. 캡처 드라이버가 어떤 화면을 보고 있었는지 이미지와 함께 알려 줍니다. 그걸 에이전트에 돌려주고 흐름을 손보세요. 서버가 대신 앱을 테스트해 주지는 않습니다.

토큰이 할 수 있는 일과 없는 일

올려두기만 하고 게시하지 않습니다. App Store와 Google Play 게시는 Mokbi에서, 당신의 클릭으로 이뤄집니다.
돈을 쓸 수 없습니다. 디자인 라운드 비용은 당신이 버튼을 누르는 순간 당신의 에디터 세션에서 나갑니다. 에이전트가 결제하는 일은 없어요.
당신의 세션이 아닙니다. 메뉴 → 에이전트 (MCP) → "에이전트 액세스"에서 취소해도 계정은 그대로입니다. 토큰마다 마지막 사용 시각이 보입니다.
코드는 당신 곁에 남습니다. 캡처 쪽은 전부 당신 컴퓨터에서 돌아가고, 프로젝트로는 완성된 이미지와 텍스트만 전송됩니다.

에디터 열기 → MCP 서버가 하는 일