Configurar o servidor MCP do Mokbi.

O que você precisa

• Node 20 ou mais novo na máquina em que o seu agente roda. Confira com node --version.
• Um agente que fale MCP. Claude Code, Cursor, Codex e Windsurf funcionam; qualquer um que fale o Model Context Protocol serve.
• As SDK Platform-Tools do Android Studio e um emulador com Android 13 ou mais novo (API 33+). Abaixo disso não existe idioma por app e o aparelho teria que reiniciar a cada idioma. Defina ANDROID_HOME se as ferramentas não estiverem no seu PATH.
• Uma conta Mokbi com o projeto que você quer preencher. Tudo é preparado dentro de um projeto, então crie o projeto antes se ele ainda não existir.
• A captura no iOS ainda não está incluída. Ela precisa do macOS e vem à parte; hoje o lado da captura é Android.

1. Confira a sua máquina

Rode npx -y @mokbi/mcp doctor. Ele mostra a sua versão do Node, onde procura o adb e o emulador, e se você está autenticado. O que estiver com ✗ é o primeiro a resolver — as ferramentas de captura não contornam um SDK que falta.

2. Adicione o servidor ao seu agente

No Claude Code, um comando basta:

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

No Cursor, no Codex, no Windsurf e em outros hosts, adicione à sua configuração de MCP um servidor com o comando npx e os argumentos ["-y","@mokbi/mcp"]. Depois reinicie o host para ele reconhecer o servidor.

3. Entre uma vez

Rode npx -y @mokbi/mcp login. Seu navegador abre o Mokbi, você aprova o pedido e o token volta para 127.0.0.1 — ele nunca viaja numa URL. A tela de aprovação mostra um número de porta; confira se bate com o que o terminal imprimiu antes de aprovar.

Sem navegador nessa máquina? Rode npx -y @mokbi/mcp login --paste e crie o token você mesmo em Mokbi → menu → Agente (MCP) → "Acesso do agente" → "Novo token". O token aparece uma única vez, então copie na hora.

O token fica em ~/.mokbi/config.json com permissões 0600. Ele não é a sua sessão: revogá-lo não mexe na sua conta. Para CI, a variável de ambiente MOKBI_TOKEN tem prioridade sobre o arquivo.

4. Sua primeira rodada

Peça o fluxo de capturas ao seu agente. O servidor traz três comandos de barra e, no Claude Code, eles aparecem exatamente assim:

• /mokbi:screenshots — ler o repositório, propor quais telas capturar, rodar um idioma para você conferir e, com o seu aval, rodar todos os idiomas e deixar o conjunto pronto.
• /mokbi:localize — escrever os textos da loja dentro dos limites de caracteres de cada uma.
• /mokbi:check — informar o que está pronto e o que ainda falta por idioma e por loja.

Você também pode só descrever o que quer; o próprio servidor explica ao agente como o fluxo deve ser. Deixe a primeira rodada cobrir um idioma só. Assim um toque errado custa uma rodada em vez de vinte.

5. Aplique o que seu agente deixou pronto

Abra o projeto no editor. A entrega está esperando em "Do seu agente" — o botão do robô na barra, o mesmo painel de menu → Agente (MCP) → "Acesso do agente", e o botão "Do seu agente" no menu Capturas de tela. O selo nesse botão conta o que está esperando.

• "Aplicar" posiciona as capturas conforme o plano mostrado acima do botão: qual captura vai em qual painel, para qual idioma. Um Ctrl+Z tira o conjunto inteiro.
• "Aplicar e criar o design" aparece quando o seu agente mandou um briefing curto sobre o app. Isso roda a mesma rodada do AI Designer do botão laranja do editor, pelo mesmo preço de 2 créditos, usando as capturas entregues.
• "Aceitar tudo" aparece quando há textos de loja ou traduções de legendas em lote. Aplica tudo em um passo, e um desfazer remove todos.
• "Descartar" remove uma entrega que você não quer. Seu agente sempre pode enviar de novo.

Nada é aplicado automaticamente, e isso é de propósito. O editor é o único que escreve no seu projeto: uma aba aberta salva o documento inteiro de volta. Se uma entrega caísse direto no seu design, uma aba do editor esquecida aberta em outro lugar poderia sobrescrevê-la em silêncio.

Quando algo dá errado

• "adb not found". As SDK Platform-Tools não estão instaladas ou não estão no seu PATH. Instale pelo SDK Manager do Android Studio, ou defina ANDROID_HOME apontando para a pasta do SDK.
• O emulador fica 'offline' logo depois de iniciar. Um emulador recém-aberto continua carregando depois de dizer que está pronto. O servidor espera três sinais de boot e tenta de novo; dê um minuto antes de encerrar.
• "O idioma não mudou". Depois de definir, lemos de volta o que o aparelho informa. Se não bater, o mais provável é que o app não traga aquele idioma, ou que já estivesse aberto em outro. Refaça a rodada para esse idioma.
• Dois idiomas ficaram idênticos. É a checagem fazendo o trabalho dela: as telas são iguais, então o seu app não está traduzido para aquele idioma. Publique o idioma quando o app estiver.
• O login pelo navegador não conclui. Use npx -y @mokbi/mcp login --paste e cole um token criado no editor.
• Não há nada esperando no editor. Verifique se você está com o mesmo projeto para onde o agente enviou, e se o token ainda é válido: npx -y @mokbi/mcp doctor.
• A rodada trava numa tela que o app nunca alcança. O driver de captura informa a tela que estava olhando, com imagem. Devolva isso ao seu agente e ajuste o fluxo; o servidor não testa o app por você.

O que o token pode e o que não pode

• Ele deixa pronto, não publica. Publicar na App Store e no Google Play continua sendo no Mokbi, com o seu clique.
• Ele não gasta dinheiro. Uma rodada de design é paga pela sua própria sessão do editor quando você aperta o botão, nunca pelo agente.
• Ele não é a sua sessão. Revogue em menu → Agente (MCP) → "Acesso do agente" e a sua conta continua intacta. Cada token mostra quando foi usado pela última vez.
• Seu código fica com você. A metade de captura roda inteira na sua máquina; só as imagens e os textos prontos vão para o seu projeto.

Abrir o editor → O que o servidor MCP faz