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.