---
title: "Windsurf / Devin Desktop MCP config: file path, key, example · DotsAgent"
description: "Add MCP servers to Windsurf / Devin Desktop from Cognition: where the config file lives, the top-level key and format, remote OAuth support and a sample config."
url: https://dotsagent.io/mcp/clients/windsurf
---

Cognition

# Add MCP servers to Windsurf / Devin Desktop

Windsurf is now Devin Desktop. It reads mcp_config.json, and its official docs disagree on where that file lives.

- **macOS**: `~/.config/devin/mcp_config.json (current Cascade doc); legacy ~/.codeium/windsurf/mcp_config.json; FAQ says ~/.codeium/mcp_config.json`
- **Windows**: `%APPDATA%\devin\mcp_config.json (current Cascade doc)`
- **Linux**: `~/.config/devin/mcp_config.json (or $XDG_CONFIG_HOME/devin/mcp_config.json)`
- **Project file**: `.devin/mcp_config.json (Devin CLI / Devin Local project scope)`
- **Top-level key**: `mcpServers`
- **Format**: json
- **OAuth for remote servers**: 

## Example config

This example adds GitHub's hosted server and Playwright as a local server, in the shape this client expects.

`.devin/mcp_config.json`

```
{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "transport": "http"
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}
```

`shell`

```
devin mcp add github https://api.githubcopilot.com/mcp/
devin mcp add playwright -- npx @playwright/mcp@latest
```

## Notes and quirks

- Windsurf was renamed Devin Desktop on 2026-06-02, and Devin Local is now the default agent.
- The Cascade docs give ~/.config/devin/mcp_config.json, the FAQ says ~/.codeium/mcp_config.json, and the legacy path is ~/.codeium/windsurf/mcp_config.json. Check which one your build reads.
- Devin Local adds project scopes in .devin/mcp_config.json and .devin/mcp_config.local.json.
- Remote entries take url, transport http or sse, headers, oauthClientId, oauthClientSecret and oauthResource; Cascade also accepts serverUrl.
- Values can use ${env:VAR} and ${file:path}, and Cascade caps you at 100 tools.

[Build a Windsurf / Devin Desktop config →](https://dotsagent.io/mcp/config#client=windsurf)

## Other clients

[Claude Desktop](https://dotsagent.io/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/mcp/clients/vscode-copilot)

[Zed](https://dotsagent.io/mcp/clients/zed)

[OpenAI Codex CLI](https://dotsagent.io/mcp/clients/codex-cli)

[Gemini CLI](https://dotsagent.io/mcp/clients/gemini-cli)

[ChatGPT](https://dotsagent.io/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/mcp/clients/openclaw)

[Cline](https://dotsagent.io/mcp/clients/cline)

[Continue](https://dotsagent.io/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/mcp/clients/jetbrains-ai)

## Sources

1. [docs.windsurf.com](https://docs.windsurf.com/windsurf/cascade/mcp)/windsurf/cascade/mcp
2. [docs.devin.ai](https://docs.devin.ai/desktop/devin-desktop-faq)/desktop/devin-desktop-faq
3. [docs.devin.ai](https://docs.devin.ai/cli/extensibility/mcp/configuration.md)/cli/extensibility/mcp/configuration.md
4. [code.visualstudio.com](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)/docs/copilot/customization/mcp-servers

Independent reference for people who build AI agents. Not affiliated with any vendor named here.

© 2026 DotsAgent · Facts checked October 1, 2026