ACP と外部 MCP

ACPでqを実行

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

ACP モードはターミナル UI と同じ永続ワークスペースセッション、ルート制限ツール、計画ワークフロー、サブエージェント、学習、コミットワークフローを使います。接続クライアントへ /plan、/commit、/subagents、/subagent、/learn、/clear、/help などを通知します。

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

計画の自動化を制御

プロセス限定のフラグで永続設定を変更せず、計画の明確化と提案承認を自動化できます。

--autonomous は両方を有効化します。--auto-approve=false など明示的な個別フラグが優先されます。これらは /plan に適用され、提案検証、タスク実行、レビュー、コミット確認は省略しません。

スラッシュ形式の /auto-resolve、/auto-approve、/autonomous は on、off、status に対応します。プロセスフラグと違い、on と off は ~/.q/config.yaml に保存されます。

対話とコンテキスト

クライアントがフォームによる入力要求に対応すれば、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 サンドボックスにはできません。