Configurer le serveur MCP de Mokbi.

Ce qu'il te faut

• Node 20 ou plus récent sur la machine où tourne ton agent. Vérifie avec node --version.
• Un agent compatible MCP. Claude Code, Cursor, Codex et Windsurf fonctionnent tous ; tout ce qui parle le Model Context Protocol convient.
• Les SDK Platform-Tools d'Android Studio et un émulateur sous Android 13 ou plus récent (API 33+). En dessous, la langue par app n'existe pas et l'appareil devrait redémarrer à chaque langue. Définis ANDROID_HOME si les outils ne sont pas dans ton PATH.
• Un compte Mokbi avec le projet à remplir. Le dépôt se fait dans un projet, alors crée-le d'abord s'il n'existe pas.
• La capture iOS n'est pas encore incluse. Elle demande macOS et viendra séparément ; aujourd'hui, la capture c'est Android.

1. Vérifie ta machine

Lance npx -y @mokbi/mcp doctor. Il affiche ta version de Node, où il cherche adb et l'émulateur, et si tu es connecté. Tout ce qui porte un ✗ est à corriger en premier — les outils de capture ne peuvent pas contourner un SDK manquant.

2. Ajoute le serveur à ton agent

Dans Claude Code, une commande suffit :

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

Dans Cursor, Codex, Windsurf et les autres hôtes, ajoute à ta configuration MCP un serveur avec la commande npx et les arguments ["-y","@mokbi/mcp"]. Redémarre ensuite l'hôte pour qu'il le prenne en compte.

3. Connecte-toi une fois

Lance npx -y @mokbi/mcp login. Ton navigateur ouvre Mokbi, tu valides la demande, et le jeton revient sur 127.0.0.1 — il ne passe jamais par une URL. L'écran de validation indique un numéro de port ; vérifie qu'il correspond à celui affiché par le terminal avant de valider.

Pas de navigateur sur cette machine ? Lance npx -y @mokbi/mcp login --paste et crée le jeton toi-même dans Mokbi → menu → Agent (MCP) → "Accès agent" → "Nouveau jeton". Le jeton n'est affiché qu'une fois, alors copie-le tout de suite.

Le jeton est stocké dans ~/.mokbi/config.json avec les permissions 0600. Ce n'est pas ta session : le révoquer ne touche pas à ton compte. Pour la CI, la variable d'environnement MOKBI_TOKEN a priorité sur le fichier.

4. Ta première série

Demande le flux de captures à ton agent. Le serveur fournit trois commandes slash, et dans Claude Code elles apparaissent telles quelles :

• /mokbi:screenshots — lire le dépôt, proposer les écrans à capturer, faire une langue pour que tu vérifies, puis, après ton accord, toutes les langues et déposer le lot.
• /mokbi:localize — rédiger les textes de ta fiche dans les limites de caractères de chaque store.
• /mokbi:check — indiquer ce qui est déposé et ce qui manque encore par langue et par store.

Tu peux aussi simplement décrire ce que tu veux ; le serveur explique lui-même à ton agent comment le flux est censé se dérouler. Fais couvrir une seule langue à la première série. Une erreur de tap coûte alors une série au lieu de vingt.

5. Applique ce que ton agent a déposé

Ouvre ton projet dans l'éditeur. La livraison attend sous "De ton agent" — le bouton robot de la barre d'outils, le même panneau que menu → Agent (MCP) → "Accès agent", et le bouton "De ton agent" dans le menu Captures d'écran. La pastille sur ce bouton compte ce qui attend.

• "Appliquer" place les captures selon le plan affiché au-dessus du bouton : quelle capture dans quel panneau, pour quelle langue. Un Ctrl+Z retire tout le lot.
• "Appliquer et concevoir" apparaît quand ton agent a joint un court brief sur ton app. Cela lance la même série AI Designer que le bouton orange de l'éditeur, au même prix de 2 crédits, avec les captures déposées.
• "Tout accepter" s'affiche quand des textes de store ou des traductions de légendes attendent en lot. Tout est appliqué en une étape, et une annulation les retire tous.
• "Jeter" supprime une livraison dont tu ne veux pas. Ton agent peut toujours renvoyer.

Rien n'est appliqué automatiquement, et c'est voulu. L'éditeur est le seul rédacteur de ton projet : un onglet ouvert réécrit le document entier. Si une livraison tombait directement dans ton design, un onglet d'éditeur resté ouvert ailleurs pourrait l'écraser sans bruit.

Quand quelque chose cloche

• "adb not found". Les SDK Platform-Tools ne sont pas installés ou ne sont pas dans ton PATH. Installe-les via le SDK Manager d'Android Studio, ou définis ANDROID_HOME sur ton dossier SDK.
• L'émulateur est 'offline' juste après le démarrage. Un émulateur frais continue de démarrer après s'être déclaré prêt. Le serveur attend trois signaux de démarrage et réessaie ; laisse-lui une minute avant de couper.
• "La langue n'a pas changé". Après le réglage, nous relisons ce que l'appareil déclare. En cas de désaccord, ton app ne livre probablement pas cette langue, ou elle tournait déjà dans une autre. Relance la série pour cette langue.
• Deux langues semblent identiques. C'est le contrôle qui fait son travail : les écrans sont les mêmes, donc ton app n'est pas traduite pour cette langue. Publie la langue quand ton app l'est aussi.
• La connexion par navigateur n'aboutit pas. Utilise npx -y @mokbi/mcp login --paste et colle un jeton créé dans l'éditeur.
• Rien n'attend dans l'éditeur. Vérifie que tu as ouvert le même projet que celui visé par ton agent, et que le jeton est encore valide : npx -y @mokbi/mcp doctor.
• La série bloque sur un écran que ton app n'atteint jamais. Le pilote de capture indique l'écran qu'il regardait, avec une image. Renvoie ça à ton agent et ajuste le parcours ; le serveur ne teste pas ton app à ta place.

Ce que le jeton peut et ne peut pas faire

• Il dépose, il ne publie pas. La publication sur l'App Store et Google Play reste dans Mokbi, sur ton clic.
• Il ne peut pas dépenser d'argent. Une série de design est payée depuis ta propre session d'éditeur quand tu appuies sur le bouton, jamais par l'agent.
• Ce n'est pas ta session. Révoque-le dans menu → Agent (MCP) → "Accès agent" et ton compte reste intact. Chaque jeton indique sa dernière utilisation.
• Ton code reste chez toi. La moitié capture tourne entièrement sur ta machine ; seules les images et les textes finis partent vers ton projet.

Ouvrir l'éditeur → Ce que fait le serveur MCP