Cursor, VS Code & Windsurf

Connect SuperDocs to your code editor for AI-powered document editing alongside your development workflow.

Cursor

1. Create the config file

Create .cursor/mcp.json in your project root (or global config):

.cursor/mcp.json

{
  "mcpServers": {
    "superdocs": {
      "url": "https://api.superdocs.app/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

2. Restart Cursor

The SuperDocs tools will appear in Cursor’s AI capabilities. Tools load at startup; if the tools panel says “Loading tools” for more than 10 seconds, restart Cursor again.

VS Code

1. Create the config file

VS Code reads MCP servers from a dedicated mcp.json file, not settings.json. Create .vscode/mcp.json in your workspace, or open the user-level file (shared across all workspaces) from the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) with MCP: Open User Configuration. You can also run MCP: Add Server and pick HTTP.

.vscode/mcp.json

{
  "servers": {
    "superdocs": {
      "type": "http",
      "url": "https://api.superdocs.app/mcp/",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

Note the shape: VS Code uses a top-level servers key and a type field ("http" for SuperDocs), unlike Cursor’s mcpServers + transport.

2. Start the server

Save the file, then start the server from the inline hint VS Code shows in mcp.json (or run MCP: List Servers and start it there). The tools appear in Copilot’s agent mode. If SuperDocs doesn’t show up, check the MCP server status in the Output panel, or restart VS Code.

Windsurf

Add the same configuration as Cursor to Windsurf’s MCP settings:

{
  "mcpServers": {
    "superdocs": {
      "url": "https://api.superdocs.app/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

Test your connection

In your editor’s AI chat, type:

“Check the SuperDocs API health”

If configured correctly, the AI will call the health tool and report the API status.

Getting Started

Capabilities

Account & Billing

Core Concepts

Guides

MCP Integration

Errors & Limits

Code Examples

Cursor & VS Code

Cursor, VS Code & Windsurf

Cursor

1. Create the config file

2. Restart Cursor

VS Code

1. Create the config file

2. Start the server

Windsurf

Test your connection

​Cursor, VS Code & Windsurf

​Cursor

​1. Create the config file

​2. Restart Cursor

​VS Code

​1. Create the config file

​2. Start the server

​Windsurf

​Test your connection

Cursor, VS Code & Windsurf

Cursor

1. Create the config file

2. Restart Cursor

VS Code

1. Create the config file

2. Start the server

Windsurf

Test your connection