3行でいうと

  • この記事で扱うのは5つです。ACP(別社のエージェントを Devin Desktop の中で動かす)、Devin CLI、Devin Cloud(クラウドの Devin に渡す)、JetBrains から Devin を使う(ACP)、設定やルールの取り込み。
  • ACP で外部のエージェントを使うと、公式は「操作はそのエージェントに任される」「Devin Desktop のプライバシーポリシーと規約は適用されない」「請求は、あなたとその提供元の間」と書いています。
  • ACP のエージェントは、Devin Desktop が自動で入れることはなく、自分のPCに先に入れておく必要があります。レジストリは「起動のしかた」を伝えるだけ、と公式は書いています。
  • 外し方(連携の解除)は、書かれていないものが多いです。「記載が見つからない」と書いた箇所は、公式で確認できていません。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。手順は「公式の手順を順に並べたもの」、設定例は「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例(動作は確かめていません)」と、そのつど書き分けます。画面の表記は変わることがあるので、手元の画面と照らしてください。

先に結論

前提:用語をそろえる

連携の全体表

連携 つなぐ相手 設定する場所(公式の記載) 動かすのは 外し方(公式の記載)
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」の内容です。

前提

手順(公式の順)

  1. 使いたいエージェントを、ローカルかチームのレジストリに足す(下の「レジストリの書き方」)。
  2. コマンドパレットを開く。
  3. 「Devin User Settings」を開く。
  4. 「Agents」タブを押す。
  5. 使いたい ACP エージェントのスイッチをオンにする。
  6. Devin Desktop を再起動する。
  7. 新しい会話を始めるとき、右下のエージェントの選択に、オンにしたエージェントが 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

次は、公式の例の構造を、この記事で 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つです。

  1. そのエージェントの /login スラッシュコマンドを実行する。
  2. 「Devin User Settings」の「Agents」タブにある「...」ボタンから、環境変数を設定する。
  3. settings.json の devin.acp.agentEnv.<エージェント名> で、環境変数を設定する。

公式の「トラブルシューティング」の項は、「既存のエージェントの設定がうまく動かない」ときは、まず認証を確かめる、と書いています(上の3つのどれか)。

渡るデータと請求

項目 公式の記載
操作 すべて、その外部エージェントに任される
規約 Devin Desktop のプライバシーポリシーと法的な規約は、その操作には適用されない
請求 あなたと、その第三者のエージェントの提供元の間
文脈 開いているフォルダの場所、設定されている MCP サーバー(session/new で渡す、と自作エージェントの案内にある)。ファイルの中身がどこまで渡るかは、エージェントの実装による。公式のページで確認できていません

つまり、ここから先は、そのエージェントの会社の規約とデータの扱いを、別に読む必要があります(04の考え方も参照)。

自作の ACP エージェント(公式の「Building a custom ACP agent」)

制限

どのエージェントも(Devin Local も ACP のエージェントも)、作業フォルダが Restricted Mode のときは使えません。フックも、そのときは読み込まれず、動きません。

外し方

オンにする手順だけが書かれていて、外す手順は、公式で確認できていません。「Agents」タブのスイッチをオフにして再起動する、というのが、手順の裏返しで読める方法ですが、公式の記載ではありません。第三者のエージェント側に保存された認証やデータの消し方は、そのエージェントの資料で確認してください。

連携2:Devin CLI と Devin Desktop

公式の「Devin CLI」のページの内容です。

連携3:クラウドの Devin に渡す

公式の「Devin Cloud in Devin Desktop」の内容です。

前提

手順

  1. ローカルのエージェントで計画を作ります。
  2. その計画を、1回の操作で Devin に渡します。操作の名前や場所は、公式で確認できていません。
  3. Devin は自分のVMで作業します(デスクトップとブラウザがあるVM)。ノートPCを閉じても作業は続き、あとで戻ってこられます。
  4. Devin のセッションは、Agent Command Center に、ローカルのエージェントと並んで出ます。Spaces にもまとめられます。
  5. セッションの中で、Cmd/Ctrl+Enter でサーバー側にメッセージを積めます。積んだメッセージは、再読み込みしても残り、ウェブのアプリにも出ます。
  6. 接続が切れると「Remote ACP is disconnected」というバナーが出ます。「Reconnect」を押します。
  7. セッションのメニューから、セッションのリンクをコピーして、共有したり、ウェブのアプリで開いたりできます。

GitHub の連携

渡るデータ

このページには、コードがクラウドへどう送られ、どう保存されるかは書かれていません。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」と書く)

  1. 右側のツールウィンドウのバーの「AI Chat」のアイコンを押す。
  2. AI Chat の下のエージェントの選択を開く。
  3. 「Install From ACP Registry...」を選び、「Devin」を検索して「Install」を押す。
  4. 最初の接続で、Devin アカウントへのログインの案内が出る(任意と書かれている)。
  5. エージェントの選択で「Devin」を選び、メッセージを送ると、セッションが始まる。

方法B:自分で、カスタムのエージェントとして足す

前提: Devin CLI を入れて認証してあること(入れたあとに devin auth login)。which devin で、devin の絶対パスを調べる(通常は ~/.local/bin/devin)。JetBrains のリモート開発では、手元ではなくリモートのホストに Devin CLI を入れ、そのパスを使う。

  1. 「AI Chat」のアイコンを押す。
  2. AI Chat のパネルの右上の三点から「Add Custom Agent」を選ぶと、acp.json が開く。
  3. agent_servers の中に Devin を足し、command を devin のパス、args を ["acp"] にする。次が公式の例です。
{
  "default_mcp_settings": {},
  "agent_servers": {
    "devin": {
      "command": "/home/you/.local/bin/devin",
      "args": ["acp"]
    }
  }
}
  1. 保存すると、Devin が選べるようになる。
  2. AI Chat で「devin」を選び、メッセージを送る。認証には、devin auth login の資格情報、または環境変数 WINDSURF_API_KEY が使われる(設定されているとき)、と書かれています。

管理と制限

連携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 の設定の読み込み」を有効にする場所は、公式のページで確認できていません

うまくいかないときの確認点

症状 公式の記載から確認すること
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 でないか

気をつけること

出典