← The KlyHub Journal
GuideMay 13, 2026 · KlyHub Team

Setting up KlyHub in Claude Desktop

Setting up KlyHub in Claude Desktop

This guide walks you through connecting your KlyHub tenant to Claude Desktop over MCP. The full setup takes about five minutes. You'll need:

  • A KlyHub account (sign up at accounts.klyhub.com)
  • Claude Desktop installed (latest version recommended)
  • A few minutes to copy a connector URL and approve OAuth

Once you finish, every Claude conversation has direct access to your KlyHub knowledge base — no copy-paste, no manual context loading.

Step 1: Create your KlyHub tenant

If you haven't already, sign up at accounts.klyhub.com. You'll land in the four-phase intake conversation. Spend ten to twenty minutes answering questions about your company — KlyHub uses your answers to build the initial five-layer ontology (Core, Market, Motion, Operations, Memory).

You can absolutely skip ahead and come back to deepen each layer later. The goal of the first intake is to have enough structure for the AI to be useful in your first conversation.

Step 2: Find your MCP connector URL

In your KlyHub workspace, navigate to Settings → MCP. You'll see a section titled Per-tenant MCP endpoint with a URL that looks like:

mcp.klyhub.com/v1/your-tenant-slug

Copy this URL. It's unique per organization — if you run multiple KlyHub tenants, each has its own connector URL.

Step 3: Add the MCP server to Claude Desktop

Open Claude Desktop. On macOS, the config file lives at:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add KlyHub to the mcpServers block:

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

Save the file and fully restart Claude Desktop (quit, then reopen — a window-close isn't enough to reload the config).

Step 4: Authorize KlyHub

When Claude Desktop reconnects, it will prompt you to sign in to KlyHub via your browser. This is standard OAuth 2.1 with PKCE — you'll be redirected to accounts.klyhub.com, sign in once, approve the tools you want Claude to access, and you're done.

You'll see a confirmation page, and Claude Desktop will be ready to use your KlyHub tenant.

Step 5: Confirm the connection

Open a new conversation in Claude Desktop and type:

What tools do you have available from KlyHub?

Claude should list MCP tools like search_entities, get_entity, and list_motions. If you see them, you're connected.

Try a real question next:

Search KlyHub for our current sales motion and summarize it.

Claude will call the relevant tools, read your knowledge base, and produce a grounded answer. No copy-paste, no context window juggling.

Troubleshooting

"Claude says it can't find any tools from KlyHub"

  • Confirm you fully quit Claude Desktop and reopened it (not just closed the window).
  • Check the config file for valid JSON (trailing commas break it).
  • Open Claude Desktop's developer logs (Help → Developer → Show MCP Logs) and look for connection errors.

"OAuth redirect loops back to KlyHub"

  • Clear your browser's cookies for accounts.klyhub.com and retry.
  • Confirm you're signed in to the correct KlyHub account (the one that owns the tenant whose URL you copied).

"Tools work, but Claude gets quota errors"

  • You may be on Free tier with limited MCP queries per month. Check Settings → Billing in your workspace; upgrade to Solo, Pro, or Team for higher quotas.

"I have multiple KlyHub tenants — how do I switch?"

Add each as a separate MCP server in claude_desktop_config.json:

{
  "mcpServers": {
    "klyhub-acme": { "url": "https://mcp.klyhub.com/v1/acme" },
    "klyhub-otherco": { "url": "https://mcp.klyhub.com/v1/otherco" }
  }
}

Claude treats each as a distinct toolset. You can ask "use klyhub-acme to..." to scope a request.

What to try next

  • Ask Claude to draft a competitive teardown using klyhub tools.
  • Ask Claude to "list all open experiments in the Motion layer and summarize status."
  • Set a recurring weekly "founder briefing" in Claude that pulls fresh highlights from your Memory layer.

Each of these uses your existing Claude subscription — no extra inference cost on KlyHub's side, no new bill to manage.

What about Cursor or ChatGPT?

The setup follows the same shape — find KlyHub's MCP connector URL, add it to your AI client's MCP configuration, authorize via OAuth, confirm. We have client-specific guides at doc.klyhub.com/mcp.

Setting up KlyHub in Claude Desktop · KlyHub