Skip to main content

Connecting to Windsurf

Integrate your Reeva MCP servers with Windsurf IDE for enhanced AI development.

Quick Tip

For ready-to-use configuration snippets, navigate to your server in the Reeva Dashboard and expand the "Connect to MCP Clients" section.

Step-by-Step Setup​

1. Get Your Server Configuration​

From the Reeva Dashboard:

  1. Go to Servers → Select your server
  2. Expand the "Connect to MCP Clients" section
  3. Copy the configuration snippet

Your configuration looks like:

{
  "mcpServers": {
    "my-server-name": {
      "url": "https://api.joinreeva.com/mcp/server_xxxxx",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with an API key linked to your server (found in the Linked API Keys section).

2. Open Windsurf MCP Settings​

  1. Click the gear icon (⚙️) in the bottom left corner of Windsurf
  2. Select "Settings"
  3. Search for "MCP" in the settings search bar
  4. Click "Edit in settings.json" under MCP Servers

Alternatively, open the config file directly:

Mac/Linux:

~/.codeium/windsurf/mcp_config.json

Windows:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

3. Add Your Server Configuration​

Paste the configuration from the dashboard, or add manually:

{
  "mcpServers": {
    "reeva": {
      "url": "https://api.joinreeva.com/mcp/server_YOUR_SERVER_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

4. Save and Restart​

  1. Save the configuration file
  2. Completely quit Windsurf
  3. Reopen Windsurf

5. Verify Connection​

Test in Windsurf's AI chat:

Search the web for "TypeScript 5.3 features"

The AI should use your Reeva tools automatically.

Configuration Examples​

Single Server​

{
  "mcpServers": {
    "reeva": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "headers": {
        "Authorization": "Bearer your_api_key_here"
      }
    }
  }
}

Multiple Servers​

{
  "mcpServers": {
    "reeva-research": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "headers": {
        "Authorization": "Bearer api_key_for_research"
      }
    },
    "reeva-productivity": {
      "url": "https://api.joinreeva.com/mcp/server_xyz789",
      "headers": {
        "Authorization": "Bearer api_key_for_productivity"
      }
    }
  }
}

With Descriptive Names​

Use names that indicate what the server does:

{
  "mcpServers": {
    "web-scraping": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    },
    "notion-integration": {
      "url": "https://api.joinreeva.com/mcp/server_xyz789",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Troubleshooting​

Server Not Appearing​

Problem: Server doesn't show up after restart.

Solutions:

  1. ✅ Verify JSON syntax is valid (no trailing commas, proper quotes)
  2. ✅ Check API key has no extra spaces
  3. ✅ Ensure the Authorization header uses Bearer prefix (with a space after Bearer)
  4. ✅ Verify config file location is correct
  5. ✅ Completely restart Windsurf (not just reload)

Connection Issues​

Problem: Can't connect to server

Solutions:

  • ✅ Verify API key is correct and formatted as Bearer YOUR_KEY
  • ✅ Check server is active in dashboard
  • ✅ Restart Windsurf completely
  • ✅ Check Windsurf MCP logs (View → Output → select "MCP")

"Authentication Failed"​

Problem: Error about authentication when using tools.

Solutions:

  1. ✅ Verify your API key format: Authorization: Bearer YOUR_KEY
  2. ✅ Check key hasn't been revoked in dashboard
  3. ✅ Ensure API key is linked to the correct server
  4. ✅ Generate a new API key if needed

Tools Not Working​

Problem: AI can't access tools

Solutions:

  • ✅ Ensure server has custom tools added
  • ✅ Test in Reeva Chat first
  • ✅ Update Windsurf to latest version
  • ✅ Check credits balance in dashboard

See Also​