How to Set Up MCP Servers in Windsurf

Why Windsurf + MCP

Windsurf is a full-stack AI coding IDE that supports the Model Context Protocol natively. MCP servers give Windsurf's AI access to external data: databases, APIs, internal tools, monitoring dashboards. Instead of copying context into chat, your AI pulls it directly.

This tutorial walks through connecting any MCP server to Windsurf, from config file to working tool calls.

Prerequisites

• Windsurf installed (any recent version with MCP support)
• An MCP server endpoint (we'll use DataFaucet as an example, but any SSE-compatible server works)
• 5 minutes

Step 1: Open MCP Settings

In Windsurf, open the command palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux) and search for:

MCP: Configure Servers

This opens your MCP configuration file. If it doesn't exist yet, Windsurf creates it automatically.

Step 2: Add Your Server

Add an entry to the mcpServers object:

{
  "mcpServers": {
    "my-server": {
      "type": "sse",
      "url": "https://datafaucet.dev/api/mcp/YOUR_SERVER_ID/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_SERVER_ID and YOUR_API_KEY with values from your DataFaucet dashboard (or whatever MCP server you're connecting).

Local servers (stdio transport)

If you're running a local MCP server (like one built with the MCP SDK), use stdio transport instead:

{
  "mcpServers": {
    "local-tools": {
      "type": "stdio",
      "command": "node",
      "args": ["path/to/your/server.js"]
    }
  }
}

Step 3: Reload

After saving the config, Windsurf auto-detects the change and connects to your server. You'll see the server name appear in the MCP panel. If it doesn't connect immediately, restart Windsurf.

Step 4: Verify Tools Are Available

Open a new AI chat in Windsurf and type something that would trigger your server's tools. For example, if you connected a Notion MCP server:

Search my Notion workspace for "Q2 roadmap"

Windsurf's AI will show the MCP tool call in the response, including the request and response data.

Step 5: Use in Workflows

MCP tools work anywhere Windsurf's AI operates:

• Chat: Ask questions that pull live data
• Inline edits: Reference external context while editing code
• Agent mode: Multi-step tasks that query APIs as part of the workflow

Example: Database queries while coding

Connect a PostgreSQL MCP server, then ask Windsurf to write a migration based on your current schema. It reads the schema directly instead of you pasting it in.

Example: Monitoring during debugging

Connect a Datadog or Grafana MCP server. When debugging a performance issue, Windsurf pulls metrics and logs without leaving the editor.

Adding Multiple Servers

Stack as many servers as you need:

{
  "mcpServers": {
    "notion": {
      "type": "sse",
      "url": "https://datafaucet.dev/api/mcp/notion-id/sse",
      "headers": { "Authorization": "Bearer key1" }
    },
    "stripe": {
      "type": "sse",
      "url": "https://datafaucet.dev/api/mcp/stripe-id/sse",
      "headers": { "Authorization": "Bearer key2" }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

Each server's tools are available independently. Windsurf routes calls to the right server based on which tool is invoked.

Troubleshooting

Server shows "disconnected": Check the URL is reachable. For SSE servers, try opening the URL in a browser. You should see an SSE event stream.

Tools not appearing: Make sure the server implements the MCP tools/list method. DataFaucet servers do this automatically.

Auth errors: Verify your API key is correct and hasn't expired. For DataFaucet servers, check your dashboard for the current key.

Timeout on connect: Some corporate networks block SSE connections. Try using a local proxy or ask your network admin to whitelist the endpoint.

Generate a Server with DataFaucet

Don't have an MCP server yet? Create one in 60 seconds:

1. Go to DataFaucet
2. Paste any URL (your internal tool, a SaaS app, an API)
3. Browse for 30 seconds while DataFaucet captures API traffic
4. Click Deploy

You get an SSE endpoint ready to paste into your Windsurf config. No code, no hosting, no API docs to read.

What's Next

• Connect more tools: every API your team uses can become an MCP server
• Check the MCP server gallery for pre-built examples
• Read MCP vs REST APIs to understand when MCP makes sense