ACP と外部 MCP

ACPでqを実行

q を stdin/stdout 上の Agent Client Protocol サーバーとして起動します。

ACP モードはターミナル UI と同じ永続ワークスペースセッション、ルート制限ツール、サブエージェント、学習、コミットワークフローを使います。接続クライアントへ /commit、/subagents、/subagent、/learn、/clear、/help などを通知します。委任された子の進行状況とツール呼び出しも送ります。

--root は既定で現在のディレクトリです。ファイル、セッション、指示、スキル、ワークスペース設定の境界を定めます。

対話とコンテキスト

クライアントがフォームによる入力要求に対応すれば、q はコミットの選択にそれを使います。それ以外は番号付きの承認アクションを提示します。エージェントの質問には、次のクライアントメッセージを自由形式の回答として利用できます。

q は ACP 埋め込みコンテキスト対応を通知し、セッション再生時にリソース URI、MIME タイプ、注釈、内容を保持します。q の TUI が別の ACP エージェントに接続している場合、@relative/path や @"path with spaces" でワークスペース内ファイルを添付できます。相手が埋め込みコンテキストに対応すれば内容を埋め込み、そうでなければリソースリンクを送ります。

外部MCPサーバーを接続

/mcp または q mcp で外部 MCP サーバーを設定します。q はローカル stdio プロセスと Streamable HTTP エンドポイントに対応します。必要なロールにだけ割り当てられ、すべてのモデルリクエストへ公開する必要はありません。

取り込んだツール名には名前空間が付き、q の組み込みツールや他サーバーとの衝突を防ぎます。結果は組み込みと同じ Loom キャプチャ境界を通り、大きすぎるペイロードは上限付きアーティファクト参照になります。

認証情報は子環境変数や HTTP ヘッダーを元の環境変数名に対応させます。秘密値を ~/.q/mcp.json に直接書く必要はありません。

トランスポート境界

ACP クライアントから渡された MCP サーバーはその ACP セッションだけに適用され、q のグローバル設定にはなりません。stdio と Streamable HTTP は対応し、SSE トランスポートには対応しません。

MCP ツールは自身のプロセスまたはリモートサービスの権限で動きます。q は結果と閲覧できるモデルロールを制限できますが、任意の外部サーバーを OS サンドボックスにはできません。