Use Hoko with Windsurf

Connect Windsurf through its manual remote MCP setup.

Before you start

Create a scoped API key in Dashboard > Integrations > API Keys. Keep it in the host's secret store and never commit it.

Configure Windsurf

Add the Hoko MCP server at https://mcp.hoko.to with Authorization Bearer <HOKO_API_KEY>. Reload the host after saving.

Verify the connection

Run a read-only links operation and confirm the selected workspace before any write.

Fix common issues

  • A 401 means an invalid key.
  • A 403 means a missing scope.
  • A 429 requires waiting for Retry-After.
  • Check the host's current MCP settings when support varies by release.

Disconnect

Remove Hoko from Windsurf and revoke the key.

Add it to Windsurf

Open Windsurf MCP settings and add a remote server. Its documented fields are:

{
  "mcpServers": {
    "hoko": {
      "serverUrl": "https://mcp.hoko.to",
      "headers": { "Authorization": "Bearer ${env:HOKO_API_KEY}" }
    }
  }
}

The usual file is ~/.codeium/windsurf/mcp_config.json. Hoko has not verified a Windsurf host round trip.

Open Apps · Technical reference · All app guides