Extentos MCP

MCP sunucusu

Extentos MCP sunucusu (@extentos/mcp-server\), bir AI ajanının (Claude Code, Cursor, Windsurf, Cline) bir kez kurduğu ve ardından yerel bir iOS veya Android uygulamasına Meta Ray-Ban akıllı gözlük yetenekleri eklemek için kullandığı bir npm paketidir. Keşif, üretim, ajan yapılandırması, kimlik bilgileri, analitik, rehberlik, doğrulama, simülasyon, üretime hazırlık ve dokümantasyon olmak üzere 10 kategoride dar bir deterministik araç seti sunar — ayrıca hesap bağlama, telemetri onayı ve güncelleme kontrolleri için bir CLI içerir. Bu, ajanın kullanım kılavuzudur.

MCP sunucusu, bir AI ajanının — Claude Code, Cursor, Windsurf, Cline veya Model Context Protocol uyumlu herhangi bir ana bilgisayarın — Extentos'u çalıştırma şeklidir. Ajan deterministik araçları çağırır; sunucu, ajanı gözlüklerin sunduğu yetenekler hakkında bilgilendirir, Kotlin ve Swift'te kanonik SDK kod desenlerini döndürür, projeyi iskeletlendirir, simülatör oturumlarını aracılık eder ve hata ayıklama izlerini sorgular. Sunucunun kendisinin planlama aracı yoktur — ajanlar, regex paketlerinden daha iyi planlayıcılardır. Araçlar, ajanın sırayla birleştirdiği tipli ilkellerdir.

Bu sayfa bölüm girişidir — sunucunun ne olduğu, araçlara genel bakış, kanonik ajan odaklı akış, yapılandırma düğmeleri, CLI ve kimlik doğrulama modelinin nasıl çalıştığı. Alt sayfalar her birini derinlemesine ele alır.

Kurulum

claude mcp add extentos -- npx -y @extentos/mcp-server@latest

Claude Code dışındaki ana bilgisayarlar için ajan istemi veya manuel JSON kurulum yollarına bakın. Tam kurulum referansı: /docs/mcp-server/install.

Araçlar, kategoriye göre

Sunucu, 10 kategoride düzenlenmiş deterministik bir araç yüzeyi sunar (mcp-server/src/tools/definitions.ts içinde doğrulanmıştır). Kategoriler ajanın zihinsel haritasıdır; bir aracın hangi kategoride olduğunu anlayan bir ajan, onu ne zaman çağıracağına karar verebilir. Her zaman güncel tam katalog, oluşturulan araçlar referansıdır.

1. Keşif ve SDK referansı (4 araç)

Herhangi bir yeni görevdeki ilk çağrılar. Ucuz, tamamen yerel, yan etkisiz.

Araç	Ne yapar
getPlatformInfo	Statik platform kataloğunu döndürür — kütüphane sürümü, gözlüklerin sunduğu SDK yeteneklerinin listesi, satıcı başına katmanlar. Her zaman doğru ilk çağrı.
getCapabilityGuide	Özellik başına Kotlin + Swift'te minimum kullanım — çağrı şekli, yapılandırma argümanları, tuzaklar. Özellikleri adlandıran getPlatformInfo ile eşleşerek ajana her birini nasıl çağıracağını söyler.
getCodeExample	Her iki dilde tam kanonik kompozisyonlar. assistant_agent_loop (Faz-4 kanonik sesli asistan akışı) ve agent_driven_e2e_full_loop (ajan odaklı E2E testi) ile başlayın. Ayrıca voice_qa_assistant, barge_in_speak, photo_describe_voice, live_transcription_ui, voice_notes, connection_page_setup, byok_anthropic, display_browse_detail, display_media_gallery ve video_frames_ml kapsar. İşleyici kodu yazarken bunlardan yararlanın. Tam numaralandırılmış liste /docs/reference/mcp-tools adresinde oluşturulur.
getMigrationGuide	Zaten ham Meta DAT üzerine kurulmuş uygulamalar için — mevcut DAT sembollerinizi onları değiştiren Extentos ilkellerine eşleyen bir harita ve sıralı bir geçiş planı döndürür.

2. Kurulum ve Üretim

Araç	Ne yapar
generateConnectionModule	Tek seferlik iskelet — bootstrap modülü, Gradle/SPM bağlantısı, bağımlılıklar, izinler, manifest. İki çağrılı akış: placement olmadan ilk çağrı, ExtentosConnectionPage'in nerede yaşaması gerektiğini soran bir soru döndürür; seçilen yerleşimle ikinci çağrı tam dosya setini döndürür.
getConnectionPageConfig / setConnectionPageConfig	Pano/sunucunun tuttuğu proje başına bağlantı sayfası yapılandırmasını (tema belirteçleri + bölüm görünürlüğü) okur / yazar.
regenerateConnectionPageFile / adoptConnectionPageFile	Kaydedilmiş extentos.connection-page.json dosyasını sunucu yapılandırmasıyla senkronize eder — yeniden oluştur (sunucu→dosya) veya benimse (dosya→sunucu).

İskeletleştirmeden sonra ajan, getCapabilityGuide / getCodeExample tarafından yüzeye çıkarılan SDK ilkellerine karşı kendi işleyici sınıflarını yazar. İşleyici kodu müşterinin yazma yüzeyidir — initSpec veya DSL doldurma adımı yoktur.

3. Ajan yapılandırması ve kullanımı (5 araç)

Hesap kapsamlı — bağlı bir hesap gerektirir ve MCP erişim izni (varsayılan Okuma+Yazma) tarafından proje başına kısıtlanır.

Araç	Ne yapar
getAssistantConfig / setAssistantConfig	Bir projenin pano tarafından yönetilen asistan ayarlarını okur veya değiştirir — OpenAI Realtime modeli, ses, bellek (sıkıştırma) modeli ve oturum içi bellek modu. set kısmi bir güncellemedir, her değeri kataloğa karşı doğrular ve model değişikliğinin maliyet etkisini yansıtır.
getGatewayUsage	Bir projenin yönetilen ağ geçidi kullanımını + son bir zaman aralığındaki tam maliyeti okur — fatura defterinden model başına ayrılmış token sayıları ve liste fiyatı USD. Yalnızca meta veri, asla transkript veya içerik değil.

4. Kimlik bilgileri (2 araç)

Hesap kapsamlı + proje başına kısıtlı. Bilmeden yazma — sır asla ajandan geçmez.

Araç	Ne yapar
getCredentialStatus	Bir projenin Meta DAT derleme kimliğinin ayarlı olup olmadığını okur — yalnızca maskeli bir ipucu + güncellenme zamanı, asla değer değil.
setCredential	Bir kimlik bilgisinin bilmeden yazma girişini başlatır — oturum açmış sahibin sırrı doğrudan şifreli kasaya yapıştırdığı bir pano bağlantısı döndürür. Tasarım gereği sır argümanı almaz.

5. Analitik (1 araç)

Araç	Ne yapar
getProjectAnalytics	Bir projenin üretim analitiğini okur — yayınlanan App Store / Play Store kurulumlarından toplu telemetri (olaylar, aktif kurulumlar, olay / gün / satıcı / platform bazında). Yalnızca meta veri, hesap kapsamlı, sahiplik kontrolü yapılmış, Analitik izniyle kısıtlı. Uygulama yayınlanıp üretim onaylı olaylar gönderene kadar boştur (canlı dev/sim akışı için getEventLog kullanın).

6. Uygulama Rehberliği (2 araç)

Ajanın kompozisyon sırasında çağırdığı yan görev araçları.

Araç	Ne yapar
getVoiceCommandGuidance	Önerilen uyandırma / komut ifadelerini bir glasses.audio.transcriptions() tüketicisine bağlamadan önce UX sorunları (çakışmalar, belirsizlik, tanınması zor kelimeler, Meta uyandırma kelimesi çakışmaları) için analiz eder.
getPermissions	Yetenek listesinden tam platform izinlerini, Meta DAT gereksinimlerini ve ön plan hizmeti ihtiyaçlarını türetir. İşleyicinize bir ilkel eklerken veya kaldırırken çalıştırın.

7. Doğrulama (2 araç)

Doğruluk kapıları. Yapısal değişikliklerden sonra çalıştırın (yeni yetenek bildirildi, bağımlılık yükseltildi, manifest düzenlendi).

Araç	Ne yapar
inspectIntegration	Salt okunur proje anlık görüntüsü — manifest, oluşturulan dosya karmaları, bağımlılık listesi, bağlantı sayfası yapılandırması. Manuel düzenlemelerden önce mevcut durumu anlamak için çalıştırın.
validateIntegration	Tüm proje doğruluk kontrolü — manifest, oluşturulan dosyalar, bildirilen bağımlılık, izinler bildirilen yetenekleri kapsar, bootstrap ExtentosGlasses.create(...) çağırır, araç zinciri sürümleri, sürekli yakalama akışları için ön plan hizmeti ipuçları. Test öncesi kapı.

8. Simülasyon

Tarayıcı tabanlı simülatör oturumlarını sağlayın ve çalıştırın, ayrıca insan olmadan uçtan uca döngüyü kapatan ajan odaklı test araçları.

Araç	Ne yapar
createSimulatorSession	extentos.com/s adresinde tarayıcı modu oturumu al veya oluştur. Bu proje için kayıtlı sim varsa onu döndürür (status: "resumed") veya yeni bir tane üretir (status: "active"). Ulaşılabilir olduğunda yerel köprü aracılığıyla çalışan uygulamayı otomatik olarak ekler; aksi takdirde bir BuildConfig.EXTENTOS_SESSION_URL snippet'i (Android) veya extentos.session.plist yükü (iOS) yayar. sessionId'yi döndürmek deleteSimulatorSession ardından üretmektir — zorla taze bayrağı yoktur.
ensureSimulatorBrowser	Bağlı bir simülatör tarayıcı sekmesini açar + onaylar — kamera ve enjeksiyon akışları için ön koşul.
completeAuthLink	createSimulatorSession status: "auth_required" döndürdükten sonra (anonim kurulumun oturum üretmek için bağlanması gerekir), kullanıcı kaydı bitirene kadar arka ucu yoklar, ardından taşıyıcı belirteci ~/.extentos/auth.json konumuna kalıcı hale getirir.
getEventLog	Bir oturumdan yapılandırılmış olay izlerini getirir. Filtre değerleri: all (filtre yok) artı yedi çip errors, voice, camera, display, ai, lifecycle, custom — olay başına bir çip, errors modaliteden bağımsız olarak severity≥warn'ı emer. Ayrıca iz düzeyi kapsamı için cursor, follow, limit. Birincil hata ayıklama aracı.
getSimulatorStatus	Canlı bir oturumun mevcut durumunu okur — faz, donanım hazır, ekli roller, aktif yetenek akışları, mevcut geçiş değerleri.
injectTranscript / injectAssistantUtterance / assertToolCalled	Bir uyandırma ifadesini veya asistan turunu sürer, ardından modelin hangi aracı çağırdığını doğrular — ajan odaklı E2E döngüsü, insan gerekmez.
injectHardwareButton	Simüle edilmiş gözlüklerin donanım yakalama düğmesine basar — dokunma canlı kamera akışını duraklatır/devam ettirir, basılı tutma durdurur — böylece ajan, kullanıcının gizlilik jestlerini (ve sonuçtaki CaptureError.StreamPaused'yi) insan olmadan test edebilir.
setSimVideo / setSimDevice	Simüle edilmiş kameraya bir test videosu iletir; simüle edilmiş cihaz modelini değiştirir (ör. rayban_display ekran yolunu test etmek için).
getDisplayState / injectInput	Şu anda oluşturulan ekran ağacını okur + ekran girişini sürer (select / navigate / back).

9. Üretim (2 araç)

Yayın öncesi kontroller.

Araç	Ne yapar
getProductionChecklist	Bildirilen yeteneklere + işleyici adlarına dayalı kişiselleştirilmiş üretime hazırlık kontrol listesi — kimlik bilgisi bağlantısı, izin denetimi, ön plan hizmeti gereksinimleri (sürekli yakalama kullanıldığında), sürüm derlemelerinden simülatör URL'sinin kaldırılması, mağaza listeleme hazırlığı.
getCredentialGuide	Üretim AI sağlayıcıları için adım adım kimlik bilgisi kurulumu — anthropic, openai, google_cloud_vision, google_translate, google_gemini, deepl, azure_cognitive, aws_bedrock, huggingface veya custom — artı Meta DAT kaydı.

10. Dokümantasyon ve arama (1 araç)

Araç

Ne yapar

searchDocs

Extentos dokümantasyonunu konu veya anahtar kelimeye göre arar. Sesli asistanlar için önce assistant_runtime okuyun. Diğer uyumlu konular: voice_integration, agent_e2e_testing, managed_gateway, conversation_memory, display, artı kararlı kavramsal set — getting_started, custom_handlers (kanonik SDK kompozisyon belgesi), simulator_browser_mode, simulator_session_lifecycle, event_log_schema, toggles, library_api, permissions, multi_platform_projects. Konu kimlikleri kararlıdır; canlı araç girişi yetkilidir.

Giriş şemaları, yanıt şekilleri ve çalışılmış örneklerle tam araç başına referans: /docs/mcp-server/tools.

Kanonik ajan odaklı akış

Yeni bir projede ajan, araçları şu sırayla çağırır:

1. getPlatformInfo({ sections: ["version", "capabilities"], glasses: "meta_rayban" })
2. getCodeExample({ pattern: "assistant_agent_loop" })  // Phase-4 voice assistant; or whatever pattern fits
3. getCapabilityGuide({ feature: "<each primitive the handler will use>" })
4. generateConnectionModule({ platform, glasses, appPackage })
   → returns "needs_placement" question
5. generateConnectionModule({ ... placement: "<chosen>" })
   → writes scaffold files (ExtentosBootstrap, manifest, etc.)
6. <agent writes handler class(es)> against the SDK primitives
   <agent updates extentos.manifest.json's \`capabilities\` array>
7. validateIntegration()
   → ✓ all good (or returns structured errors to fix)
8. createSimulatorSession({ glasses })
   → returns sessionId; auto-opens browser at extentos.com/s/<id>
   → if running app is reachable via local bridge, it auto-attaches
9. <developer interacts with the simulator; capability events flow into the backend>
10. getEventLog({ sessionId, filter: "errors" })  → debug
    getSimulatorStatus({ sessionId })             → status

Yineleme için: işleyici kodunu düzenle → yeniden derle + yeniden kur → uygulama aynı simülatör oturumuna otomatik olarak eklenir (yeniden üretim yok, URL kararlıdır). Yayınlamadan önce: getProductionChecklist ve getCredentialGuide.

Yapılandırma

MCP sunucusu şu ortam değişkenlerini okur (mcp-server/src/ içinde doğrulanmıştır):

Değişken	Varsayılan	Ne yapar
EXTENTOS_BACKEND_URL	Üretim arka ucu	Arka uç URL'sini geçersiz kılar (tools/util/backendClient.ts). Extentos'un kendisinin yerel geliştirmesi için.
EXTENTOS_CONFIG_DIR	~/.extentos	Yapılandırma/kimlik doğrulama dizinini geçersiz kılar (telemetry/consent.ts).
EXTENTOS_TELEMETRY	ayarlanmamış (onay varsayılanı)	CLI onay komutunu çalıştırmadan telemetriyi reddetmek için 0 olarak ayarlayın.
EXTENTOS_NO_AUTO_OPEN	ayarlanmamış	Simülatör oturumu oluşturulurken tarayıcı otomatik açılışını devre dışı bırakmak için 1 olarak ayarlayın (başsız ortamlarda kullanışlıdır).

Tam yapılandırma referansı: /docs/mcp-server/configuration.

CLI alt komutları

npx @extentos/mcp-server@latest komutunu argümansız çalıştırmak, MCP sunucusunu stdio üzerinden başlatır (ajanın kullandığı yol). Bir alt komutla birlikte, geliştirici CLI'ı olarak çalışır:

Alt Komut	Ne Yapar
login	Bu kurulumu, cihaz kodu akışıyla bir Extentos hesabına bağlar (proaktif — ilk simülatör oturumundan önce veya logout sonrası yeniden bağlamak için kullanışlıdır).
logout	~/.extentos/auth.json temizler. Kurulum anonim katmana döner; bir sonraki simülatör oturum çağrısı, cihaz kodu akışını yeniden tetikler.
whoami	Henüz uygulanmadı (Faz-0 taslağı). installId, accountId (bağlıysa), katman ve kimlik doğrulama süresini yazdıracak.
setup	Yerel derleme ortamını ön kontrol eder — Meta DAT yapıtlarının ihtiyaç duyduğu GitHub Packages PAT'ini (read:packages) ve com.extentos:glasses-meta'ya bağımlı uygulamalar için diğer bağımlılık ön koşullarını kontrol eder.
accept-privacy	Gizlilik onayını kaydeder (telemetri yüklemeyi etkinleştirir).
decline-privacy	Gizlilik reddini kaydeder (telemetri yüklemeyi devre dışı bırakır).
status	Onay durumunu, kurulum kimliğini, bağlı hesabı, MCP/kütüphane sürümlerini yazdırır.
update	MCP sunucusu güncellemelerini kontrol eder (npx @latest kurulumlarında işlem yapmaz).

Tam CLI referansı: /docs/mcp-server/auth.

Kimlik doğrulama modeli

MCP sunucusu anonim-önceliklidir. Keşif, yetenek kılavuzları, kod örnekleri, doğrulama, dokümantasyon araması, cihaz üzerinde simülasyon ve gerçek donanım testi — hepsi oturum açmadan çalışır. Üç şey ücretsiz bir hesabı bağlar: tarayıcı simülatörü oturumları oluşturma (createSimulatorSession, HTTP 402), generateConnectionModule iskele adımı (hesabınıza bağlı proje anahtarınızı oluşturur — aynı 402 cihaz kodu akışı; bilgilendirici ilk çağrı anonimdir) ve hesap kapsamlı proje araçları (asistan yapılandırması, kimlik bilgileri, bağlantı sayfası yazımları, analitik — HTTP 401).

Cihaz kodu akışı: ilk kapılı çağrı, doğrulama URL'si ile status: "auth_required" döndürür. Ajan, arka ucu yoklamak için completeAuthLink çağırır; geliştirici, URL'de ücretsiz e-posta tabanlı bir hesapla kaydolur (Google veya e-posta + şifre, ödeme yok); arka uç bir belirteç yayınlar; orijinal araç çağrısı otomatik olarak yeniden dener. Bağlandıktan sonra simülatör oturumları sınırsızdır.

Extentos'un araçları, kod üretimi, doğrulama, SDK ve tarayıcı simülatörü ücretsizdir — derlemek ve yayınlamak için koltuk başına veya abonelik ücreti yoktur. Kullanımı ölçen tek yüzey, Faz-4 sesli asistanının arkasındaki yönetilen AI ağ geçididir. Tam kimlik doğrulama modeli: /docs/mcp-server/auth; fiyatlandırma: /docs/resources/pricing.

Gizlilik ve telemetri

İlk çalıştırmada, MCP sunucusu yanıta tek seferlik bir gizlilik bildirimi ekler. Telemetri anonimdir (installId ile etiketlenir, kaynak kodu veya kişisel veri içermez) ve varsayılan olarak devam ederek kapatılır — Vercel CLI, Astro, Vite ile aynı desen. İstediğiniz zaman reddedin:

npx @extentos/mcp-server@latest decline-privacy
# or
EXTENTOS_TELEMETRY=0 (env var, persistent for the shell)

Gizlilik bildirimi içeriği mcp-server/src/index.ts içindedir (PRIVACY_NOTICE sabiti). Bildirim, kurulum başına claimFirstPrivacyNotice aracılığıyla bir kez gösterilir — asla tekrarlanmaz.

Uyumlu MCP ana bilgisayarları

Aşağıdakilerle çalıştığı doğrulanmıştır:

• Claude Code — birincil hedef. claude mcp add ile tek satırlık kurulum.
• Cursor — ~/.cursor/mcp.json içinde JSON yapılandırması.
• Windsurf — ~/.codeium/windsurf/mcp_config.json içinde JSON yapılandırması.
• Cline — Cline'ın MCP ayarlarında JSON yapılandırması.
• MCP uyumlu herhangi bir ana bilgisayar — standart mcpServers.extentos JSON bloğunu bırakın.

MCP sunucusu, stdio üzerinden standart MCP protokolünü konuşur (@modelcontextprotocol/sdk); sunucu tarafında ana bilgisayara özgü kod yolları yoktur. Ana bilgisayar başına kurulum adımları: /docs/mcp-server/agents.

Yerel köprü — otomatik bağlama geliştirme döngüsü

Sunucu başladığında, bir 127.0.0.1:31337/whoami HTTP dinleyicisi açar (mcp-server/src/localBridge.ts). Geliştiricinin uygulamasındaki Extentos kütüphanesi, çalışma zamanında bu uç noktayı yoklayarak ana MCP'sinin installId öğrenir. Sonuç: ajandan gelen her createSimulatorSession çağrısı, çalışan uygulamayı otomatik olarak yeni oturuma bağlar — yeniden derleme yok, URL yapıştırma yok.

Erişim yolları:

• Android emülatörü: http://10.0.2.2:31337/whoami (ana bilgisayar geri döngü NAT takma adı)
• iOS Simülatörü: http://localhost:31337/whoami (ana bilgisayar ağ ad alanını paylaşır)
• USB üzerinden fiziksel Android telefon: bir kez adb reverse tcp:31337 tcp:31337, ardından cihazdan localhost:31337
• Hücresel telefon veya bulut barındırmalı ajan: yoklama zaman aşımına uğrar. Ajan, URL yapıştırma yolunu kullanır — createSimulatorSession, geliştiricinin yapıştırdığı bir BuildConfig.EXTENTOS_SESSION_URL parçacığı (Android) veya extentos.session.plist yükü (iOS) döndürür, ardından uygulamayı bir kez yeniden derler. Otomatik bağlamadan daha az zarif ama her topolojide çalışır.

Yalnızca 127.0.0.1 bağlıdır. installId bir sır değildir — MCP'nin her araç çağrısında api.extentos.com gönderdiği değerle aynıdır. Bu katmanda kimlik doğrulama gerekmez.

31337 bağlantı noktası kullanımdaysa (nadir; başka bir MCP örneği zaten çalışıyor), başlangıç bir uyarı kaydeder ve devam eder. Otomatik bağlama, bu oturum için sessizce başarısız olur; geliştirici, bağlantı noktası boşalana kadar URL yapıştırma yolunu kullanır.

Durum

• Paket: npm üzerinde @extentos/mcp-server (MIT lisansı)
• Motorlar: Node.js 20+
• 1.0 öncesi — donanım test döngüsü kapanana kadar API'ler küçük sürümler arasında değişebilir. Oturumlar arası tekrarlanabilirlik gerekiyorsa tam bir sürüme sabitleyin.

İlgili

• Bir AI ajanıyla hızlı başlangıç — sunucuyu kurun ve gerçek bir geliştirme döngüsünde yürüyün
• Araç referansı — araç başına tam API
• Yapılandırma — ortam değişkenleri, yapılandırma dosyaları, kurulum zamanı ayarları
• Kimlik doğrulama — cihaz kodu akışı, hesap bağlama, CLI kimlik doğrulama komutları
• Desteklenen ajanlar — ana bilgisayar başına kurulum talimatları
• Mimari — MCP sunucusunun daha geniş Extentos sistemine nasıl uyduğu
• Taşıma ve uygulama simülasyonu — MCP'nin aracılık ettiği simülatörün gerçekte ne yaptığı

[

Alibaba Qianwen AI Gözlükleri

Üçüncü taraf geliştiriciler için Alibaba Qianwen AI Gözlükleri — 千问AI硬件开放平台 Skill platformu, MCP araç entegrasyonu, uygulama modeli, dağıtım, yetenekler ve AI ile 2026 akıllı gözlük manzarasındaki yeri.

](https://extentos.com/docs/ecosystem/platforms/alibaba-qianwen)[

MCP sunucusunu kurun

Extentos MCP sunucusunu (@extentos/mcp-server) MCP uyumlu herhangi bir AI kodlama ajanına nasıl kurarsınız — Claude Code, Cursor, Windsurf, Cline ve diğerleri. Ana bilgisayar başına kurulum komutları, yapılandırma dosyası konumları, kopyala-yapıştır JSON parçacıkları, yeniden başlatma ve doğrulama adımları, sürüm sabitleme, güncelleme, yaygın hataları giderme ve kaldırma talimatları. Desteklenen her ana bilgisayar için doğrulanmış kurulum yolları.

](https://extentos.com/docs/mcp-server/install)