Mokbi MCP sunucusunu kurma.

Gerekenler

• Node 20 veya üzeri, agent'ının çalıştığı makinede. node --version ile kontrol et.
• MCP konuşan bir agent. Claude Code, Cursor, Codex ve Windsurf çalışır; Model Context Protocol konuşan her şey olur.
• Android Studio'nun SDK Platform-Tools'u ve bir emülatör, Android 13 veya üzeri (API 33+). Altında uygulama başına dil diye bir şey yok ve cihazın her dil için yeniden başlaması gerekirdi. Araçlar PATH'inde değilse ANDROID_HOME'u ayarla.
• Doldurmak istediğin projeyi içeren bir Mokbi hesabı. Her şey bir projeye hazırlanır, o yüzden yoksa önce projeyi oluştur.
• iOS çekimi henüz dahil değil. macOS gerektiriyor ve ayrı gelecek; bugün çekim tarafı Android.

1. Makineni kontrol et

npx -y @mokbi/mcp doctor komutunu çalıştır. Node sürümünü, adb ile emülatörü nerede aradığını ve giriş yapıp yapmadığını yazar. ✗ işaretli olan her şeyi önce hallet — çekim araçları eksik bir SDK'nın etrafından dolaşamaz.

2. Sunucuyu agent'ına ekle

Claude Code'da tek komut yeter:

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

Cursor, Codex, Windsurf ve diğer host'larda MCP yapılandırmana npx komutu ve ["-y","@mokbi/mcp"] argümanlarıyla bir sunucu ekle. Sonra host'u yeniden başlat ki sunucuyu görsün.

3. Bir kez giriş yap

npx -y @mokbi/mcp login komutunu çalıştır. Tarayıcın Mokbi'yi açar, sen isteği onaylarsın ve token 127.0.0.1 üzerine geri gelir — hiçbir zaman bir URL'de yolculuk etmez. Onay ekranı bir port numarası söyler; onaylamadan önce terminalin yazdığıyla aynı olduğunu kontrol et.

O makinede tarayıcı yok mu? npx -y @mokbi/mcp login --paste çalıştır ve token'ı kendin oluştur: Mokbi → menü → Agent (MCP) → "Agent erişimi" → "Yeni token". Token'ı bir kez görürsün, hemen kopyala.

Token ~/.mokbi/config.json içinde 0600 izinleriyle saklanır. Oturumun değildir: iptal etmek hesabına dokunmaz. CI için MOKBI_TOKEN ortam değişkeni dosyadan önce gelir.

4. İlk turun

Agent'ından ekran görüntüsü akışını iste. Sunucu üç slash komutu getirir ve Claude Code'da tam olarak öyle görünürler:

• /mokbi:screenshots — depoyu okumak, hangi ekranların yakalanacağını önermek, kontrol edesin diye tek dil çalıştırmak ve onayından sonra bütün dilleri çalıştırıp seti hazırlamak.
• /mokbi:localize — mağaza metinlerini her mağazanın karakter sınırları içinde yazmak.
• /mokbi:check — neyin hazır olduğunu, her dil için her mağazada neyin eksik kaldığını bildirmek.

İstediğini düz anlatman da yeterli; sunucu akışın nasıl olması gerektiğini agent'ına kendisi söyler. İlk tur tek dili kapsasın. Yanlış bir dokunuş o zaman yirmi tur yerine bir tura mal olur.

5. Agent'ının hazırladıklarını uygula

Projeni editörde aç. Teslimat "Agent'ından" altında bekliyor — araç çubuğundaki robot düğmesi, menü → Agent (MCP) → "Agent erişimi" ile aynı panel ve Ekran görüntüleri menüsündeki "Agent'ından" düğmesi. O düğmedeki rozet, bekleyen sayısını gösterir.

• "Uygula", ekran görüntülerini düğmenin üstünde gösterilen plana göre yerleştirir: hangi görüntü hangi panele, hangi dil için. Tek bir Ctrl+Z bütün seti geri alır.
• "Uygula ve tasarla", agent'ın uygulaman hakkında kısa bir brief gönderdiğinde çıkar. Editördeki turuncu düğmeyle aynı AI Designer turunu, aynı 2 kredi fiyatıyla, hazırlanan görsellerle çalıştırır.
• "Hepsini kabul et", mağaza metinleri veya alt metin çevirileri toplu olarak beklerken görünür. Hepsini tek adımda uygular, tek bir geri alma hepsini kaldırır.
• "At", istemediğin bir teslimatı siler. Agent'ın her zaman yeniden gönderebilir.

Hiçbir şey otomatik uygulanmaz ve bu bilinçli. Projenin tek yazarı editördür: açık bir sekme belgenin tamamını geri yazar. Bir teslimat doğrudan tasarımına düşseydi, başka yerde açık kalmış bir editör sekmesi onu sessizce ezebilirdi.

Bir şeyler ters giderse

• "adb not found". SDK Platform-Tools kurulu değil ya da PATH'inde değil. Android Studio'nun SDK Manager'ından kur ya da ANDROID_HOME'u SDK klasörüne ayarla.
• Emülatör başlar başlamaz 'offline' görünüyor. Yeni açılan bir emülatör, hazır olduğunu bildirdikten sonra bir süre daha açılmaya devam eder. Sunucu üç açılış sinyali bekler ve yeniden dener; kesmeden önce ona bir dakika ver.
• "Dil değişmedi". Ayarladıktan sonra cihazın bildirdiğini geri okuyoruz. Uyuşmuyorsa uygulaman büyük olasılıkla o dili içermiyordur ya da uygulama zaten başka bir dilde açıktı. O dil için turu yeniden başlat.
• İki dil birbirinin aynısı görünüyor. Bu, kontrolün işini yapmasıdır: ekranlar aynı, yani uygulaman o dile çevrilmemiş. Dili, uygulaman hazır olduğunda yayınla.
• Tarayıcı girişi tamamlanmıyor. npx -y @mokbi/mcp login --paste kullan ve editörde oluşturduğun bir token'ı yapıştır.
• Editörde bekleyen bir şey yok. Agent'ının gönderdiği projeyle aynı projeyi açtığından ve token'ın hâlâ geçerli olduğundan emin ol: npx -y @mokbi/mcp doctor.
• Tur, uygulamanın hiç ulaşmadığı bir ekranda takılıyor. Çekim sürücüsü baktığı ekranı görselle birlikte bildirir. Bunu agent'ına geri ver ve akışı düzelt; sunucu senin yerine uygulamanı test etmez.

Token neyi yapar, neyi yapmaz

• Hazırlar, yayınlamaz. App Store ve Google Play'e yayın Mokbi'de, senin tıklamanla kalır.
• Para harcayamaz. Bir tasarım turu, düğmeye bastığın anda kendi editör oturumundan ödenir; asla agent tarafından değil.
• Oturumun değildir. Menü → Agent (MCP) → "Agent erişimi" içinden iptal et, hesabına dokunulmaz. Her token'da en son ne zaman kullanıldığı yazar.
• Kodun sende kalır. Çekim yarısı tamamen kendi makinende çalışır; projene yalnızca bitmiş görseller ve metinler gider.

Editörü aç → MCP sunucusu ne yapar