Use Hoko with Cursor
Connect Cursor through its remote MCP server.
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 Cursor
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 Cursor and revoke the key.
Add it from project settings
Create .cursor/mcp.json and add this entry. Cursor reads the key from the environment-backed header:
{
"mcpServers": {
"hoko": {
"url": "https://mcp.hoko.to",
"headers": { "Authorization": "Bearer ${env:HOKO_API_KEY}" }
}
}
}
Reload MCP and run a read-only links operation.