---
locale: ja
title: ACP と外部 MCP
description: q を ACP エージェントとして実行し、選択したモデルロールへ外部 MCP ツールサーバーを接続します。
sectionLabel: ガイド
toc:
  - id: acpでqを実行
    label: ACP で q を実行
  - id: 計画の自動化を制御
    label: 計画の自動化を制御
  - id: 対話とコンテキスト
    label: 対話とコンテキスト
  - id: 外部mcpサーバーを接続
    label: 外部 MCP サーバーを接続
  - id: トランスポート境界
    label: トランスポート境界
---

## ACPでqを実行

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

```powershell
q acp --root C:\work\project
```

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

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

## 計画の自動化を制御

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

```powershell
q acp --root C:\work\project --auto-resolve --auto-approve
q acp --root C:\work\project --autonomous
```

`--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 サンドボックスにはできません。