Canlı bir TUI'yi MCP üzerinden paylaşmak

Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Durum: Deneysel Kapsam: genel, güncel durum Son inceleme: 2026-10-04 Sahip: AX Code bakımcıları

TUIMCP, macOS ve Linux üzerinde AX Code TUI için deneysel, isteğe bağlı bir MCP bağdaştırıcısıdır. Dış bir ajanın sınırlı arabirim durumunu okumasına ve kullandığınız aynı TUI içinde gezinmesine izin verir. Bu sürümde Windows desteklenmez.

Açık paylaşımla bir TUI başlatın:

ax-code --tui-mcp
# Or attach to an existing local backend:
ax-code attach http://localhost:4096 --tui-mcp

TUIMCP çubuğu mutlak özel endpoint.json yolunu gösterir. MCP istemcinizi şunu başlatacak şekilde yapılandırın:

{
  "mcpServers": {
    "ax-code-tui": {
      "command": "ax-code",
      "args": ["mcp", "tui", "--endpoint", "/absolute/path/from/the/TUI/endpoint.json"]
    }
  }
}

Çalışan TUI’nizin gösterdiği yolu kullanın. Her TUI’nin kendi uç noktası vardır; otomatik keşif veya hedef seçimi yoktur. İstemci aynı işletim sistemi kullanıcısı olarak çalışmalıdır. Uç nokta dosyasını bir yetenek olarak ele alın: gizli bir belirteç içerir. İçeriğini işlemeyin, istemlere kopyalamayın veya paylaşmayın. Arka uç kimlik bilgileri bağdaştırıcıya asla geçirilmez.

Araçlar

get_view_context: örnek/kuşak, revizyon, rota, isteğe bağlı oturum kimliği, hazır olma ve gezinmenin engellenip engellenmediğini döndürür. Döküm, taslak, oturum başlığı, çalışma alanı yolu veya kimlik bilgisi döndürmez.
select_session: taze bir bağlamdan kimlik ve revizyon, bir proje oturum kimliği ve benzersiz bir UUID requestId gerektirir. Oturumu TUI’nin mevcut kimliği doğrulanmış arka uç bağlantısı üzerinden doğrular. Başarılı bir yanıt uygulama rota durumunu kabul eder; görüntüleme ve oturum yükleme hâlâ sürmekte olabilir. Oturum kimlikleri olağan AX Code oturum arabirimleri üzerinden ayrı elde edilebilir.

Bir taslak veya ek varken, bir kalıp veya onay beklerken, oturumlar meşgulken, arka uç bağlantısı kopukken, başlangıç/çıkış kaplamaları etkinken veya kullanıcı son 1.5 saniye içinde etkileşime girdiyse gezinme reddedilir. Değişen arabirim veya çalışma alanı durumu eski revizyonları geçersiz kılar. Bu araçlar istem gönderemez, kabuk komutu yürütemez, izin onaylayamaz veya ajan işi başlatamaz.

Yinelenen özdeş bir requestId, özgün bağlamı dahil özgün makbuzunu döndürür. Farklı argümanlarla yeniden kullanmak bir hatadır. 128 gezinme isteğinden sonra o TUI süreci için yeni istekler reddedilir; okuma erişimi ve mevcut makbuzlar kullanılabilir kalır. Bu sınırı sıfırlamak için açık paylaşımla yeniden başlatın. Makbuzlar güvenli olmayan yeniden oynatmaya tahliye edilmez.

deadline_exceeded, doğrulamanın gezinmeden önce iptal edildiği anlamına gelir. timeout_unknown veya outcome_unknown, çağıranın kesin bir sonuç almadığı anlamına gelir; işlem uygulanmış olabilir. Uzlaştırmak için güncel bağlamı okuyun. Bağdaştırıcı asla otomatik yeniden denemez. Tek başına bir bağlantı veya aktarım başarısı gezinmenin başarılı olduğu anlamına gelmez; isError ve yapılandırılmış sonucu inceleyin.

İptal ve yaşam döngüsü

TUIMCP çubuğunda [İptal] düğmesine tıklayın veya /tui-mcp-revoke çalıştırın. İptal bekleyen gezinmeyi hemen çitler ve soketi kapatır. Çıkış da uç noktayı kapatır; yeniden başlatma yeni bir kimlik ve belirteç oluşturur. Çöken bir süreç atıl özel bir geçici dizin bırakabilir; eski istemciler onun üzerinden yeni bir TUI’ye bağlanamaz.

Paylaşım varsayılan kapalıdır ve kalıcı değildir. Yerel sahip/kip denetimleri diğer işletim sistemi kullanıcılarına karşı korur; TUIMCP, sizin kullanıcınız olarak hâlihazırda çalışan koda karşı bir sandbox değildir. Başlangıç soket yolunun çok uzun olduğunu bildirirse TMPDIR üzerinden daha kısa bir özel geçici kök kullanın ve yeni bir TUI başlatın.