Как добавить MCP-серверы в Windsurf (mcp_config.json)

Настройка локальных и удалённых MCP-серверов для агента Cascade в Windsurf через mcp_config.json: где лежит файл, serverUrl для удалённых серверов и отключение инструментов.

1. Откройте mcp_config.json

В панели Cascade нажмите меню … (Actions) в правом верхнем углу и выберите Open MCP config file в разделе MCPs. Согласно актуальной документации, файл находится в ~/.config/devin/mcp_config.json в macOS и Linux и в %APPDATA%\devin\mcp_config.json в Windows (Windsurf теперь входит в Devin Desktop; старые версии Windsurf использовали ~/.codeium/windsurf/mcp_config.json). Через меню всегда открывается нужный файл.

2. Добавьте локальный (stdio) сервер

Добавьте запись в mcpServers — в том же формате, что и для Claude Desktop и Cursor:

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

3. Добавьте удалённый сервер

Удалённые HTTP-серверы указываются через serverUrl (или url) вместо команды. Пример с бесплатным сервером Socketlist:

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

Если серверу нужен API-ключ, добавьте объект headers.

4. Не храните секреты в файле

Конфигурация поддерживает ${env:VAR_NAME} и ${file:/path/to/file} в полях command, args, env, serverUrl, url и headers.

5. Включайте и отключайте серверы и инструменты

В разделе MCPs меню Actions у каждого сервера есть переключатель. Чтобы скрыть отдельные инструменты, добавьте "disabledTools": ["tool_name"] в запись сервера. Cascade может использовать не более 100 инструментов одновременно.

Примечания

Всё это относится к агенту Cascade. Новый агент Devin Local хранит MCP-серверы в конфигурации Devin CLI. Источник: официальная документация Cascade по MCP.