Menyiapkan server MCP Mokbi.

Yang kamu butuhkan

• Node 20 atau lebih baru di mesin tempat agenmu berjalan. Periksa dengan node --version.
• Agen yang bisa MCP. Claude Code, Cursor, Codex, dan Windsurf semuanya bisa; apa pun yang berbicara Model Context Protocol cocok.
• SDK Platform-Tools dari Android Studio dan sebuah emulator dengan Android 13 atau lebih baru (API 33+). Di bawah itu bahasa per aplikasi tidak ada dan perangkat harus restart untuk tiap bahasa. Setel ANDROID_HOME kalau alatnya tidak ada di PATH.
• Akun Mokbi dengan proyek yang mau kamu isi. Semua disiapkan ke dalam sebuah proyek, jadi buat dulu kalau belum ada.
• Penangkapan iOS belum termasuk. Itu butuh macOS dan datang terpisah; hari ini sisi penangkapan adalah Android.

1. Periksa mesinmu

Jalankan npx -y @mokbi/mcp doctor. Ia mencetak versi Node-mu, di mana ia mencari adb dan emulator, serta apakah kamu sudah masuk. Apa pun yang bertanda ✗ diperbaiki lebih dulu — alat penangkap tidak bisa mengakali SDK yang hilang.

2. Tambahkan server ke agenmu

Di Claude Code, satu perintah sudah cukup:

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

Di Cursor, Codex, Windsurf, dan host lain, tambahkan server ke konfigurasi MCP-mu dengan perintah npx dan argumen ["-y","@mokbi/mcp"]. Setelah itu mulai ulang host supaya server terbaca.

3. Masuk sekali saja

Jalankan npx -y @mokbi/mcp login. Browser membuka Mokbi, kamu menyetujui permintaannya, dan token kembali ke 127.0.0.1 — token tidak pernah berjalan lewat URL. Layar persetujuan menyebut nomor port; sebelum menyetujui, pastikan angkanya sama dengan yang dicetak terminal.

Tidak ada browser di mesin itu? Jalankan npx -y @mokbi/mcp login --paste dan buat token sendiri di Mokbi → menu → Agen (MCP) → "Akses agen" → "Token baru". Token hanya terlihat sekali, jadi salin langsung.

Token disimpan di ~/.mokbi/config.json dengan izin berkas 0600. Itu bukan sesimu: mencabutnya tidak menyentuh akunmu. Untuk CI, variabel lingkungan MOKBI_TOKEN lebih diutamakan daripada berkas.

4. Ronde pertamamu

Minta alur tangkapan layar ke agenmu. Server membawa tiga perintah slash, dan di Claude Code muncul persis begitu:

• /mokbi:screenshots — membaca repositori, mengusulkan layar mana yang ditangkap, menjalankan satu bahasa untuk kamu periksa, lalu setelah kamu setuju menjalankan semua bahasa dan menyiapkan set-nya.
• /mokbi:localize — menulis teks store dalam batas karakter tiap store.
• /mokbi:check — melaporkan apa yang sudah siap dan apa yang masih kurang per bahasa per store.

Kamu juga bisa sekadar menjelaskan yang kamu mau; server sendiri yang memberitahu agenmu bagaimana alurnya seharusnya berjalan. Biarkan ronde pertama mengurus satu bahasa saja. Salah ketuk lalu hanya menghabiskan satu ronde, bukan dua puluh.

5. Terapkan apa yang disiapkan agenmu

Buka proyekmu di editor. Kirimannya menunggu di "Dari agenmu" — tombol robot di bilah, panel yang sama dengan menu → Agen (MCP) → "Akses agen", dan tombol "Dari agenmu" di menu Tangkapan layar. Tanda pada tombol itu menghitung apa yang sedang menunggu.

• "Terapkan" menempatkan tangkapan layar sesuai rencana yang tampil di atas tombol: tangkapan mana ke panel mana, untuk bahasa apa. Satu Ctrl+Z menarik seluruh set keluar lagi.
• "Terapkan & desain" muncul ketika agenmu mengirim brief singkat tentang aplikasimu. Ini menjalankan ronde AI Designer yang sama seperti tombol oranye di editor, dengan harga yang sama 2 kredit, memakai tangkapan yang sudah disiapkan.
• "Terima semua" muncul ketika teks store atau terjemahan keterangan disiapkan sekaligus. Ini menerapkannya dalam satu langkah, dan satu kali undo menghapus semuanya.
• "Buang" menghapus kiriman yang tidak kamu inginkan. Agenmu selalu bisa mengirim lagi.

Tidak ada yang diterapkan otomatis, dan itu disengaja. Editor adalah satu-satunya penulis proyekmu: tab yang terbuka menyimpan kembali seluruh dokumen. Kalau sebuah kiriman langsung jatuh ke desainmu, tab editor yang terbuka di tempat lain bisa menimpanya diam-diam.

Kalau ada yang bermasalah

• "adb not found". SDK Platform-Tools belum terpasang atau tidak ada di PATH. Pasang lewat SDK Manager di Android Studio, atau setel ANDROID_HOME ke folder SDK-mu.
• Emulator 'offline' tepat setelah dinyalakan. Emulator baru masih terus booting setelah melapor siap. Server menunggu tiga sinyal boot dan mencoba lagi; beri waktu semenit sebelum kamu hentikan.
• "Bahasa tidak berganti". Setelah disetel kami membaca ulang apa yang dilaporkan perangkat. Kalau tidak cocok, kemungkinan besar aplikasimu tidak menyertakan bahasa itu, atau aplikasi sudah berjalan dalam bahasa lain. Ulangi ronde untuk bahasa itu.
• Dua bahasa tampak identik. Itu pemeriksaan yang sedang bekerja: layarnya sama, jadi aplikasimu belum diterjemahkan untuk bahasa itu. Rilis bahasa itu kalau aplikasimu memang sudah siap.
• Login lewat browser tidak selesai. Pakai npx -y @mokbi/mcp login --paste dan tempel token yang kamu buat di editor.
• Tidak ada yang menunggu di editor. Pastikan kamu membuka proyek yang sama dengan tujuan agenmu, dan tokennya masih berlaku: npx -y @mokbi/mcp doctor.
• Ronde berhenti di layar yang tidak pernah dicapai aplikasimu. Driver penangkap melaporkan layar yang sedang dilihatnya, lengkap dengan gambar. Serahkan itu kembali ke agenmu dan sesuaikan alurnya; server tidak menguji aplikasimu untukmu.

Yang bisa dan tidak bisa dilakukan token

• Ia menyiapkan, bukan mempublikasikan. Publikasi ke App Store dan Google Play tetap di Mokbi, atas klikmu.
• Ia tidak bisa mengeluarkan uang. Ronde desain dibayar dari sesi editormu sendiri saat kamu menekan tombolnya, tidak pernah oleh agen.
• Ia bukan sesimu. Cabut lewat menu → Agen (MCP) → "Akses agen" dan akunmu tetap utuh. Tiap token menunjukkan kapan terakhir dipakai.
• Kodemu tetap padamu. Bagian penangkapan berjalan sepenuhnya di mesinmu; hanya gambar dan teks jadi yang dikirim ke proyekmu.

Buka editor → Apa yang dilakukan server MCP