How to add an MCP server to Windsurf (Devin Desktop)

Checked against Windsurf (Devin Desktop)'s documentation on Oct 26, 2026. Commands and config blocks are generated from the same install data as each listing page.

1. 1. Choose a server and see what it needs

   The product name has two parts here, and the scopes you can use depend on whether you work in the app or with the Devin CLI.

   • Playwright MCP: runs locally, no key needed.
   • Figma MCP Server: hosted, connect by URL, no key needed.
   • Firecrawl MCP Server: runs locally, can take FIRECRAWL_API_KEY.
   • Where Windsurf (Devin Desktop) can keep a server: user (the shared mcp_config.json). The Devin CLI adds project and local scopes.

2. 2. Add a local server (Playwright MCP)

   Playwright MCP is described the same way in two places: a Devin CLI command and an entry in mcp_config.json. Use whichever matches how you work.

   devin mcp add -s user playwright-mcp -- npx -y @playwright/mcp@0.0.82

   Copy

   {
     "mcpServers": {
       "playwright-mcp": {
         "command": "npx",
         "args": [
           "-y",
           "@playwright/mcp@0.0.82"
         ]
       }
     }
   }

   Copy

3. 3. Add a remote server (Figma MCP Server)

   Figma MCP Server needs only a url key in the file, or the Devin CLI add command with the URL. Sign-in is handled separately for the CLI.

   devin mcp add -s user figma https://mcp.figma.com/mcp

   Copy

   {
     "mcpServers": {
       "figma": {
         "url": "https://mcp.figma.com/mcp"
       }
     }
   }

   Copy

   • With the Devin CLI, run devin mcp login with the server name if it asks for authentication.

4. 4. Keep API keys out of the file (Firecrawl MCP Server)

   The Cascade agent expands environment references written as ${env:FIRECRAWL_API_KEY}, so the Firecrawl MCP Server entry can hold a reference instead of the key itself.

   {
     "mcpServers": {
       "firecrawl-mcp-server": {
         "command": "npx",
         "args": [
           "-y",
           "firecrawl-mcp@3.34.1"
         ],
         "env": {
           "FIRECRAWL_API_KEY": "${env:FIRECRAWL_API_KEY}"
         }
       }
     }
   }

   Copy

   export FIRECRAWL_API_KEY="paste-your-value-here"

   Copy

   • Cascade config accepts ${env:VAR} and ${file:/path} in command, args, env, url and headers; an unset variable becomes an empty string.
   • Cascade expands ${env:NAME} in the config, so the value stays in your environment; an unset variable becomes an empty string.
   • FIRECRAWL_API_KEY (optional): Your API key for Firecrawl.

5. 5. Restart or reload if the server does not appear

   The docs give little guidance on refreshing, so this step is mainly about team allowlists and the rename that affects which agent reads which config.

   • The docs do not say whether a refresh or restart is needed.
   • Team admins can allowlist servers; once any server is allowlisted all others are blocked.
   • Windsurf was renamed Devin Desktop. The Cascade page covers only the legacy Cascade agent; the Devin Local agent reads the Devin CLI's config.

devin mcp list