Use Hoko with Claude Code

Connect Claude Code 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 Claude Code

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 Claude Code and revoke the key.

Add it from the terminal

Create the key in Dashboard > Integrations > API Keys, export it in your shell, then run:

claude mcp add --transport http hoko https://mcp.hoko.to --header "Authorization: Bearer <HOKO_API_KEY>"

Run claude mcp list to confirm the server. Do not put the expanded key in shell history or committed settings.

Open Apps · Technical reference · All app guides