Den Mokbi MCP-Server einrichten.

Was du brauchst

• Node 20 oder neuer auf dem Rechner, auf dem dein Agent läuft. Prüfen mit node --version.
• Einen Agenten, der MCP spricht. Claude Code, Cursor, Codex und Windsurf funktionieren alle; alles, was das Model Context Protocol spricht, geht.
• Die SDK Platform-Tools von Android Studio und einen Emulator mit Android 13 oder neuer (API 33+). Darunter gibt es keine App-Sprache pro App, und das Gerät müsste für jede Sprache neu starten. Setze ANDROID_HOME, wenn die Tools nicht in deinem PATH liegen.
• Ein Mokbi-Konto mit dem Projekt, das du füllen willst. Bereitgelegt wird in ein Projekt, also lege es vorher an, falls es noch nicht existiert.
• iOS-Aufnahme ist noch nicht dabei. Das braucht macOS und kommt separat; heute ist die Aufnahmeseite Android.

1. Prüfe deinen Rechner

Führe npx -y @mokbi/mcp doctor aus. Es zeigt deine Node-Version, wo es adb und den Emulator sucht, und ob du angemeldet bist. Alles mit ✗ behebst du zuerst — die Aufnahme-Tools kommen um ein fehlendes SDK nicht herum.

2. Füge den Server deinem Agenten hinzu

In Claude Code reicht ein Befehl:

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

In Cursor, Codex, Windsurf und anderen Hosts trägst du in deiner MCP-Konfiguration einen Server mit dem Befehl npx und den Argumenten ["-y","@mokbi/mcp"] ein. Starte den Host danach neu, damit er den Server aufnimmt.

3. Melde dich einmal an

Führe npx -y @mokbi/mcp login aus. Dein Browser öffnet Mokbi, du stimmst der Anfrage zu, und das Token kommt an 127.0.0.1 zurück — es steht nie in einer URL. Der Freigabe-Bildschirm nennt eine Portnummer; prüfe vor dem Zustimmen, dass sie zu der im Terminal passt.

Kein Browser auf dem Rechner? Führe npx -y @mokbi/mcp login --paste aus und erstelle das Token selbst in Mokbi → Menü → Agent (MCP) → "Agent-Zugriff" → "Neues Token". Du siehst das Token nur einmal, also kopiere es sofort.

Das Token liegt in ~/.mokbi/config.json mit den Rechten 0600. Es ist nicht deine Session: Ein Widerruf rührt dein Konto nicht an. Für CI hat die Umgebungsvariable MOKBI_TOKEN Vorrang vor der Datei.

4. Dein erster Durchgang

Bitte deinen Agenten um den Screenshot-Flow. Der Server bringt drei Slash-Befehle mit, und in Claude Code erscheinen sie genau so:

• /mokbi:screenshots — das Repo lesen, vorschlagen, welche Screens aufgenommen werden, eine Sprache zur Kontrolle durchlaufen und nach deinem Okay alle Sprachen fahren und den Satz bereitlegen.
• /mokbi:localize — deine Store-Texte innerhalb der Zeichenlimits jedes Stores entwerfen.
• /mokbi:check — melden, was bereitliegt und was pro Sprache pro Store noch fehlt.

Du kannst auch einfach beschreiben, was du willst; der Server erklärt deinem Agenten selbst, wie der Ablauf gedacht ist. Lass den ersten Durchgang eine Sprache machen. Ein falscher Tipp kostet dann einen Durchgang statt zwanzig.

5. Übernimm, was dein Agent bereitgelegt hat

Öffne dein Projekt im Editor. Die Lieferung wartet unter "Von deinem Agenten" — dem Roboter-Button in der Leiste, demselben Panel wie Menü → Agent (MCP) → "Agent-Zugriff", und dem Button "Von deinem Agenten" im Screenshots-Menü. Das Zeichen auf dem Button zählt, was wartet.

• "Übernehmen" platziert die Screenshots nach dem Plan über dem Button: welcher Screenshot in welches Panel, für welche Sprache. Ein Ctrl+Z holt den ganzen Satz wieder heraus.
• "Übernehmen & gestalten" erscheint, wenn dein Agent ein kurzes Briefing zu deiner App mitgeschickt hat. Das startet dieselbe AI-Designer-Runde wie der orange Button im Editor, zum selben Preis von 2 Credits, mit den bereitgelegten Screenshots.
• "Alles übernehmen" taucht auf, wenn Store-Texte oder Untertitel-Übersetzungen im Bündel bereitliegen. Das übernimmt sie in einem Schritt, und ein Rückgängig entfernt sie alle.
• "Verwerfen" entfernt eine Lieferung, die du nicht willst. Dein Agent kann jederzeit erneut pushen.

Nichts wird automatisch übernommen, und das ist Absicht. Der Editor ist der einzige Schreiber deines Projekts: Ein offener Tab schreibt das ganze Dokument zurück. Fiele eine Lieferung direkt in dein Design, könnte ein woanders offener Editor-Tab sie still überschreiben.

Wenn etwas schiefgeht

• "adb not found". Die SDK Platform-Tools sind nicht installiert oder liegen nicht in deinem PATH. Installiere sie über den SDK Manager von Android Studio, oder setze ANDROID_HOME auf deinen SDK-Ordner.
• Der Emulator ist direkt nach dem Start 'offline'. Ein frischer Emulator bootet noch weiter, nachdem er sich als bereit meldet. Der Server wartet auf drei Boot-Signale und versucht es erneut; gib ihm eine Minute, bevor du abbrichst.
• "Die Sprache hat nicht umgeschaltet". Nach dem Setzen lesen wir zurück, was das Gerät meldet. Weicht das ab, liefert deine App diese Sprache wahrscheinlich nicht mit, oder die App lief schon in einer anderen Sprache. Starte den Durchgang für diese Sprache neu.
• Zwei Sprachen sehen identisch aus. Das ist die Prüfung bei der Arbeit: Die Screens sind gleich, deine App ist für diese Sprache also nicht übersetzt. Liefere die Sprache erst, wenn deine App es auch ist.
• Die Browser-Anmeldung kommt nicht durch. Nutze npx -y @mokbi/mcp login --paste und füge ein Token ein, das du im Editor erstellt hast.
• Im Editor wartet nichts. Prüfe, ob du dasselbe Projekt offen hast, in das dein Agent gepusht hat, und ob das Token noch gültig ist: npx -y @mokbi/mcp doctor.
• Der Durchgang bleibt auf einem Screen hängen, den deine App nie erreicht. Der Aufnahme-Treiber meldet, auf welchen Screen er geschaut hat, samt Bild. Gib das an deinen Agenten zurück und passe den Flow an; der Server testet deine App nicht für dich.

Was das Token kann und was nicht

• Es legt bereit, es veröffentlicht nicht. Veröffentlichen in den App Store und zu Google Play bleibt in Mokbi, auf deinen Klick.
• Es kann kein Geld ausgeben. Eine Design-Runde wird aus deiner eigenen Editor-Sitzung bezahlt, wenn du den Button drückst — nie vom Agenten.
• Es ist nicht deine Session. Widerrufe es unter Menü → Agent (MCP) → "Agent-Zugriff", dein Konto bleibt unberührt. Bei jedem Token siehst du, wann es zuletzt genutzt wurde.
• Dein Code bleibt bei dir. Die Aufnahme-Hälfte läuft vollständig auf deinem Rechner; nur die fertigen Bilder und Texte gehen an dein Projekt.

Editor öffnen → Was der MCP-Server macht