Windsurf（Devin Desktop）をほかのAIとつなぐ手順（その2）：MCPでツールをつなぐ、フックで自分のスクリプトに渡す、AI同士の組み合わせを、設定ファイルの書き方と渡るデータまで公式の記載で並べる

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

先に結論

• MCP は「使っているエージェントが Devin Local か Cascade か」で、読まれるファイルが変わると公式のページから読める。 手元の版で、どのファイルが読まれるかを確かめてください。
• MCP のツールは、既定で毎回確認が出る（Devin Local）。 権限は allow、deny、ask で絞れます。
• フックは Cascade 向けの説明。 Devin Local のフックは別の書式、と公式にあります。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIに外部のツールやデータをつなぐ共通の決まりです。
• MCPサーバー：ツールを、MCP の形で出す小さなプログラムです。自分のPCで動くもの（stdio）と、ネット上にあるもの（HTTP）があります。
• stdio：標準入出力で、プログラムとやりとりする方式です。MCP の「ローカルのコマンド」型の通信がこれです。
• OAuth：パスワードを渡さず、サービスに入る許可を出す仕組みです。
• Devin Local / Cascade：Devin Local は今の既定のエージェント、Cascade は旧エージェント（公式のFAQは「remains available through July」、Devin Local のページは「新しい会話は Cascade では始まらない」という趣旨。変更履歴の「削除」は原文を確認できていません。古い説明ページは残る。01を参照）です。
• フック：エージェントの動きの前後に、自分のコマンドを自動で動かす仕組みです。
• コマンドパレット：機能の名前を打って呼び出す入口です。Mac は ⌘+⇧+P、Windows と Linux は Ctrl+Shift+P。

連携A：MCP で外部のツールをつなぐ

まず、設定ファイルの場所（公式のページ同士で違う）

公式は、どれがどの版の Devin Desktop にあたるかを、はっきりとは書いていません。手元の版で、どのファイルが読まれるかを確かめてください（Devin Local の画面の「Open customizations」に、読み込まれた MCP サーバーの一覧が出る、と公式にあります）。

設定の書き方（Devin CLI のページの内容）

ローカルのコマンド（stdio）型の項目です。

リモート（HTTP）型の項目です。

• transport が "http" か省略のとき、CLI は Streamable HTTP を試し、認証以外の4xx エラーなら SSE に切り替える、とあります。
• Cascade のページは、URL型の項目名に serverUrl と url の両方を挙げ、headers を書けるとしています。

公式の例の写し（Devin CLI のMCP概要のページ）：ローカルの上書きのファイルに、トークンを書く例です。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

公式は、このファイルは .devin/mcp_config.local.json（git に入れない）に置き、トークンを、共有する設定ファイルに書かないようにする、と説明しています。Cascade のページの GitHub の例が、環境変数の名前 GITHUB_PERSONAL_ACCESS_TOKEN の同じ形だという点は、公式で確認できていません。

秘密の値を直接書かない書き方（公式の記載）

command、args、env、serverUrl、url、headers の中で、次の書き方が使えます（Cascade のページの記載）。

• ${env:変数名}：環境変数の値に置き換わる。未設定なら空の文字列。
• ${file:/パス}：ファイルの中身（前後の空白を除く）に置き換わる。~ から始まるパスも使える。読めなければ、書いたままになる。

この記事で組んだ例（公式の記載に合わせたもの。動作は確かめていません）：トークンを環境変数で渡す、リモート型の例です。

{
  "mcpServers": {
    "example-remote": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EXAMPLE_TOKEN}"
      }
    }
  }
}

mcp.example.com と EXAMPLE_TOKEN は、書き方の説明のための仮の名前です。

OAuth が要るサーバー（Atlassian、Notion、Linear など）

• 公式の Devin CLI のページは、各クライアントが別々に認証するので、Windsurf や Claude Code で通した認証は、Devin CLI に使い回されない、と書いています。
• Devin CLI では devin mcp login <サーバー名> でブラウザが開き、OAuth の認証をします。期限が切れたときは devin mcp logout のあと devin mcp login です。
• Devin Desktop の Devin Local では、期限切れの認証のサーバーは「Needs auth」と表示され、「Authenticate」を押すと、保存された認証を消して、ブラウザでの認証をやり直す、と公式にあります。

ツールの許可（権限）

• ツール名は mcp__<サーバー名>__<ツール名> の形です。たとえば github サーバーの create_issue は mcp__github__create_issue。
• Devin Local は、MCP のツールの呼び出しを、既定で毎回確認します。特定のツール、またはサーバーの全ツールを、セッションの間だけ、または恒久的に許可できます。
• 設定ファイルでは、permissions の下の allow、deny、ask の配列に、mcp__github__list_issues、mcp__github__*（1サーバーの全ツール）、mcp__*（全部）のような型を書きます。
• Cascade では、MCP の全ツールの合計が100までです。Cascade のページは、特定のツールを使わないときは、サーバーの設定の中の disabledTools に、ツール名を並べると書いています。

外し方・止め方

管理者の制御（Teams と Enterprise）

Cascade のページには、次のように書かれています。

• 管理者は、チームの MCP の入り切りと、許可リストの設定ができます。許可するサーバーを1つでも登録すると、登録されていないサーバーはブロックされます。
• サーバーIDは、mcp_config.json のキーと、大文字小文字を含めて一致させます。許可リストは正規表現で、全体に一致させ、引数の数も一致させます。
• 管理者の選択は3つ：サーバーIDだけ（公式が recommended と書く方法で、設定の中身は何でもよい）、完全一致、正規表現。
• Enterprise では、MCP レジストリのURLを置けます。複数なら和集合です。レジストリは Devin Local の「マーケットプレイス」に主に効く、とあります。

公式の注意

MCP のツールのコードは、サーバーを作った側のもので、ツール呼び出しの失敗について、公式は責任を負わない、と書かれています。Devin CLI のページは、トークンを、共有する設定ファイルに書かないよう案内しています。

連携B：フックで、自分のスクリプトにデータを渡す

公式の「Cascade Hooks」の内容です。これは Cascade のフックです。Devin Local には、別の書式のフックがあると書かれていますが、その書式は、今回読んだページには書かれていません。

• 設定の場所：システム（Mac は /Library/Application Support/Devin/hooks.json、Linux と WSL は /etc/devin/hooks.json、Windows は C:\ProgramData\Devin\hooks.json）、ユーザー（Devin Desktop は ~/.codeium/windsurf/hooks.json）、プロジェクト（.devin/hooks.json）。クラウドの管理画面からも足せます（Enterprise）。すべてが合わさり、クラウド、システム、ユーザー、プロジェクトの順に動きます。
• イベントは12種類：pre_read_code／post_read_code、pre_write_code／post_write_code、pre_run_command／post_run_command、pre_mcp_tool_use／post_mcp_tool_use、pre_user_prompt、post_cascade_response、post_cascade_response_with_transcript、post_setup_worktree。
• 書き方の形（公式の例を縮めた形）：

{
  "hooks": {
    "pre_run_command": [
      {
        "command": "python3 /path/to/your/script.py",
        "show_output": true
      }
    ]
  }
}

• フックのスクリプトには、標準入力で JSON が渡ります。共通の項目は、イベント名、会話のID、1回の動きのID、時刻、モデルの名前、イベント固有の情報（tool_info）です。tool_info には、読み書きのイベントなら file_path（書き込みは編集前後の文字列）、コマンドのイベントなら command_line と cwd、MCP のイベントならサーバー名、ツール名、引数、（後のイベントでは）結果、が入ります。ユーザーの入力、AIの返事、会話の記録のファイルも渡るイベントがあります。
• 終了コード：0 は成功。2 は、ブロックのエラーで、前処理のフックなら動作を止める。それ以外のコードはエラー扱いだが、動作は進む。止められるのは、pre_user_prompt、pre_read_code、pre_write_code、pre_run_command、pre_mcp_tool_use だけです。
• 公式の注意：フックは、利用者の全権限でシェルのコマンドを動かします。入力（特にファイルのパスとコマンド）を検証し、秘密を記録に残さない。会話の記録のファイルや返事には、コードの中身が含まれうる。重要な決まりは、プロジェクトのファイルではなく、クラウドかシステムの側に置く。
• Restricted Mode のワークスペースでは、フックは読み込まれず、動きません。

「AI同士」の組み合わせ：具体的な形

次は、公式の記載から組める組み合わせを並べたものです。組み合わせの表は、この記事の整理で、公式が示した組み合わせではありません。

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

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式のドキュメントを読んだ範囲です。公式ページは要約の形で取得しました。
• 公式の資料の間で、MCP の設定ファイルの名前（.devin/config.json、.devin/mcp_config.json、~/.config/devin/mcp_config.json、~/.codeium/mcp_config.json）と、Cascade の扱いに食い違いがあります。どれかに決めつけず、手元の版と画面で確かめてください。
• MCP のサーバーは、多くが第三者のコードです。公式は、ツール呼び出しの失敗に責任を負わない、と書いています。鍵は設定ファイルに直接書かず、${env:...} や ${file:...} で渡す書き方が公式に用意されています。
• フックは、利用者の全権限でコマンドを動かします。公式の注意（入力の検証、秘密を記録に残さない）を読んでから設定してください。
• 読めていないページ：Devin Local のフックの書式、MCP のマーケットプレイスの画面の手順、管理者向けのAPIは、今回読んでいません。
• 取得したページの中に、AIへの指示のような文は見当たりませんでした。
• 規約の解釈は、公式や専門家に確認してください。この記事は法律の助言ではありません。

出典

• Cascade MCP Configuration（Devin ドキュメント、Cognition、確認日 2026-10-25）
• MCP in Devin CLI（Devin ドキュメント、Cognition、確認日 2026-10-25）
• MCP Configuration（Devin CLI）（Devin ドキュメント、Cognition、確認日 2026-10-25）
• Devin Local Agent（Devin ドキュメント、Cognition、確認日 2026-10-25）
• Cascade Hooks（Devin ドキュメント、Cognition、確認日 2026-10-25）
• Devin Desktop FAQ（Devin ドキュメント、Cognition、確認日 2026-10-25）
• Agent Client Protocol（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）
• Skills（Devin ドキュメント、Cognition、確認日 2026-10-25）
• Devin Desktop（devin.ai、Cognition、確認日 2026-10-25）
• Documentation index: Desktop（Devin ドキュメント、Cognition、確認日 2026-10-25）