Cascade MCP 集成

**MCP (模型上下文协议) **是一种让 LLM 能够访问自定义工具和服务的协议。 MCP 客户端 (此处指 Cascade) 可以向 MCP 服务器发出请求，以访问其提供的工具。 Cascade 现已原生集成 MCP，因此你可以接入自己选择的 MCP 服务器供 Cascade 使用。更多信息请参阅官方 MCP 文档。

Enterprise 用户必须在设置中手动开启此功能

添加新的 MCP 插件

你可以前往 Settings > Tools > Windsurf Settings > Add Server 部分，添加新的 MCP 插件。如需手动配置 MCP 服务器，请在 Cascade 的 MCP 菜单中使用 Open MCP config file，并编辑打开的原始 mcp_config.json 文件。点击某个 MCP 服务器后，只需点击 + Add Server，即可将该服务器及其工具提供给 Cascade 使用。

Cascade 支持 MCP 服务器的三种传输类型：stdio、Streamable HTTP 和 SSE。 Cascade 还支持每种传输类型的 OAuth。对于 http 服务器，URL 应填写为对应端点的地址，格式类似于 https://<your-server-url>/mcp。

添加新的 MCP 插件后，请务必点击刷新按钮。

mcp_config.json

mcp_config.json 文件包含 Cascade 可连接的服务器列表。Cascade 的 Open MCP config file 操作会打开 Devin 配置目录中由 Cortex 管理的该文件：

macOS 和 Linux： ~/.config/devin/mcp_config.json；若已设置 XDG_CONFIG_HOME，则为 $XDG_CONFIG_HOME/devin/mcp_config.json。
Windows： 默认为 %AppData%/devin/mcp_config.json。

请使用该操作为你的安装环境打开的文件，包括使用独立配置目录的构建版本。

编辑器的 MCP 自动发现使用另一个与构建版本相关的文件：稳定版为 ~/.codeium/windsurf/mcp_config.json，Next 版为 ~/.codeium/windsurf-next/mcp_config.json。在编辑器设置中搜索 chat.mcp.discovery.enabled，并启用标记为 Devin configurations 的 windsurf 源，即可从该文件中自动发现服务器。要打开已发现服务器的配置文件，请在 Command Palette 中运行 MCP: List Servers，选择该服务器，然后选择 Show Configuration。此自动发现设置不会改变 Cascade 的 Open MCP config file 操作所打开的、由 Cortex 管理的文件。

下面是一个示例配置，用于为 GitHub 设置一个服务器：

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

请务必为你要使用的服务器提供必填参数和环境变量。你可以参考官方 MCP 服务器参考代码仓库或 OpenTools，查看一些示例服务器。

远程 HTTP MCP

需要注意的是，远程 HTTP MCP 的配置略有不同，需要使用 serverUrl 或 url 字段。以下是 HTTP server 的配置示例：

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

配置插值

Cascade 中由 Cortex 管理的 mcp_config.json 文件 (在 macOS 和 Linux 上默认为 ~/.config/devin/mcp_config.json) 支持在以下字段中对环境变量进行插值：command、args、env、serverUrl、url 和 headers。下面是一个示例配置，其中在 headers 中使用了 AUTH_TOKEN 环境变量。

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

Admin 控制 (团队和企业)

团队 Admin 可以为团队开启或关闭 MCP 访问权限，也可以将已批准的 MCP 服务器加入允许列表，供团队使用：

MCP 团队设置

为你的团队配置 MCP 设置。

只有当你拥有团队 Admin 权限时，上述链接才可用。

默认情况下，团队中的用户可以配置自己的 MCP 服务器。不过，一旦你将哪怕一个 MCP 服务器加入允许列表，所有未列入允许列表的服务器都会被团队屏蔽。

服务器匹配的工作原理

当你将某个 MCP 服务器加入允许列表时，系统会按以下规则使用正则表达式模式匹配：

完整字符串匹配：所有模式都会自动加上锚点 (包装为 ^(?:pattern)$) ，以避免部分匹配
命令字段：必须精确匹配，或匹配你指定的正则表达式模式
参数数组：每个参数都会分别与其对应的模式进行匹配
数组长度：允许列表与用户配置中的参数数量必须完全一致
特殊字符：像 $、.、[、]、(、) 这样的字符在正则表达式中有特殊含义；如果你想按字面匹配，需要使用 \ 对其进行转义

配置选项

选项 1：插件商店默认配置（推荐）

将“服务器配置（JSON）”字段留空，即可使用 Windsurf MCP Plugin Store 中的默认配置。

Admin 允许列表配置：

服务器 ID: github-mcp-server
服务器配置 (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"
      }
    }
  }
}

这样一来，只要服务器 ID 与插件商店中的条目匹配，用户就可以使用任何有效配置来安装 GitHub MCP 服务器。

选项 2：精确匹配配置

提供用户必须使用的精确配置。用户必须与该配置完全一致。

Admin 允许列表配置：

服务器 ID: github-mcp-server
服务器配置 (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：灵活的正则表达式模式

使用正则表达式模式，在保持安全控制的同时允许用户配置存在一定变化。

Admin 允许列表配置：

服务器 ID: python-mcp-server
服务器配置 (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 可匹配任意 Python 文件路径，例如 /home/user/my_server.py
正则表达式 [0-9]+ 可匹配任意数字端口，例如 8080 或 3000
用户可以自定义文件路径和端口，同时管理员可确保仅执行 Python 脚本

常见正则表达式模式

模式	匹配内容	示例
`.*`	任意字符串	`/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]`

注意事项

Admin 配置指南

环境变量：env 部分不进行正则匹配，用户可自由配置
已禁用的工具：disabledTools 数组会单独处理，不属于允许列表匹配范围
区分大小写：所有匹配均区分大小写
错误处理：无效的正则表达式模式会被记录，并导致访问被拒绝
测试：请仔细测试你的正则表达式模式——限制过严的模式可能会拦截正常使用场景

故障排查

如果用户反馈其 MCP 服务器在加入允许列表后无法正常工作：

检查是否完全匹配：确保允许列表模式与用户的配置完全一致
确认正则表达式转义是否正确：特殊字符可能需要转义 (例如，表示字面点号时使用 \.)
查看日志：无效的正则表达式模式会在日志中记录警告
测试模式：使用正则表达式测试工具验证你的模式是否按预期工作

请记住：只要你将任意服务器加入允许列表，所有其他服务器都会自动被阻止，你的团队成员将无法使用它们。

一般信息

由于 MCP 工具调用可能会执行由任意服务器实现者编写的代码，因此，对于 MCP 工具调用失败，我们不承担责任。再次强调：
我们目前支持 MCP 服务器的工具、资源和提示。

Devin Desktop

Agent 指挥中心

发布

Windsurf 插件

账户

安全

Windsurf Cascade MCP 配置

添加新的 MCP 插件

mcp_config.json

远程 HTTP MCP

配置插值

Admin 控制 (团队和企业)

MCP 团队设置

服务器匹配的工作原理

配置选项

常见正则表达式模式

注意事项

Admin 配置指南

故障排查

一般信息

​添加新的 MCP 插件

​mcp_config.json

​远程 HTTP MCP

​配置插值

​Admin 控制 (团队和企业)

MCP 团队设置

​服务器匹配的工作原理

​配置选项

​常见正则表达式模式

​注意事项

​Admin 配置指南

​故障排查

​一般信息

添加新的 MCP 插件

mcp_config.json

远程 HTTP MCP

配置插值

Admin 控制 (团队和企业)

服务器匹配的工作原理

配置选项

常见正则表达式模式

注意事项

Admin 配置指南

故障排查

一般信息