Cascade MCP 統合

MCP (Model Context Protocol) は、LLM がカスタムツールやサービスにアクセスできるようにするプロトコルです。 MCP クライアント (この場合は Cascade) は、MCPサーバーにリクエストを送信して、そこで提供されるツールにアクセスできます。 Cascade は MCP とネイティブに統合されているため、Cascade で利用する MCPサーバーを自由に追加できます。詳しくは、MCP の公式ドキュメントを参照してください。

Enterprise ユーザーは、設定からこれを手動で有効にする必要があります

このページの MCP の設定は、レガシー Cascade agent にのみ適用されます。 新しいタブのデフォルト agent である Devin Local agent では、代わりに Devin CLI の設定ファイルで MCPサーバーを設定します。

新しいMCPを追加する

新しいMCPは MCP Marketplace から追加できます。MCP Marketplace には、Cascade パネル右上のメニューにある MCPs アイコンをクリックするか、 Devin Settings > Cascade > MCP Servers セクションからアクセスできます。目的のMCPが見つからない場合は、mcp_config.json ファイルを直接編集して手動で追加できます。公式MCPには青いチェックマークが表示され、提供元のサービス企業が作成したものであることを示します。 MCPをクリックしたら、Install をクリックするだけで、そのサーバーとツールを Cascade で利用できるようになります。

ディープリンクによるワンクリックインストール

Devin Desktop は、ディープリンク経由でのワンクリック MCP インストールをサポートしています。これらのリンクを利用すると、MCP のレジストリページを Devin Desktop で直接開くことができるため、MCPサーバーのおすすめを共有したり、ドキュメントにインストールボタンを埋め込んだりする際に便利です。ディープリンクの形式は次のとおりです。

windsurf://windsurf-mcp-registry?serverName=<server-name>

serverName がある場合: 指定したサーバーの MCP レジストリページを開き、ユーザーはそこで内容を確認してインストールできます。
serverName がない場合: MCP Marketplace ページを開きます。

たとえば、windsurf://windsurf-mcp-registry?serverName=github-mcp-server を開くと、Devin Desktop で GitHub MCPサーバーのレジストリページが開きます。

ワンクリックインストール用の deeplink を利用するには、ユーザーのチームで MCP アクセスが有効になっている必要があります。管理者によって MCP アクセスが無効になっている場合、deeplink ではレジストリページを開けません。

Devin Desktop は、MCP server 向けに 3 種類の transport types (stdio、Streamable HTTP、SSE) をサポートしています。 Devin Desktop は、各 transport type での OAuth にも対応しています。 http server の場合、URL は endpoint を反映したものにし、https://<your-server-url>/mcp のような形式にしてください。

MCPツールの設定

各MCPで利用できるツール数は決まっています。Cascadeが同時に利用できるツールの総数は100個までです。各MCPの設定ページでは、有効にするツールを切り替えられます。MCPの設定を開くには、Cascadeパネル右上のメニューにあるMCPsアイコンをクリックし、目的のMCPをクリックします。

mcp_config.json

~/.codeium/windsurf/mcp_config.json ファイルは、Cascade が接続できるサーバーの一覧を含む JSON ファイルです。以下は、GitHub 用に単一のサーバーを設定する構成例です。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

利用したいサーバーに必要な引数と環境変数を必ず指定してください。サーバーの例については、MCPサーバーの公式リファレンスリポジトリまたは OpenTools を参照してください。

よく使われるMCPサーバーの使用例

以下は、よく使われるMCPサーバーの設定例です。これらは mcp_config.json ファイルに追加できます。

GitHub

リポジトリ管理、ファイル操作、GitHub API との統合。

GitHub MCP server は、リポジトリ管理、ファイル操作、issue の追跡、PR 管理のためのツールを提供します。npx を使用する場合:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

Docker を使用する場合:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

パーソナルアクセストークンを作成するには、GitHub Settings > Developer settings > Personal access tokens にアクセスしてください。

Slack

Slack ワークスペース向けのチャンネル管理とメッセージ機能。

Slack MCP server は、チャンネル管理、メッセージ送信、ワークスペース内での操作を可能にします。

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>",
        "SLACK_TEAM_ID": "<YOUR_SLACK_TEAM_ID>"
      }
    }
  }
}

Slack の bot token を設定するには、次の手順を実行します。

api.slack.com/apps で Slack App を作成します
必要な OAuth scopes (例: channels:read, chat:write, users:read) を追加します
アプリをワークスペースにインストールし、Bot User OAuth Token をコピーします

PostgreSQL

スキーマ確認機能を備えた読み取り専用のデータベースアクセス。

PostgreSQL MCP server は、スキーマ確認やクエリ実行を含む、PostgreSQL データベースへの読み取り専用アクセスを提供します。

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/database"
      }
    }
  }
}

PostgreSQL server は、安全のためデフォルトで読み取り専用アクセスを提供します。接続文字列には、適切で権限が制限された認証情報を使用してください。

Filesystem

設定可能なアクセス制御による安全なファイル操作。

Filesystem MCP server は、設定可能なアクセス制御により、ローカルのファイルやディレクトリへの安全なアクセスを提供します。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

パス引数を追加することで、複数の許可ディレクトリを指定できます。アクセスできるのは、これらのディレクトリ内のファイルのみです。

Brave Search

Brave の Search API を使用した Web 検索とローカル検索。

Brave Search MCP server は、Brave’s Search API を使用した Web 検索機能を提供します。

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>"
      }
    }
  }
}

Brave APIキーを取得するには、brave.com/search/api で登録してください。

Memory

ナレッジグラフベースの永続メモリシステム。

Memory MCP server は、ナレッジグラフを利用した永続メモリシステムを提供し、Cascade がセッションをまたいで情報を記憶できるようにします。

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

memory server はデータをローカルに保存し、セッションをまたいで保持します。そのため、プロジェクト、設定、学習した情報に関する前提情報を維持するのに役立ちます。

リモート HTTP MCP

リモート HTTP MCP の場合、設定がやや異なり、serverUrl または url フィールドが必要になる点に注意してください。以下は HTTP サーバーの設定例です。

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

設定の補間

~/.codeium/windsurf/mcp_config.json ファイルでは、command、args、env、serverUrl、url、headers の各フィールドで変数補間をサポートしています。これにより、シークレットを設定ファイルに直接ハードコードせずに済みます。サポートされている補間パターンは 2 つあります。

${env:VAR_NAME} — 環境変数 VAR_NAME の値に置き換えられます。変数が設定されていない場合は、空文字列になります。
${file:/path/to/file} — 指定したパスのファイル内容 (前後の空白を除去したもの) に置き換えられます。チルダ付きのパス (例: ~/secrets/key.txt) もサポートされています。ファイルを読み取れない場合、このパターンはそのまま残ります。

以下は、headers で環境変数を使用する例です。

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "Bearer ${env:AUTH_TOKEN}"
      }
    }
  }
}

以下は、ファイルからAPIキーを読み込む例です。

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${file:~/.secrets/api_key.txt}"
      }
    }
  }
}

管理者向け設定 (チームとEnterprise)

チーム管理者は、自分のチームの MCP アクセスを切り替えたり、チームで利用する承認済みの MCPサーバーを許可リストに追加したりできます:

MCP Registry

Enterpriseのチームは、デフォルトのDevin Desktop MCP marketplaceの代わりに、カスタムMCPレジストリを設定できます。チームは独自のレジストリURLを関連付けることで、ユーザーが利用できるMCPを管理できます。

MCPアクセスの管理にはレジストリの利用を推奨しますが、許可リストでも対応できます。

カスタムレジストリの設定

チーム設定に移動します
MCP Registry URLs 設定を見つけます
1 つ以上のレジストリ URL を追加します

複数のレジストリ URL が設定されている場合、Devin Desktop はそれらすべてのレジストリの 和集合 を利用します。つまり、ユーザーには設定されたすべてのソースの MCP がまとめて表示されます。その後、チームの MCP marketplace は、デフォルトの Devin Desktop レジストリではなく、これらの内部レジストリから取得するようになります。

カスタムレジストリは、公式 MCP レジストリスキーマに従う必要があります。これにより、互換性と標準化されたサーバー定義が確保されます。

MCP 許可リスト

MCP チーム設定

チーム向けの設定可能な MCP 設定です。

上記のリンクは、チームの管理者権限がある場合にのみ利用できます。

デフォルトでは、チーム内のユーザーは各自で自分のMCPサーバーを設定できます。ただし、MCPサーバーを1つでも許可リストに追加すると、許可リストに登録されていないすべてのサーバーがチーム内でブロックされます。

許可リストの Server ID は、ユーザーの mcp_config.json で利用されているキー名と大文字・小文字まで一致している必要があります。

サーバーのマッチングの仕組み

MCPサーバーを許可リストに追加すると、システムは以下のルールに従って正規表現によるパターンマッチングを利用します。

文字列全体のマッチング: 部分一致を防ぐため、すべてのパターンには自動的にアンカーが付与されます (^(?:pattern)$ で囲まれます)
Command フィールド: 完全一致するか、指定した正規表現パターンに一致する必要があります
Arguments 配列: 各引数は、対応するパターンごとに個別にマッチングされます
配列の長さ: 引数の数は、許可リストとユーザー設定で完全に一致している必要があります
特殊文字: $、.、[、]、(、) などの文字は正規表現で特別な意味を持つため、文字どおりに一致させたい場合は \ でエスケープする必要があります

設定オプション

オプション 1: Plugin Store のデフォルト（推奨）

Server Config (JSON) フィールドを空のままにすると、Devin Desktop MCP Plugin Store のデフォルト設定が適用されます。

管理者許可リスト設定:

Server ID: github-mcp-server
Server Config (JSON): (空のままにする)

{}

一致するユーザー設定 (mcp_config.json):

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

これにより、Server ID が plugin store のエントリと一致している限り、ユーザーは任意の有効な設定で GitHub MCPサーバーをインストールできます。

オプション 2: 完全一致の設定

ユーザーが利用する必要のある正確な設定を指定します。ユーザーはこの設定に完全に一致させる必要があります。

管理者許可リスト設定:

Server ID: github-mcp-server
Server Config (JSON):

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}

一致するユーザー設定 (mcp_config.json):

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

ユーザーはこの設定を正確に利用する必要があります。command または args に少しでも違いがあるとブロックされます。env セクションには異なる値を設定できます。

オプション 3: 柔軟な正規表現パターン

セキュリティ制御を維持しながら、ユーザー設定の違いを許容するために正規表現パターンを利用します。

管理者許可リスト設定:

Server ID: python-mcp-server
Server Config (JSON):

{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}

一致するユーザー設定 (mcp_config.json):

{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}

この例では、セキュリティを維持しながら、ユーザーに柔軟性を持たせることができます:

正規表現 /.*\\.py は、/home/user/my_server.py のような任意の Python ファイルパスにマッチします
正規表現 [0-9]+ は、8080 や 3000 のような任意の数値ポートにマッチします
管理者は Python スクリプトのみが実行されるようにしつつ、ユーザーはファイルパスとポートを自由にカスタマイズできます

よく使われる正規表現パターン

Pattern	Matches	Example
`.*`	任意の文字列	`/home/user/script.py`
`[0-9]+`	任意の数字	`8080`, `3000`
`[a-zA-Z0-9_]+`	英数字 + アンダースコア	`api_key_123`
`\\$HOME`	文字列としての `$HOME`	`$HOME` (展開されない)
`\\.py`	文字列としての `.py`	`script.py`
`\\[cli\\]`	文字列としての `[cli]`	`mcp[cli]`

注記

管理者設定ガイドライン

環境変数: env セクションは正規表現によるマッチングの対象外で、ユーザーが自由に設定できます
無効化されたツール: disabledTools 配列は個別に処理され、allowlist のマッチング対象には含まれません
大文字と小文字の区別: すべてのマッチングで大文字と小文字は区別されます
エラー処理: 無効な正規表現パターンはログに記録され、アクセス拒否の原因となります
テスト: 正規表現パターンは慎重にテストしてください。制限が厳しすぎるパターンを設定すると、正当なユースケースまでブロックしてしまう可能性があります

トラブルシューティング

許可リスト登録後にユーザーから MCPサーバーが動作しないという報告があった場合は、次を確認してください。

完全一致を確認: 許可リストのパターンがユーザーの設定と正確に一致していることを確認してください
正規表現のエスケープを確認: 特殊文字はエスケープが必要な場合があります (例: ピリオドをそのまま表す \.)
ログを確認: 無効な正規表現パターンは警告としてログに記録されます
パターンをテスト: 正規表現テスターを使って、パターンが想定どおりに機能することを確認してください

注意: いずれか 1 つのサーバーを許可リストに登録すると、それ以外のすべてのサーバーはチームのメンバーに対して自動的にブロックされます。

一般情報

MCP ツール呼び出しでは、任意のサーバー実装者が作成したコードが実行される可能性があるため、当社は MCP ツール呼び出しの失敗について責任を負いません。改めてお伝えすると:
現在、MCPサーバーのツール、リソース、およびプロンプトをサポートしています。

Devin Desktop

Agent Command Center

リリース

Windsurf プラグイン

アカウント

セキュリティ

Model Context Protocol（MCP）

新しいMCPを追加する

ディープリンクによるワンクリックインストール

MCPツールの設定

mcp_config.json

よく使われるMCPサーバーの使用例

リモート HTTP MCP

設定の補間

管理者向け設定 (チームとEnterprise)

MCP Registry

カスタムレジストリの設定

MCP 許可リスト

MCP チーム設定

サーバーのマッチングの仕組み

設定オプション

よく使われる正規表現パターン

注記

管理者設定ガイドライン

トラブルシューティング

一般情報

​新しいMCPを追加する

​ディープリンクによるワンクリックインストール

​MCPツールの設定

​mcp_config.json

​よく使われるMCPサーバーの使用例

​リモート HTTP MCP

​設定の補間

​管理者向け設定 (チームとEnterprise)

​MCP Registry

​カスタムレジストリの設定

​MCP 許可リスト

MCP チーム設定

​サーバーのマッチングの仕組み

​設定オプション

​よく使われる正規表現パターン

​注記

​管理者設定ガイドライン

​トラブルシューティング

​一般情報

新しいMCPを追加する

ディープリンクによるワンクリックインストール

MCPツールの設定

mcp_config.json

よく使われるMCPサーバーの使用例

リモート HTTP MCP

設定の補間

管理者向け設定 (チームとEnterprise)

MCP Registry

カスタムレジストリの設定

MCP 許可リスト

サーバーのマッチングの仕組み

設定オプション

よく使われる正規表現パターン

注記

管理者設定ガイドライン

トラブルシューティング

一般情報