Configurar el servidor MCP de Mokbi.

Qué necesitas

• Node 20 o superior en la máquina donde se ejecuta tu agente. Compruébalo con node --version.
• Un agente compatible con MCP. Claude Code, Cursor, Codex y Windsurf funcionan; sirve cualquiera que hable el Model Context Protocol.
• Las SDK Platform-Tools de Android Studio y un emulador con Android 13 o superior (API 33+). Por debajo no existe el idioma por app y el dispositivo tendría que reiniciarse en cada idioma. Define ANDROID_HOME si las herramientas no están en tu PATH.
• Una cuenta de Mokbi con el proyecto que quieres llenar. Todo se deja listo dentro de un proyecto, así que créalo antes si aún no existe.
• La captura en iOS todavía no está incluida. Necesita macOS y llegará aparte; hoy la parte de captura es Android.

1. Revisa tu máquina

Ejecuta npx -y @mokbi/mcp doctor. Muestra tu versión de Node, dónde busca adb y el emulador, y si has iniciado sesión. Lo que salga con ✗ es lo primero que hay que arreglar: las herramientas de captura no pueden esquivar un SDK que falta.

2. Añade el servidor a tu agente

En Claude Code basta un comando:

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

En Cursor, Codex, Windsurf y otros hosts, añade a tu configuración de MCP un servidor con el comando npx y los argumentos ["-y","@mokbi/mcp"]. Reinicia después el host para que lo detecte.

3. Inicia sesión una vez

Ejecuta npx -y @mokbi/mcp login. Tu navegador abre Mokbi, tú apruebas la solicitud y el token vuelve a 127.0.0.1: nunca viaja en una URL. La pantalla de aprobación indica un número de puerto; comprueba que coincide con el que imprimió la terminal antes de aprobar.

¿No hay navegador en esa máquina? Ejecuta npx -y @mokbi/mcp login --paste y crea el token tú mismo en Mokbi → menú → Agente (MCP) → "Acceso de agente" → "Nuevo token". El token se ve una sola vez, así que cópialo enseguida.

El token se guarda en ~/.mokbi/config.json con permisos 0600. No es tu sesión: revocarlo no afecta a tu cuenta. Para CI, la variable de entorno MOKBI_TOKEN tiene prioridad sobre el archivo.

4. Tu primera ronda

Pídele a tu agente el flujo de capturas. El servidor incluye tres comandos de barra y en Claude Code aparecen tal cual:

• /mokbi:screenshots — leer el repositorio, proponer qué pantallas capturar, hacer un idioma para que lo revises y, tras tu visto bueno, ejecutar todos los idiomas y dejar el conjunto listo.
• /mokbi:localize — redactar los textos de tu ficha dentro de los límites de caracteres de cada tienda.
• /mokbi:check — informar de lo que está listo y de lo que falta por idioma y por tienda.

También puedes describir sin más lo que quieres; el servidor le explica a tu agente cómo debe ir el flujo. Deja que la primera ronda cubra un solo idioma: así un toque equivocado cuesta una ronda en vez de veinte.

5. Aplica lo que tu agente dejó listo

Abre tu proyecto en el editor. La entrega espera en "De tu agente": el botón del robot en la barra, el mismo panel que menú → Agente (MCP) → "Acceso de agente", y el botón "De tu agente" en el menú Capturas. El indicador de ese botón cuenta lo que está esperando.

• "Aplicar" coloca las capturas según el plan que aparece sobre el botón: qué captura va en qué panel y para qué idioma. Un Ctrl+Z saca el conjunto entero.
• "Aplicar y diseñar" aparece cuando tu agente ha enviado un breve brief sobre tu app. Lanza la misma ronda del AI Designer que el botón naranja del editor, al mismo precio de 2 créditos, con las capturas ya listas.
• "Aceptar todo" aparece cuando hay textos de tienda o traducciones de rótulos en bloque. Los aplica en un paso, y un deshacer los quita todos.
• "Descartar" elimina una entrega que no quieres. Tu agente siempre puede volver a enviarla.

Nada se aplica automáticamente, y es a propósito. El editor es el único que escribe tu proyecto: una pestaña abierta guarda el documento entero. Si una entrega cayera directamente en tu diseño, una pestaña del editor abierta en otro sitio podría sobrescribirla en silencio.

Cuando algo va mal

• "adb not found". Las SDK Platform-Tools no están instaladas o no están en tu PATH. Instálalas desde el SDK Manager de Android Studio o define ANDROID_HOME apuntando a tu carpeta del SDK.
• El emulador aparece como 'offline' justo después de arrancar. Un emulador recién iniciado sigue arrancando un rato después de decir que está listo. El servidor espera tres señales de arranque y reintenta; dale un minuto antes de cortar.
• "El idioma no cambió". Tras fijarlo volvemos a leer lo que informa el dispositivo. Si no coincide, lo más probable es que tu app no incluya ese idioma, o que ya estuviera abierta en otro. Repite la ronda para ese idioma.
• Dos idiomas se ven idénticos. Es la comprobación haciendo su trabajo: las pantallas son iguales, así que tu app no está traducida a ese idioma. Publica el idioma cuando tu app lo esté.
• El inicio de sesión por navegador no termina. Usa npx -y @mokbi/mcp login --paste y pega un token creado en el editor.
• No hay nada esperando en el editor. Comprueba que tienes abierto el mismo proyecto al que envió tu agente y que el token sigue siendo válido: npx -y @mokbi/mcp doctor.
• La ronda se queda en una pantalla que tu app nunca alcanza. El controlador de captura informa de qué pantalla estaba mirando, con imagen incluida. Devuélvesela a tu agente y ajusta el flujo; el servidor no prueba tu app por ti.

Qué puede y qué no puede hacer el token

• Deja listo, no publica. Publicar en la App Store y en Google Play sigue estando en Mokbi, con tu clic.
• No puede gastar dinero. Una ronda de diseño se paga desde tu propia sesión del editor cuando pulsas el botón, nunca desde el agente.
• No es tu sesión. Revócalo en menú → Agente (MCP) → "Acceso de agente" y tu cuenta queda intacta. Cada token muestra cuándo se usó por última vez.
• Tu código se queda contigo. La mitad de captura se ejecuta entera en tu máquina; solo las imágenes y los textos terminados llegan a tu proyecto.

Abrir el editor → Qué hace el servidor MCP