Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Bagikan TUI langsung melalui MCP

Status: Eksperimental Cakupan: publik, keadaan saat ini Terakhir ditinjau: 2026-10-04 Pemilik: pengelola AX Code

TUIMCP adalah adaptor MCP eksperimental yang bersifat ikut serta untuk TUI AX Code di macOS dan Linux. Adaptor ini memungkinkan agen eksternal membaca keadaan antarmuka yang dibatasi dan menavigasi TUI yang sama dengan yang sedang Anda pakai. Windows tidak didukung pada versi ini.

Mulai TUI dengan berbagi yang eksplisit:

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

Bilah TUIMCP menampilkan jalur privat absolut endpoint.json. Konfigurasikan klien MCP Anda agar meluncurkan:

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

Gunakan jalur yang ditampilkan oleh TUI yang sedang berjalan. Setiap TUI memiliki titik akhir sendiri; tidak ada penemuan otomatis atau pemilihan target. Klien harus berjalan sebagai pengguna OS yang sama. Perlakukan berkas titik akhir sebagai kapabilitas: berkas itu berisi token rahasia. Jangan komit, salin ke dalam prompt, atau bagikan isinya. Kredensial backend tidak pernah diteruskan ke adaptor.

Alat

• get_view_context: mengembalikan instans/generasi, revisi, rute, ID sesi opsional, kesiapan, dan apakah navigasi diblokir. Alat ini tidak mengembalikan transkrip, draf, judul sesi, jalur workspace, atau kredensial.
• select_session: memerlukan identitas dan revisi dari konteks yang baru, ID sesi proyek, dan UUID unik requestId. Alat ini memvalidasi sesi melalui koneksi backend terautentikasi yang sudah ada pada TUI. Respons yang berhasil mengakui keadaan rute aplikasi; perenderan dan pemuatan sesi masih dapat berlangsung. ID sesi dapat diperoleh secara terpisah melalui antarmuka sesi AX Code yang biasa.

Navigasi ditolak ketika ada draf atau lampiran, modal atau persetujuan tertunda, sesi sedang sibuk, backend terputus, overlay mulai atau keluar aktif, atau pengguna berinteraksi dalam 1.5 detik terakhir. Perubahan UI atau keadaan workspace membatalkan revisi lama. Alat ini tidak dapat mengirim prompt, menjalankan perintah shell, menyetujui izin, atau memulai kerja agen.

requestId yang diulang secara identik mengembalikan tanda terima aslinya, termasuk konteks aslinya. Memakainya ulang dengan argumen berbeda adalah kesalahan. Setelah 128 permintaan navigasi, permintaan baru ditolak untuk proses TUI itu; akses baca dan tanda terima yang ada tetap tersedia. Mulai ulang dengan berbagi eksplisit untuk mengatur ulang batas ini. Tanda terima tidak digusur ke pemutaran ulang yang tidak aman.

deadline_exceeded berarti validasi dibatalkan sebelum navigasi. timeout_unknown atau outcome_unknown berarti pemanggil tidak menerima hasil yang pasti; operasi mungkin sudah diterapkan. Baca konteks saat ini untuk merekonsiliasi. Adaptor tidak pernah mencoba ulang secara otomatis. Keberhasilan koneksi atau transport sendiri tidak berarti navigasi berhasil; periksa isError dan hasil terstruktur.

Cabut dan siklus hidup

Klik [Cabut] pada bilah TUIMCP atau jalankan /tui-mcp-revoke. Pencabutan segera memagari navigasi yang tertunda dan menutup soket. Keluar juga menutup titik akhir; memulai ulang membuat identitas dan token baru. Proses yang mogok dapat meninggalkan direktori sementara privat yang tidak aktif; klien lama tidak dapat menempel ke TUI baru melalui direktori itu.

Berbagi mati secara bawaan dan tidak disimpan. Pemeriksaan pemilik dan mode lokal melindungi dari pengguna OS lain; TUIMCP bukan sandbox terhadap kode yang sudah berjalan sebagai pengguna Anda. Jika saat mulai dilaporkan bahwa jalur soket terlalu panjang, gunakan akar sementara privat yang lebih pendek melalui TMPDIR dan mulai TUI baru.