Windsurf

Windsurf proxies HTTP MCP servers through the mcp-remote bridge, so it connects to the hosted Keupera server. Authorize with OAuth (browser sign-in) or an API key.

mcp-remote runs via npx, so you need Node.js installed. No global install is required.

Add the server

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "keupera": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.keupera.com/mcp"] }
  }
}

Authorize

Click Refresh in the MCP panel. On first connect, mcp-remote opens your browser to sign in to Keupera and Allow access.

Option B — API key

{
  "mcpServers": {
    "keupera": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.keupera.com/mcp", "--header", "Authorization: Bearer sk_live_your_key"]
    }
  }
}

Get your key from Settings → API Keys in the dashboard.

Verify and use

Click Refresh in the MCP panel and confirm keupera is connected, then ask, for example: “List my tracked keywords by opportunity and draft an article for the top one.” Windsurf MCP docs →

Troubleshooting

Server won't start

Confirm Node.js is installed (node --version) and the JSON is valid, then click Refresh in the MCP panel.

Kiro Authentication

Overview

Connect

Guides

Reference

Option B — API key

Verify and use

Troubleshooting

​Option A — OAuth (sign in)

​Option B — API key

​Verify and use

​Troubleshooting

Option A — OAuth (sign in)

Option B — API key

Verify and use

Troubleshooting