> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcpcore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect your MCPCore server to Windsurf (by Codeium) using the mcp-remote bridge.

## Prerequisites

* [Windsurf](https://codeium.com/windsurf) installed
* A MCPCore server with at least one tool
* The config snippet from your server's **Integration** tab

***

## Step 1 — Get your config snippet

Open your server's detail page, click the **Integration** tab, and select **Windsurf**. Copy the generated snippet.

```json theme={null}
{
  "mcpServers": {
    "your-server-code": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-subdomain.mcpcore.io/mcp"]
    }
  }
}
```

For API Key mode:

```json theme={null}
{
  "mcpServers": {
    "your-server-code": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@latest",
        "https://your-subdomain.mcpcore.io/mcp",
        "--header", "Authorization: Bearer <your-api-key>"
      ]
    }
  }
}
```

***

## Step 2 — Open the config file

**macOS / Linux:**

```
~/.codeium/windsurf/mcp_config.json
```

**Windows:**

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

Create the file if it doesn't exist.

***

## Step 3 — Merge the snippet

Paste your server entry into the `mcpServers` object.

***

## Step 4 — Restart Windsurf

Save the config and restart Windsurf (or use **Reload MCP** from the Command Palette if available).

***

## Step 5 — Verify

Open Windsurf's **Cascade** AI panel and ask it to use one of your tools.

***

## Troubleshooting

| Problem             | Solution                                                     |
| ------------------- | ------------------------------------------------------------ |
| Tools not appearing | Check that the config file path is correct and JSON is valid |
| `401 Unauthorized`  | Verify the `--header` argument                               |
| Tool calls fail     | Check [Traffic Logs](/observability/traffic-logs)            |