De Mokbi MCP-server instellen.

Wat je nodig hebt

• Node 20 of nieuwer op de machine waar je agent draait. Controleer met node --version.
• Een agent die MCP spreekt. Claude Code, Cursor, Codex en Windsurf werken allemaal; alles wat het Model Context Protocol spreekt werkt.
• De SDK Platform-Tools van Android Studio en een emulator met Android 13 of nieuwer (API 33+). Daaronder bestaat per-app-taal niet en zou het toestel voor elke taal moeten herstarten. Zet ANDROID_HOME als de tools niet in je PATH staan.
• Een Mokbi-account met het project dat je wilt vullen. Klaarzetten gebeurt in een project, dus maak het eerst aan als het nog niet bestaat.
• iOS-opname zit er nog niet in. Dat vraagt macOS en komt apart; vandaag is de opnamekant Android.

1. Controleer je machine

Draai npx -y @mokbi/mcp doctor. Die toont je Node-versie, waar hij adb en de emulator zoekt, en of je bent ingelogd. Alles met een ✗ los je eerst op — de opname-tools kunnen niet om een ontbrekende SDK heen.

2. Voeg de server toe aan je agent

In Claude Code is één commando genoeg:

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

In Cursor, Codex, Windsurf en andere hosts voeg je in je MCP-configuratie een server toe met commando npx en argumenten ["-y","@mokbi/mcp"]. Herstart daarna de host zodat hij de server oppikt.

3. Log één keer in

Draai npx -y @mokbi/mcp login. Je browser opent Mokbi, jij keurt het verzoek goed en het token komt terug op 127.0.0.1 — het staat nooit in een URL. Het goedkeuringsscherm noemt een poortnummer; controleer dat het overeenkomt met wat de terminal toonde voordat je goedkeurt.

Geen browser op die machine? Draai npx -y @mokbi/mcp login --paste en maak het token zelf in Mokbi → menu → Agent (MCP) → "Agent-toegang" → "Nieuw token". Je ziet het token één keer, dus kopieer het meteen.

Het token staat in ~/.mokbi/config.json met rechten 0600. Het is niet je sessie: intrekken raakt je account niet. Voor CI wint de omgevingsvariabele MOKBI_TOKEN van het bestand.

4. Je eerste ronde

Vraag je agent om de screenshot-flow. De server levert drie slash-commands mee, en in Claude Code verschijnen die ook precies zo:

• /mokbi:screenshots — de repo lezen, voorstellen welke schermen erin moeten, één taal draaien zodat jij het kunt controleren, en na jouw akkoord alle talen draaien en de set klaarzetten.
• /mokbi:localize — je store-teksten schrijven binnen de tekenlimieten van elke store.
• /mokbi:check — melden wat er klaarstaat en wat er per taal per store nog ontbreekt.

Gewoon beschrijven wat je wilt kan ook; de server vertelt je agent zelf hoe de flow hoort te gaan. Laat de eerste ronde één taal doen. Een verkeerde tik kost dan één ronde in plaats van twintig.

5. Pas toe wat je agent heeft klaargezet

Open je project in de editor. De levering staat onder "Van je agent" — de robotknop in de bovenbalk, hetzelfde paneel als menu → Agent (MCP) → "Agent-toegang", en de knop "Van je agent" in het Screenshots-menu. Het bolletje op die knop telt wat er klaarstaat.

• "Toepassen" plaatst de screenshots volgens het plan dat boven de knop staat: welk screenshot in welk paneel, voor welke taal. Eén Ctrl+Z haalt de hele set er weer uit.
• "Toepassen & ontwerpen" verschijnt als je agent een korte briefing over je app heeft meegestuurd. Dat draait dezelfde AI Designer-ronde als de oranje knop in de editor, voor dezelfde prijs van 2 credits, met de klaargezette screenshots.
• "Alles accepteren" verschijnt als er store-teksten of vertaalde bijschriften in bulk klaarstaan. Dat past ze in één stap toe, en één keer ongedaan maken haalt ze allemaal weg.
• "Weggooien" verwijdert een levering die je niet wilt. Je agent kan altijd opnieuw pushen.

Er wordt niets automatisch toegepast, en dat is met opzet. De editor is de enige schrijver van je project: een openstaande tab schrijft het hele document terug. Viel een levering meteen in je ontwerp, dan kon een editortab die ergens anders openstaat het stilletjes overschrijven.

Als er iets misgaat

• "adb not found". De SDK Platform-Tools zijn niet geïnstalleerd of staan niet in je PATH. Installeer ze via de SDK Manager van Android Studio, of zet ANDROID_HOME op je SDK-map.
• De emulator is 'offline' vlak na het starten. Een verse emulator boot nog even door nadat hij zegt klaar te zijn. De server wacht op drie bootsignalen en probeert het opnieuw; geef 'm een minuut voordat je de ronde afbreekt.
• "De taal is niet omgezet". Na het zetten lezen we terug wat het toestel meldt. Klopt dat niet, dan levert je app die taal waarschijnlijk niet mee, of draaide de app al in een andere taal. Start de ronde voor die taal opnieuw.
• Twee talen zien er identiek uit. Dat is de controle die z'n werk doet: de schermen zijn gelijk, dus je app is voor die taal niet vertaald. Lever de taal pas als je app dat ook is.
• De browser-login komt niet rond. Gebruik npx -y @mokbi/mcp login --paste en plak een token dat je in de editor hebt gemaakt.
• Er staat niets klaar in de editor. Controleer of je hetzelfde project open hebt als waar je agent naartoe pushte, en of het token nog geldig is: npx -y @mokbi/mcp doctor.
• De ronde blijft hangen op een scherm dat je app nooit bereikt. De opname-driver meldt naar welk scherm hij keek, mét beeld. Geef dat terug aan je agent en stel de flow bij; de server test je app niet voor je.

Wat het token wel en niet kan

• Het zet klaar, het publiceert niet. Publiceren naar de App Store en Google Play blijft in Mokbi, op jouw klik.
• Het kan geen geld uitgeven. Een ontwerpronde wordt betaald vanuit je eigen editor-sessie op het moment dat jij op de knop drukt, nooit door de agent.
• Het is niet je sessie. Trek het in via menu → Agent (MCP) → "Agent-toegang" en je account blijft ongemoeid. Bij elk token zie je wanneer het voor het laatst is gebruikt.
• Je code blijft bij jou. De opnamehelft draait volledig op je eigen machine; alleen de afgeronde beelden en teksten gaan naar je project.

Open de editor → Wat de MCP-server doet