Connect Claude Desktop

Claude Desktop has first-class MCP support out of the box. This is the canonical setup guide — three steps: authorize, edit the config, restart.

Prerequisites

• A KlyHub account with at least one workspace.
• The latest version of Claude Desktop. Claude Desktop is available for macOS and Windows; if your operating system is not supported, use Cursor or a custom integration instead.
• About five minutes.

Step 1 — Authorize Claude Desktop

From inside your KlyHub workspace:

1. Open Settings → MCP clients.
2. Click Connect Claude Desktop.
3. KlyHub redirects you to accounts.klyhub.com to approve the OAuth scopes (read + write, scoped to this tenant only).
4. After approval you land back on a page with a JSON snippet — keep this tab open for Step 2.

Step 2 — Edit the config

Open Claude Desktop's MCP config file. The path depends on your operating system:

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%\Claude\claude_desktop_config.json

If the file does not exist, create it. Paste in the snippet KlyHub gave you:

{
  "mcpServers": {
    "klyhub": {
      "url": "https://mcp.klyhub.com/v1/your-tenant-slug"
    }
  }
}

Replace your-tenant-slug with the slug you picked when you created your workspace (you can see it in the URL bar inside KlyHub, e.g. app.klyhub.com/your-tenant-slug/...).

If you already have other mcpServers configured, add klyhub as a sibling key — don't overwrite them.

Step 3 — Restart Claude Desktop

Fully quit Claude Desktop — not just close the window:

• macOS — press Cmd+Q, or choose Claude → Quit Claude from the menu bar.
• Windows — right-click the Claude icon in the system tray and choose Quit.

Reopen Claude Desktop. The klyhub server should appear in the tools panel at the bottom of the conversation view.

Verify

Ask Claude something specific to your workspace:

"Using the klyhub tools, list the three most recently updated entries in my Market layer."

Claude should call the klyhub.query tool, return JSON, and summarize it. If you see "no tools available," double-check the JSON path and that the file is valid (Claude Desktop logs MCP errors to its developer console).

Troubleshooting

If your AI client lost its connection — for example, you see repeated "Authorization required" prompts — your access token has likely expired. The fix is to disconnect and reconnect from Settings → MCP clients.

For the full walkthrough, see MCP connection lost or token expired.

A couple of quick checks for other symptoms:

• No tools appear — confirm the URL in the config matches mcp.klyhub.com/v1/<your-slug> exactly, including HTTPS and the /v1/ prefix.
• Tools appear but every call returns 403 — your tenant might be in read-only state (failed billing or scheduled deletion). Check the banner at the top of your KlyHub workspace.

For other clients, see Cursor, ChatGPT, or Custom integrations.