Connect to Windsurf

Prerequisites

Windsurf installed (codeium.com/windsurf)
A V5 bearer token — get one from POST /admin/tokens/issue or ask Mishaal

Setup

Open Windsurf MCP settings

In Windsurf, open Settings → MCP Servers (or edit .windsurf/mcp.json in your project).

Add the V5 server

.windsurf/mcp.json

{
  "mcpServers": {
    "ascend": {
      "serverUrl": "https://ascend-gateway-v5.ascendgtm.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Or via environment variable:

.windsurf/mcp.json

{
  "mcpServers": {
    "ascend": {
      "serverUrl": "https://ascend-gateway-v5.ascendgtm.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${ASCEND_GATEWAY_TOKEN}"
      }
    }
  }
}

Set your token

export ASCEND_GATEWAY_TOKEN=<your-token>

Add to ~/.zprofile or ~/.bashrc to persist.

Verify in Cascade

Open Cascade (Windsurf’s AI panel) and ask: “How many HubSpot contacts do I have?”Cascade should call hubspot_crm and return a count.

Troubleshooting

Tools not showing in Cascade — Restart Windsurf after editing .windsurf/mcp.json. Windsurf loads MCP servers at startup. AUTH_FAILED — Token is invalid or expired. Issue a new one at /admin/tokens/issue. Tools show but calls fail — Verify the HubSpot/Google/Salesforce OAuth token for your tenant is present in KV. Run search_knowledge with query: "token status" to check.

Connect to Slack Connect to Codex CLI

Get started

Connect your AI tool

Advanced

Prerequisites

Setup

Troubleshooting

​Prerequisites

​Setup

​Troubleshooting

Prerequisites

Setup

Troubleshooting