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.

Open Apps · Technical reference · All app guides