Configurare il server MCP di Mokbi.

Cosa ti serve

• Node 20 o superiore sulla macchina dove gira il tuo agente. Verifica con node --version.
• Un agente che parla MCP. Claude Code, Cursor, Codex e Windsurf funzionano tutti; va bene qualsiasi cosa parli il Model Context Protocol.
• Gli SDK Platform-Tools di Android Studio e un emulatore con Android 13 o superiore (API 33+). Sotto quella versione la lingua per singola app non esiste e il dispositivo dovrebbe riavviarsi a ogni lingua. Imposta ANDROID_HOME se gli strumenti non sono nel tuo PATH.
• Un account Mokbi con il progetto da riempire. Tutto viene preparato dentro un progetto, quindi crealo prima se non esiste ancora.
• La cattura su iOS non è ancora inclusa. Richiede macOS e arriverà a parte; oggi il lato cattura è Android.

1. Controlla la tua macchina

Esegui npx -y @mokbi/mcp doctor. Mostra la tua versione di Node, dove cerca adb e l'emulatore, e se hai effettuato l'accesso. Tutto ciò che riporta ✗ va sistemato per primo: gli strumenti di cattura non possono aggirare un SDK mancante.

2. Aggiungi il server al tuo agente

In Claude Code basta un comando:

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

In Cursor, Codex, Windsurf e altri host, aggiungi alla tua configurazione MCP un server con comando npx e argomenti ["-y","@mokbi/mcp"]. Riavvia poi l'host perché lo rilevi.

3. Accedi una volta

Esegui npx -y @mokbi/mcp login. Il browser apre Mokbi, tu approvi la richiesta e il token torna su 127.0.0.1: non passa mai da una URL. La schermata di approvazione indica un numero di porta; prima di approvare controlla che corrisponda a quello stampato dal terminale.

Niente browser su quella macchina? Esegui npx -y @mokbi/mcp login --paste e crea il token tu stesso in Mokbi → menu → Agente (MCP) → "Accesso agente" → "Nuovo token". Il token si vede una volta sola, quindi copialo subito.

Il token è salvato in ~/.mokbi/config.json con permessi 0600. Non è la tua sessione: revocarlo non tocca il tuo account. Per la CI, la variabile d'ambiente MOKBI_TOKEN ha la precedenza sul file.

4. Il tuo primo giro

Chiedi al tuo agente il flusso degli screenshot. Il server porta con sé tre comandi slash, e in Claude Code compaiono proprio così:

• /mokbi:screenshots — leggere il repository, proporre quali schermate catturare, fare una lingua perché tu la controlli e, dopo il tuo ok, eseguire tutte le lingue e preparare il gruppo.
• /mokbi:localize — scrivere i testi della scheda entro i limiti di caratteri di ogni store.
• /mokbi:check — segnalare cosa è pronto e cosa manca ancora per lingua e per store.

Puoi anche limitarti a descrivere quello che vuoi: il server spiega da sé al tuo agente come deve andare il flusso. Fai coprire una sola lingua al primo giro. Un tap sbagliato costa così un giro invece di venti.

5. Applica ciò che il tuo agente ha preparato

Apri il progetto nell'editor. La consegna aspetta sotto "Dal tuo agente": il pulsante robot nella barra, lo stesso pannello di menu → Agente (MCP) → "Accesso agente", e il pulsante "Dal tuo agente" nel menu Screenshot. Il pallino su quel pulsante conta ciò che è in attesa.

• "Applica" posiziona gli screenshot secondo il piano mostrato sopra il pulsante: quale screenshot in quale pannello, per quale lingua. Un Ctrl+Z rimuove tutto il gruppo.
• "Applica e progetta" compare quando il tuo agente ha inviato un breve brief sulla tua app. Avvia lo stesso giro dell'AI Designer del pulsante arancione dell'editor, allo stesso prezzo di 2 crediti, usando gli screenshot preparati.
• "Accetta tutto" compare quando ci sono testi dello store o traduzioni di didascalie in blocco. Li applica in un passaggio, e un annulla li toglie tutti.
• "Scarta" elimina una consegna che non vuoi. Il tuo agente può sempre rifarla.

Niente viene applicato in automatico, ed è voluto. L'editor è l'unico che scrive il tuo progetto: una scheda aperta risalva l'intero documento. Se una consegna finisse subito nel tuo design, una scheda dell'editor rimasta aperta altrove potrebbe sovrascriverla in silenzio.

Quando qualcosa non va

• "adb not found". Gli SDK Platform-Tools non sono installati o non sono nel tuo PATH. Installali dal SDK Manager di Android Studio, oppure imposta ANDROID_HOME sulla cartella del tuo SDK.
• L'emulatore risulta 'offline' subito dopo l'avvio. Un emulatore appena avviato continua a caricare anche dopo essersi dichiarato pronto. Il server aspetta tre segnali di avvio e riprova; dagli un minuto prima di interrompere.
• "La lingua non è cambiata". Dopo averla impostata rileggiamo ciò che dichiara il dispositivo. Se non coincide, probabilmente la tua app non include quella lingua, oppure era già aperta in un'altra. Rifai il giro per quella lingua.
• Due lingue sembrano identiche. È il controllo che fa il suo lavoro: le schermate sono uguali, quindi la tua app non è tradotta in quella lingua. Pubblica la lingua quando lo è anche la tua app.
• L'accesso dal browser non va a buon fine. Usa npx -y @mokbi/mcp login --paste e incolla un token creato nell'editor.
• Nell'editor non c'è niente in attesa. Verifica di avere aperto lo stesso progetto verso cui ha inviato il tuo agente e che il token sia ancora valido: npx -y @mokbi/mcp doctor.
• Il giro si blocca su una schermata che la tua app non raggiunge mai. Il driver di cattura segnala quale schermata stava guardando, con tanto di immagine. Restituiscila al tuo agente e correggi il flusso; il server non testa la tua app al posto tuo.

Cosa può e cosa non può fare il token

• Prepara, non pubblica. Pubblicare su App Store e Google Play resta in Mokbi, con il tuo clic.
• Non può spendere denaro. Un giro di design viene pagato dalla tua sessione dell'editor quando premi il pulsante, mai dall'agente.
• Non è la tua sessione. Revocalo da menu → Agente (MCP) → "Accesso agente" e il tuo account resta intatto. Ogni token mostra quando è stato usato l'ultima volta.
• Il tuo codice resta con te. La metà di cattura gira interamente sulla tua macchina; al progetto arrivano solo le immagini e i testi finiti.

Apri l'editor → Cosa fa il server MCP