How to add MCP servers to Windsurf
Windsurf's agent now runs as Devin Local in Devin Desktop, which manages MCP servers per user and per project. Servers are installed from the Customize → MCPs page or written to mcp_config.json.
Add an MCP server to Windsurf
- 1Windsurf is now Devin Local and reads the same MCP config as Devin CLI.
- 2Open the Customize page, then the MCPs tab, and open the config file, or edit
~/.config/devin/mcp_config.jsondirectly. - 3Paste the server under
mcpServers; remote servers takeurlandtransport. - 4Toggle the server on under This computer in the MCPs tab.
Example: Codebase Memory
{
"mcpServers": {
"codebase-memory-mcp": {
"command": "npx",
"args": [
"-y",
"codebase-memory-mcp"
]
}
}
}Now part of Devin Desktop
- Windsurf's agent runs as Devin Local in Devin Desktop, and its MCP settings live with Devin's.
- Servers can be set per project (
.devin/mcp_config.json), per project but private (mcp_config.local.json) or per user. - The agent asks before calling any MCP tool by default.
- Teams can limit servers to an approved registry and allowlist.
Where Windsurf keeps MCP servers
~/.config/devin/mcp_config.jsonuser.devin/mcp_config.jsonproject
Check it loaded: Customize → MCPs
Limits and settings
- The agent asks for approval before calling any MCP tool by default.
- Teams can restrict servers with an MCP registry and an allowlist in team settings.
- A local override file,
.devin/mcp_config.local.json, stays out of version control.
When a server does not work in Windsurf
- Check the server's state in the "This computer" list on the MCPs page.
- A server marked "Needs authentication" needs you to click Authenticate.
- Make sure the folder you opened is the project whose config you edited.
Windsurf MCP questions
How do I add an MCP server to Windsurf?
Open the Agents window, then Customize → MCPs, and install a server, or add it to ~/.config/devin/mcp_config.json (user) or .devin/mcp_config.json (project).
Does it support remote servers with OAuth?
Yes. Stdio, Streamable HTTP and SSE are supported, with OAuth for each.
Can my team share servers?
Yes. The project file .devin/mcp_config.json is meant to be committed; personal overrides go in mcp_config.local.json.
Can admins limit which servers are allowed?
Yes, through the MCP registry setting and allowlist in team settings.
Popular MCP servers for Windsurf
- 1
Provides a local knowledge graph that connects source code, documentation, and infrastructure to give AI agents structural context.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "codebase-memory-mcp": { "command": "npx", "args": [ "-y", "codebase-memory-mcp" ] } } } - 2
Securely execute LLM-generated code in isolated containers or local Linux and Windows sandboxes across multiple programming languages.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "llm-sandbox": { "command": "uvx", "args": [ "llm-sandbox" ] } } } - 3
Lets an AI client create, inspect, validate, and save editable 3D building scenes, including walls, rooms, doors, and furnishings.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "editor": { "command": "npx", "args": [ "-y", "@pascal-app/mcp" ] } } } - 4
Lets AI agents search, run, and read results from thousands of web scraping and automation Actors on Apify Store.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "apify-mcp-server": { "url": "https://mcp.apify.com/", "transport": "http" } } } - 5
Provides AST-based semantic code search for local repositories using incremental re-indexing and natural language queries.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "cocoindex-code": { "command": "uvx", "args": [ "cocoindex-code" ] } } } - 6
Lets an AI client read and change Google Ads, Reddit Ads and GA4 campaigns, with a preview shown before every change.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "adloop": { "command": "uvx", "args": [ "adloop" ] } } } - 7
An agent meta-harness that provides Claude Code and Codex with specialized agent swarms, self-learning memory, and enterprise security guardrails.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "claude-flow": { "command": "npx", "args": [ "-y", "claude-flow" ] } } } - 8
Enables LLMs to interact with web pages through structured accessibility snapshots using Playwright browser automation.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "playwright-mcp": { "command": "npx", "args": [ "-y", "@playwright/mcp" ] } } } - 9
Allows an AI client to interact with Bitbucket Data Center repositories and code through the Model Context Protocol.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "atlassian-dc-mcp": { "command": "npx", "args": [ "-y", "@atlassian-dc-mcp/bitbucket" ] } } } - 10
Lets an AI agent draw and edit draw.io diagrams on a live browser canvas that you can also edit by hand.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "next-ai-drawio": { "command": "npx", "args": [ "-y", "@next-ai-drawio/mcp-server" ] } } } - 11
Packs a local or remote codebase into a single AI-friendly file with token counts so LLMs and coding agents can read or search it.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "repomix": { "command": "npx", "args": [ "-y", "repomix" ] } } } - 12
Connects AI agents and IDEs to enterprise databases using prebuilt tools or a custom framework for secure, structured queries.
Config for Windsurf
~/.config/devin/mcp_config.json{ "mcpServers": { "mcp-toolbox": { "command": "docker", "args": [ "run", "-i", "--rm", "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0" ] } } }
