MCP でライブの TUI を共有する

このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

ステータス: 実験的対象範囲: 公開、現在の状態最終確認: 2026-10-04 所有者: AX Code メンテナー

TUIMCP は、macOS と Linux 上の AX Code TUI 向けの、実験的でオプトインの MCP アダプターです。外部エージェントが、範囲の限られたインターフェース状態を読み、あなたが使っている同じ TUI を移動できるようにします。この版では Windows はサポートされません。

明示的な共有付きで TUI を開始します。

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

TUIMCP バーは、非公開の絶対パス endpoint.json を示します。MCP クライアントが次を起動するよう設定します。

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

実行中の TUI が表示するパスを使ってください。各 TUI は独自のエンドポイントを持ちます。自動発見や対象選択はありません。クライアントは同じ OS ユーザーとして動かなければなりません。エンドポイントファイルはケイパビリティとして扱ってください。秘密のトークンが含まれます。コミットせず、プロンプトへコピーせず、内容を共有しないでください。バックエンドの認証情報がアダプターへ渡されることは決してありません。

ツール

get_view_context: インスタンスと世代、改訂、経路、任意のセッション ID、準備状態、ナビゲーションが遮断されているかを返します。転写、下書き、セッションタイトル、ワークスペースパス、認証情報は返しません。
select_session: 新鮮な文脈からの同一性と改訂、プロジェクトのセッション ID、一意な UUID である requestId を要求します。TUI の既存の認証済みバックエンド接続を通じてセッションを検証します。成功した応答は、アプリケーション経路の状態を確認します。描画とセッションの読み込みは、まだ進行中であることがあります。セッション ID は、通常の AX Code セッションインターフェースを通じて別に取得できます。

下書きまたは添付があるとき、モーダルまたは承認が保留のとき、セッションが忙しいとき、バックエンドが切断されているとき、起動または終了のオーバーレイが有効なとき、または利用者が直近 1.5 秒以内に操作したときは、ナビゲーションは拒否されます。UI またはワークスペースの状態が変わると、古い改訂は無効になります。これらのツールは、プロンプトを送信したり、シェルコマンドを実行したり、権限を承認したり、エージェント作業を開始したりできません。

同一の requestId を繰り返すと、元の文脈を含む元の受領が返ります。異なる引数で再利用するとエラーです。ナビゲーション要求が 128 件を超えると、その TUI プロセスでは新しい要求が拒否されます。読み取りアクセスと既存の受領は引き続き使えます。この上限をリセットするには、明示的な共有付きで再起動します。受領は、安全でない再生へ追い出されません。

deadline_exceeded は、ナビゲーションの前に検証が取り消されたことを意味します。timeout_unknown または outcome_unknown は、呼び出し側が確定的な結果を受け取らなかったことを意味します。操作は適用されたかもしれません。現在の文脈を読んで突き合わせてください。アダプターが自動で再試行することは決してありません。接続またはトランスポートの成功だけでは、ナビゲーションが成功したことにはなりません。isError と構造化された結果を検査してください。

失効とライフサイクル

TUIMCP バーの [失効] をクリックするか、/tui-mcp-revoke を実行します。失効は直ちに、保留中のナビゲーションを囲い、ソケットを閉じます。終了もエンドポイントを閉じます。再起動は新しい同一性とトークンを作ります。クラッシュしたプロセスは、不活性な非公開一時ディレクトリを残すことがあります。古いクライアントは、それを通じて新しい TUI へ接続できません。

共有は既定でオフであり、永続化されません。ローカルの所有者とモードの検査は、他の OS ユーザーから守ります。TUIMCP は、すでにあなたのユーザーとして動いているコードに対するサンドボックスではありません。起動時にソケットパスが長すぎると報告された場合は、TMPDIR を通じてより短い非公開の一時ルートを使い、新しい TUI を開始してください。