> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent Client Protocol
> ACP を使用して、Devin Desktop の Agent Command Center 内でサードパーティ製エージェントを実行します。
ACP エージェントは、Pro、Max、Teams ユーザーが利用できます。Enterprise 管理者は、サードパーティ製エージェントの有効化について担当のアカウントチームにお問い合わせください。
Devin Desktop は、[Agent Command Center](/ja/desktop/agent-command-center) 内でサードパーティ製エージェントを実行する機能に対応しています。そのために、[Agent Client Protocol (ACP)](https://agentclientprotocol.com/) を利用しています。
ACP は、コードエディターとコーディングエージェント間の通信を標準化するオープンプロトコルです。これは、Language Server Protocol (LSP) が言語サーバーとの統合を標準化したのと同様です。ACP を実装したエージェントであれば、Devin Desktop に接続できます。また、Devin Desktop は ACP 対応の任意のエージェントと通信できます。
外部の ACP エージェントを利用する場合、すべてのエージェント操作はそのエージェントに委ねられます。Devin Desktop のプライバシーポリシーおよび法的条件は適用されず、請求はお客様とサードパーティ製エージェントの提供元との間で直接行われます。
## エージェントの例
ACPに対応したエージェントであれば、どれでもDevin Desktop内で実行できます。接続できる代表的なACP対応エージェントには、次のようなものがあります。
* [Codex CLI](https://github.com/openai/codex) — OpenAIのコーディングエージェント
* [Claude Agent](https://www.anthropic.com/claude-code) — Anthropicのコーディングエージェント
* [OpenCode](https://opencode.ai) — オープンソースのコーディングエージェント
* [Junie](https://www.jetbrains.com/junie/) — JetBrainsのコーディングエージェント
* [Gemini CLI](https://github.com/google-gemini/gemini-cli) — Googleのコーディングエージェント
このようなサードパーティ製エージェントに加えて、ACPを利用して[カスタムエージェント](/ja/desktop/acp-custom)をDevin Desktopに統合することもできます。
## カスタムエージェントの有効化
エージェントを[ローカル](#local-registry-config)または[チーム](#team-registry-config)のレジストリに追加すると、`Devin Settings`から有効にできます。
1. macOSでは`Cmd+Shift+P`、Windows/Linuxでは`Ctrl+Shift+P`を押してコマンドパレットを開きます
2. `Devin User Settings`を開きます
3. 「Agents」タブをクリックします
4. 利用したいACPエージェントをオンにします
5. Devin Desktopを再起動します
有効にすると、*新しい*会話を開始する際に、Devin Desktopの右下にあるエージェントセレクターにそのエージェントが表示され、[Cascade](/ja/desktop/cascade/cascade)や[Devin Local](/ja/desktop/devin-local)などの組み込みエージェントとあわせて選択できるようになります。
## ローカルレジストリの設定
各ユーザーは、ローカルのレジストリファイルを編集して、自分用の ACP エージェントを設定できます。
* **Devin Desktop:** `~/.windsurf/acp/registry.json`
* **Devin Desktop Next:** `~/.windsurf-next/acp/registry.json`
コマンドパレットで `Open Local ACP Registry Config` を実行すると、このファイルを直接開くこともできます。
このファイルは [ACP registry spec](https://agentclientprotocol.com/get-started/registry) に準拠しています。
### Devin Local の設定例
チーム全体で有効化しなくても、ご自身のマシンで [Devin Local](/ja/desktop/devin-local) を試したい場合は、Devin CLI を参照するローカルレジストリを設定できます。
これは、`devin` CLI がすでにインストールされており、`PATH` から実行できることを前提としています。Devin Desktop は `devin acp` でこれを起動します。
```json theme={null}
{
"version": "1.0.0",
"agents": [
{
"id": "devin-cli",
"name": "Devin Local",
"version": "1.0.0",
"description": "Devin AI coding agent via Devin CLI",
"authors": [
"Cognition AI"
],
"license": "proprietary",
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"darwin-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"linux-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"linux-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"windows-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"windows-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
}
}
}
}
],
"extensions": []
}
```
## チームのレジストリ設定
チーム管理者は、[Devin Settings](https://windsurf.com/team/settings) の「ACP Registry Config」設定から、カスタム ACP 設定をチーム全体に展開できます。
これにより、チーム内のすべてのメンバーが利用できる、承認済み ACP エージェントの固定レジストリを維持できます。各ユーザーが個別に設定する必要はありません。
セキュリティ上の理由から、Devin Desktop は現在、レジストリからエージェントの配布物を直接ダウンロードしません。エージェントのバイナリは、あらかじめユーザーのマシンにインストールされている必要があり、レジストリ設定は Devin Desktop にその起動方法を伝えます。以下のサンプルにある `distribution.binary..archive` の URL は、より広いエコシステムとの互換性のため ACP レジストリのスキーマに含まれていますが、Devin Desktop は現時点ではそれらを取得しません。
### OpenCode の設定例
```json theme={null}
{
"version": "1.0.0",
"agents": [
{
"id": "opencode",
"name": "OpenCode",
"version": "1.15.7",
"description": "The open source coding agent",
"repository": "https://github.com/anomalyco/opencode",
"website": "https://opencode.ai",
"authors": [
"Anomaly"
],
"license": "MIT",
"icon": "https://cdn.agentclientprotocol.com/registry/v1/latest/opencode.svg",
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-arm64.zip",
"cmd": "./opencode",
"args": [
"acp"
]
},
"darwin-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-x64.zip",
"cmd": "./opencode",
"args": [
"acp"
]
},
"linux-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-arm64.tar.gz",
"cmd": "./opencode",
"args": [
"acp"
]
},
"linux-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-x64.tar.gz",
"cmd": "./opencode",
"args": [
"acp"
]
},
"windows-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-arm64.zip",
"cmd": "./opencode.exe",
"args": [
"acp"
]
},
"windows-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-x64.zip",
"cmd": "./opencode.exe",
"args": [
"acp"
]
}
}
}
}
],
"extensions": []
}
```
## トラブルシューティング
### 既存のエージェント設定がうまく動作しない
サードパーティ製エージェントでは、ほとんどの設定は各自の設定ファイルから読み込まれますが、認証は通常別途設定する必要があります。具体的には、一般的に次の対応が必要です。
* エージェント内で `/login` スラッシュコマンドを利用して認証する。
* Devin User Settings の Agents タブにある "..." ボタンを利用して環境変数を設定する。
* `settings.json` ファイルで `devin.acp.agentEnv.` 設定を利用して環境変数を設定する。