3行でいうと
- この記事で扱うのは5つです。ACP(別社のエージェントを Devin Desktop の中で動かす)、Devin CLI、Devin Cloud(クラウドの Devin に渡す)、JetBrains から Devin を使う(ACP)、設定やルールの取り込み。
- ACP で外部のエージェントを使うと、公式は「操作はそのエージェントに任される」「Devin Desktop のプライバシーポリシーと規約は適用されない」「請求は、あなたとその提供元の間」と書いています。
- ACP のエージェントは、Devin Desktop が自動で入れることはなく、自分のPCに先に入れておく必要があります。レジストリは「起動のしかた」を伝えるだけ、と公式は書いています。
- 外し方(連携の解除)は、書かれていないものが多いです。「記載が見つからない」と書いた箇所は、公式で確認できていません。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。手順は「公式の手順を順に並べたもの」、設定例は「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例(動作は確かめていません)」と、そのつど書き分けます。画面の表記は変わることがあるので、手元の画面と照らしてください。
先に結論
- 連携は「誰が動かすか」で分けて読む。 公式が動かすもの(Devin Local、Devin Cloud、Devin CLI)と、第三者が動かすもの(ACP の外部エージェント)では、データの扱いと請求の相手が違います。
- ACP は「設定する」「再起動する」「新しい会話で選ぶ」の3段階。 認証は、エージェントごとの別の仕組みです。
- どのファイルに書くかは、使うエージェントで変わる。 今の既定は Devin Local、旧エージェントは Cascade です。公式のページには、どちらの話かを明記したものと、していないものがあります。
前提:用語をそろえる
- ACP(Agent Client Protocol):エディタと、コーディングエージェントのやりとりを標準化した、公開の決まりです。
- レジストリ:ここでは、使えるエージェントの一覧と起動のしかたを書いたファイルです。ACP のレジストリは JSON で書きます。
- Devin Local / Devin Cloud / Devin CLI:Devin Local は自分のPC上で動く既定のエージェント、Devin Cloud はクラウドのVMで動く Devin、Devin CLI はターミナルで動くエージェントで、Devin Local と同じ仕組みを共有する、と公式にあります。
- コマンドパレット:機能の名前を打って呼び出す入口です。Mac は
⌘+⇧+P、Windows と Linux はCtrl+Shift+P。
連携の全体表
| 連携 | つなぐ相手 | 設定する場所(公式の記載) | 動かすのは | 外し方(公式の記載) |
|---|---|---|---|---|
| ACP | Codex CLI、Claude Agent、OpenCode、Junie、Gemini CLI、自作のエージェント | コマンドパレット→「Devin User Settings」→「Agents」タブ。レジストリは registry.json |
第三者(エージェントごと) | オンにする手順は書かれている。外す手順は記載が見つからない |
| MCP(Devin Local)※その2で扱う | MCPサーバー | 設定ファイルに mcpServers(下の表のとおり、ページ間で名前が違う) |
多くは第三者 | disabled や devin mcp disable など(Devin CLI のページ) |
| MCP(Cascade) | MCPサーバー | Cascade のパネル→「...」→「Open MCP config file」 | 多くは第三者 | サーバーのオン・オフの切り替え、disabledTools |
| Devin Cloud | クラウドの Devin | Devin Desktop の中の計画から1回の操作で渡す | 公式 | 記載が見つからない |
| JetBrains×Devin | JetBrains の AI Chat | AI Chat の「Install From ACP Registry...」か acp.json |
公式(Devin)と JetBrains | 「Reset ACP Authentication」(認証の消去) |
| 設定・ルールの取り込み | VS Code、Cursor、以前の Windsurf、AGENTS.md | コマンドパレット、最初の起動の画面 | 公式 | 取り込んだものは設定ファイルとして残る(削除の手順は記載が見つからない) |
| フック ※その2で扱う | 自分のスクリプト | hooks.json |
自分 | ファイルから消す |
連携1:ACP で、別のエージェントを Devin Desktop の中で動かす
公式の「Agent Client Protocol」の内容です。
前提
- 対象プラン:Pro、Max、Teams。Enterprise は、アカウント担当に連絡して第三者のエージェントを有効にする、とあります。
- 公式が例に挙げるエージェント:Codex CLI、Claude Agent、OpenCode、Junie、Gemini CLI。ACP に対応した自作のエージェントもつなげます。
- エージェントのプログラムは、先に自分のPCへ入れておく。 Devin Desktop は、レジストリからエージェントをダウンロードしません。レジストリは起動のしかた(コマンドと引数)を伝えるだけです。スキーマにある
archiveのURLは、互換性のためのもので、今は取りに行かれない、と書かれています。
手順(公式の順)
- 使いたいエージェントを、ローカルかチームのレジストリに足す(下の「レジストリの書き方」)。
- コマンドパレットを開く。
- 「Devin User Settings」を開く。
- 「Agents」タブを押す。
- 使いたい ACP エージェントのスイッチをオンにする。
- Devin Desktop を再起動する。
- 新しい会話を始めるとき、右下のエージェントの選択に、オンにしたエージェントが Devin Local などと並んで出る。
「すでにある会話のエージェントを入れ替える」手順は、公式で確認できていません(「新しい会話」で選ぶ、とあります)。
レジストリの書き方
自分用のレジストリは、ACP のレジストリの仕様に沿った JSON のファイルです。公式が示す置き場所は次のとおりです。
| 環境 | 公式に書かれた場所 |
|---|---|
| Mac と Linux(Devin Desktop) | ~/.windsurf/acp/registry.json |
| Mac と Linux(Devin Desktop Next) | ~/.windsurf-next/acp/registry.json |
| Windows(すべての版) | %USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json |
- 場所の名前に、古い「windsurf」や「Code」が残っているのは、公式の記載どおりです。迷ったら、コマンドパレットで「Open Local ACP Registry Config」を実行すると、設定ファイルが開く、と公式が書いています。
- 公式の例は、Devin Local 用と OpenCode 用の2つです。どちらも
version、agents(その中にid、name、version、description、authors、license、distribution)、extensionsという構造で、distributionのbinaryの下に、OSとCPUの種類(darwin-aarch64、darwin-x86_64、linux-aarch64、linux-x86_64、windows-aarch64、windows-x86_64)ごとに、cmd(起動するコマンド)とargs(引数。どちらの例も["acp"])を書きます。 - Devin Local の例は、
devinコマンドがPATHにあることが前提で、Devin Desktop がdevin acpで起動します。公式は、チーム全体に有効にせずに Devin Local を試す方法として示しています。
次は、公式の例の構造を、この記事で Mac(Apple Silicon)だけに縮めた例です(動作は確かめていません)。全体は公式ページで確認してください。
{
"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"] }
}
}
}
],
"extensions": []
}
チーム用のレジストリ
管理者は、チーム共通のレジストリを置けます(公式の acp.md は「local or team registry」と書きます。置く画面の名前「ACP Registry Config」は、公式で確認できていません)。承認済みのエージェントの静的な一覧になり、メンバーは個別の設定なしで使えます。ただし、エージェントの本体は、各自のPCに入っている必要があります。
認証:エージェントごとに別の仕組み
公式は、第三者のエージェントは、設定の多くを自分の設定ファイルから読むが、認証は別、と書いています。方法は3つです。
- そのエージェントの
/loginスラッシュコマンドを実行する。 - 「Devin User Settings」の「Agents」タブにある「...」ボタンから、環境変数を設定する。
settings.jsonのdevin.acp.agentEnv.<エージェント名>で、環境変数を設定する。
公式の「トラブルシューティング」の項は、「既存のエージェントの設定がうまく動かない」ときは、まず認証を確かめる、と書いています(上の3つのどれか)。
渡るデータと請求
| 項目 | 公式の記載 |
|---|---|
| 操作 | すべて、その外部エージェントに任される |
| 規約 | Devin Desktop のプライバシーポリシーと法的な規約は、その操作には適用されない |
| 請求 | あなたと、その第三者のエージェントの提供元の間 |
| 文脈 | 開いているフォルダの場所、設定されている MCP サーバー(session/new で渡す、と自作エージェントの案内にある)。ファイルの中身がどこまで渡るかは、エージェントの実装による。公式のページで確認できていません |
つまり、ここから先は、そのエージェントの会社の規約とデータの扱いを、別に読む必要があります(04の考え方も参照)。
自作の ACP エージェント(公式の「Building a custom ACP agent」)
- Devin Desktop は、エージェントを、必要なときにローカルの子プロセスとして起動し、やりとりは標準入出力の JSON-RPC で行います。
- 必須のメソッドは
initialize、session/new、session/prompt、session/cancelです。ストリームの通知にはsession/update(agent_message_chunk、tool_call、tool_call_update、plan)と、承認のためのsession/request_permissionがあります。 - 登録は、ローカルのレジストリの設定に、
cmdが自分のエージェントのバイナリ、またはラッパーのスクリプトを指す項目を足します。 - 試すときは、登録して、作り直し、コマンドパレットの「Reload ACP Connections」を実行します。Devin Desktop の再起動は要らない、と書かれています。
- 制限:セッションのモードは未対応(モードを出したいときは、「mode」カテゴリーのセッション設定のオプションを使う)。ターミナルの機能は申告されないので、コマンドは自分のサブプロセスで実行し、出力を
tool_callで流す。 - 公式は、クライアントのライブラリとして、Rust、TypeScript、Python、Kotlin、Java を挙げています。
制限
どのエージェントも(Devin Local も ACP のエージェントも)、作業フォルダが Restricted Mode のときは使えません。フックも、そのときは読み込まれず、動きません。
外し方
オンにする手順だけが書かれていて、外す手順は、公式で確認できていません。「Agents」タブのスイッチをオフにして再起動する、というのが、手順の裏返しで読める方法ですが、公式の記載ではありません。第三者のエージェント側に保存された認証やデータの消し方は、そのエージェントの資料で確認してください。
連携2:Devin CLI と Devin Desktop
公式の「Devin CLI」のページの内容です。
- 入れ方は05の手順5を参照してください(Mac と Linux のコマンド、Homebrew、Windows)。実行するコマンドは、公式ページの原文で確認してください。
- Devin Desktop に同梱する形は、Legacy Windsurf Enterprise と Devin Enterprise のプラン向けです。管理者が「Install Devin CLI in Devin Desktop」を有効にしたあと、各自がコマンドパレットで「Install Devin CLI」を実行すると、
devinが PATH に入ります。 - CLI は、Devin アカウントの Knowledge、Playbooks、Secrets にはまだ対応していない、とあります。
- Devin CLI の MCP 設定と、Devin Local の MCP 設定は、同じ仕組みを共有するとされています(MCP の設定は「その2」=08で扱います)。
- ACP との関係:ACP のレジストリに
devin acpを書く方法が、連携1の例です。devin acpは、ACP のクライアント(エディタ)が子プロセスとして起動するためのもので、手で対話的に動かすものではない、と JetBrains の案内に書かれています。
連携3:クラウドの Devin に渡す
公式の「Devin Cloud in Devin Desktop」の内容です。
前提
- Pro、Max、Teams の個人向けのプランに含まれます。Enterprise は、管理者が Admin Portal で有効にします。
- 段階的に出ているため、表示されないときは、いったんログアウトして入り直す、と書かれています。
- 利用は、Devin Desktop の共有の枠と追加利用の残高を使います。
手順
- ローカルのエージェントで計画を作ります。
- その計画を、1回の操作で Devin に渡します。操作の名前や場所は、公式で確認できていません。
- Devin は自分のVMで作業します(デスクトップとブラウザがあるVM)。ノートPCを閉じても作業は続き、あとで戻ってこられます。
- Devin のセッションは、Agent Command Center に、ローカルのエージェントと並んで出ます。Spaces にもまとめられます。
- セッションの中で、
Cmd/Ctrl+Enterでサーバー側にメッセージを積めます。積んだメッセージは、再読み込みしても残り、ウェブのアプリにも出ます。 - 接続が切れると「Remote ACP is disconnected」というバナーが出ます。「Reconnect」を押します。
- セッションのメニューから、セッションのリンクをコピーして、共有したり、ウェブのアプリで開いたりできます。
GitHub の連携
- 公式は、Devin に GitHub をつなぐと書いていますが、つなぎ方は別のページ(GitHub の連携のガイド)に委ねていて、このページには手順がありません。
- つなぐと、追加利用のクレジットが最大50ドル(GitHub アカウントの成熟度で変わる)もらえる、と書かれています(2026年10月25日に読んだ記載。変わることがあります)。
渡るデータ
このページには、コードがクラウドへどう送られ、どう保存されるかは書かれていません。GitHub や Slack の権限の扱いは、このページには書かれていません(03を参照)。
外し方
セッションを止める、GitHub の連携を外す手順は、このページにはありませんでした(記載が見つからない)。
連携4:JetBrains の中で Devin を使う(ACP)
公式の「Using Devin in JetBrains IDEs via ACP」の内容です。Windsurf の JetBrains プラグインは保守モードで、FAQは、Devin を ACP で使う設定を案内しています(01と05を参照)。
前提: JetBrains の IDE に、AI Assistant のプラグインと AI Chat があること。
方法A:ACP レジストリからの導入(公式は「the quickest way」と書く)
- 右側のツールウィンドウのバーの「AI Chat」のアイコンを押す。
- AI Chat の下のエージェントの選択を開く。
- 「Install From ACP Registry...」を選び、「Devin」を検索して「Install」を押す。
- 最初の接続で、Devin アカウントへのログインの案内が出る(任意と書かれている)。
- エージェントの選択で「Devin」を選び、メッセージを送ると、セッションが始まる。
方法B:自分で、カスタムのエージェントとして足す
前提: Devin CLI を入れて認証してあること(入れたあとに devin auth login)。which devin で、devin の絶対パスを調べる(通常は ~/.local/bin/devin)。JetBrains のリモート開発では、手元ではなくリモートのホストに Devin CLI を入れ、そのパスを使う。
- 「AI Chat」のアイコンを押す。
- AI Chat のパネルの右上の三点から「Add Custom Agent」を選ぶと、
acp.jsonが開く。 agent_serversの中に Devin を足し、commandをdevinのパス、argsを["acp"]にする。次が公式の例です。
{
"default_mcp_settings": {},
"agent_servers": {
"devin": {
"command": "/home/you/.local/bin/devin",
"args": ["acp"]
}
}
}
- 保存すると、Devin が選べるようになる。
- AI Chat で「devin」を選び、メッセージを送る。認証には、
devin auth loginの資格情報、または環境変数WINDSURF_API_KEYが使われる(設定されているとき)、と書かれています。
管理と制限
- 三点のメニューの「Reset ACP Authentication」で、保存された認証を消して、やり直せます。「Get ACP Logs」で、接続の不具合のログを開けます。
- Devin のスラッシュコマンドは、AI Chat のコマンドの入口に出ます。ターミナルの出力は、AI Chat の ACP の表示を通り、CLI 単体の見た目とは違います。一部の細かい操作は、単体の CLI でしかできません。
- 渡るデータ:JetBrains の AI Chat(JetBrains の機能)を通して、Devin に依頼が渡ります。通信の細かい内容は、公式のページで確認できていません。
連携5:ほかのエディタや形式の設定を取り込む
| 取り込む元 | 方法(公式の記載) | 備考 |
|---|---|---|
| 以前の Windsurf | 最初の起動で「Migrate from Windsurf」 | 設定、キー割り当て、スニペット、ワークスペースの状態、拡張機能をコピー。キャッシュ、ログ、ローカル履歴は対象外 |
| VS Code、Cursor の設定 | コマンドパレットの取り込みのコマンド(正確な文字列は公式で確認できていない) | 最初の画面で取り込まなかった場合 |
| Cursor のルール | .cursor/rules(.mdc)を .devin/rules/ に取り込める(FAQ) |
「Memories & Rules」のページには取り込みの記載がない |
| AGENTS.md | AGENTS.md、agents.md を読む |
Devin Local は CLI のルールの仕組みで読む |
| スキル | .agents/skills/、~/.agents/skills/ を探す。Claude Code の設定の読み込みが有効なら、.claude/skills/、~/.claude/skills/ も探す(Skills のページ) |
「Claude Code の設定の読み込み」を有効にする場所は、公式のページで確認できていません |
- 取り込んだものは、ファイルとして残ります。外したいときは、そのファイルを消す、または、別名にする形になります。専用の「取り消し」の画面は、記載が見つかりませんでした。
- 公式は、「他のマーケットプレイスの拡張機能は入れられない。一部のAI補完や専用の拡張機能は使えない」とも書いています。
うまくいかないときの確認点
| 症状 | 公式の記載から確認すること |
|---|---|
| ACP のエージェントが一覧に出ない | レジストリのファイルの置き場所と JSON の形。再起動したか。新しい会話で選んでいるか(既存の会話では出ない、と読める) |
| ACP のエージェントが動かない | エージェントのプログラムが、先に自分のPCに入っているか(自動では入らない)。認証(/login、環境変数、devin.acp.agentEnv.<名前>)。「Reload ACP Connections」 |
| ACP の自作エージェントを直した | 「Reload ACP Connections」を実行する(再起動は不要と書かれている) |
| Devin Cloud が表示されない | いったんログアウトして入り直す。Enterprise は管理者が有効にしているか |
| 「Remote ACP is disconnected」 | バナーの「Reconnect」を押す |
| JetBrains の接続の不具合 | 「Get ACP Logs」を開く。「Reset ACP Authentication」で認証をやり直す |
| どのエージェントも使えない | 作業フォルダが Restricted Mode でないか |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式のドキュメントを読んだ範囲です。公式ページは要約の形で取得しました。
- ACP のレジストリの Windows の置き場所は、公式の書き方のとおり写しました(
Code\Userを含む形)。実際のフォルダと合うかは、「Open Local ACP Registry Config」で開くファイルで確かめてください。 - ACP で外部のエージェントを使うとき、Devin Desktop のプライバシーポリシーと規約は、その操作に適用されません。使う前に、そのエージェントの規約とデータの扱いを読んでください。
- 公式の資料の間で、Cascade の扱いに食い違いがあります。どちらの説明か、手元の版と画面で確かめてください。
- 読めていないページ:ZedやXcodeの設定、Devin CLI の ACP の他のページ、ChatGPT でのサインイン、管理者向けのAPIは、今回読んでいません。
- 取得したページの中に、AIへの指示のような文は見当たりませんでした。
- 続きの MCP、フック、AI同士の組み合わせの表は、「その2」(08_windsurf_connect_steps_2.md)です。
- 規約の解釈は、公式や専門家に確認してください。この記事は法律の助言ではありません。
出典
- Agent Client Protocol(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Building a custom ACP agent(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Devin Local Agent(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Devin CLI(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Devin Cloud in Devin Desktop(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Using Devin in JetBrains IDEs via ACP(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Memories & Rules(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Skills(Devin ドキュメント、Cognition、確認日 2026-10-25)
- AGENTS.md(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Agent Command Center(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Devin Desktop FAQ(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Welcome to Devin Desktop(Devin ドキュメント、Cognition、確認日 2026-10-25)
- Devin Desktop(devin.ai、Cognition、確認日 2026-10-25)
- Documentation index: Desktop(Devin ドキュメント、Cognition、確認日 2026-10-25)