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.