# Connect Windsurf to NocoDB

> Part of the NocoDB documentation (MCP Server > Connect). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/mcp/windsurf
Last updated: 2026-10-21

Connect Windsurf to NocoDB with the NocoDB MCP server: add the JSON block from your MCP connection to the Cascade MCP plugins in Windsurf Settings.

Windsurf works with NocoDB through the NocoDB MCP server. You paste the JSON block from your MCP connection in NocoDB into the Cascade MCP plugins of Windsurf.

|                     | Windsurf                                                               |
| ------------------- | ---------------------------------------------------------------------- |
| **Type**            | Desktop                                                                |
| **How it connects** | JSON block, over HTTP                                                  |
| **You need**        | An [MCP connection](/docs/mcp/connections#server-configuration-nocodb) |

## Set up Windsurf

Windsurf connects directly to the MCP endpoint over HTTP. Thus it does not need the `mcp-remote` bridge. Its JSON block carries the endpoint URL and the token header.

1. Open **Windsurf Settings** (`⌘+,`).
2. In the **Cascade** section > `Plugins (MCP Server)`, click **Manage Plugins**.
3. Paste the JSON block that you copied [here](/docs/mcp/connections#server-configuration-nocodb).
4. Save.

<img alt="Windsurf MCP Settings" src={__img0} placeholder="blur" />

<img alt="Windsurf MCP Settings" src={__img1} placeholder="blur" />

### Configuration example

Cursor and Windsurf connect over HTTP, so their block carries the endpoint URL and the token header. Cursor names the address `url`, and Windsurf names it `serverUrl`:

```json
{
  "mcpServers": {
    "NocoDB MCP": {
      "url": "https://your-domain.com/mcp/<ncId>",
      "headers": { "x-api-key": "<ncToken>" }
    }
  }
}
```

<Callout type="warning">
  The JSON block contains your MCP token, which gives access to your NocoDB projects. Do not put it in source control.
</Callout>

## Related

* [Connections and access](/docs/mcp/connections)
* [What the assistant can do](/docs/mcp#what-you-can-do)
* [All MCP clients](/docs/mcp#pick-your-client)

---

## Related pages

- [Connect Claude to NocoDB](https://nocodb.com/docs/mcp/claude.md): Connect Claude to NocoDB from the Claude Connectors directory with OAuth, add a custom connector for self-hosted NocoDB, or set up Claude Desktop manually.
- [Connect Claude Code to NocoDB](https://nocodb.com/docs/mcp/claude-code.md): Connect Claude Code to NocoDB with one command: add https://app.nocodb.com/mcp as an HTTP MCP server and sign in with OAuth, or use a token.
- [Connect ChatGPT to NocoDB](https://nocodb.com/docs/mcp/chatgpt.md): Connect ChatGPT to NocoDB with the NocoDB MCP server: create a connector with the URL https://app.nocodb.com/mcp and sign in to NocoDB with OAuth.
- [Connect Codex to NocoDB](https://nocodb.com/docs/mcp/codex.md): Connect the Codex CLI to NocoDB with the NocoDB MCP server: add the TOML block from your MCP connection to the Codex config file, then run codex mcp list.
- [Connect Cursor to NocoDB](https://nocodb.com/docs/mcp/cursor.md): Connect Cursor to NocoDB with the NocoDB MCP server: add the JSON block from your MCP connection as a custom MCP server in the MCP tab of Cursor Settings.
- [Connect AntiGravity to NocoDB](https://nocodb.com/docs/mcp/antigravity.md): Connect AntiGravity to NocoDB with the NocoDB MCP server: paste the JSON block from your MCP connection into the raw MCP config of the agent window.