**Source:** https://heykiku.com/help/mcp-connect

# Connect your MCP client to heykiku

heykiku's MCP server uses Streamable HTTP and OAuth to [connect your AI client to your knowledge base](https://heykiku.com/features/connect). The three clients heykiku tests against are Claude Code, Cursor, and Claude Desktop. If you haven't yet, read [how the MCP server works](https://heykiku.com/help/mcp-getting-started) before wiring up a client.

MCP access is included with the Bloom plan and uses read-only scope. Your workspace MCP URL is shown on the Connected apps page.

## Before you start

- Your workspace must be on the Bloom plan.
- Go to Account → Connected apps to find your workspace MCP URL.
- The URL is workspace-scoped. A key or OAuth token from workspace A does not work in workspace B.

## Set up Claude Code

1. Go to Account → Connected apps and copy your workspace MCP URL.
2. In your terminal, run:

```
claude mcp add --transport http heykiku <your-workspace-mcp-url>
```

3. Open Claude Code and type `/mcp` to complete OAuth authentication. A browser window will open asking you to approve `read` access for the workspace.
4. Once approved, Claude Code lists heykiku in its MCP tools.

## Set up Cursor

1. Go to Account → Connected apps.
2. Click the **Add to Cursor** deep link to open the Cursor MCP installer, which pre-fills the server URL and starts the OAuth flow automatically.
3. Alternatively, add the server manually in Cursor's MCP settings using the JSON config shown on the Connected apps page:

```json
{ "type": "http", "url": "<your-workspace-mcp-url>" }
```

4. Authenticate with OAuth when Cursor prompts for the heykiku consent flow.

## Set up Claude Desktop

1. Go to Account → Connected apps and copy your workspace MCP URL.
2. Open Claude Desktop settings and add a new MCP server with that URL.
3. Complete the OAuth flow when Claude Desktop opens the heykiku consent page.

## Try a first prompt

Ask a question that belongs in your agency knowledge base:

- "Ask kiku what our onboarding checklist says about kickoff calls."
- "Search heykiku for the latest Acme brand guidelines."
- "List the folders I can access."

Document tools are read-only. Your client only receives results your heykiku role can see. It cannot upload, edit, approve, or delete knowledge through MCP. `flag_kiku` records review metadata for Questions to answer. Use the heykiku web app for uploads and workspace changes.

## Revoke access

To disconnect an OAuth client, go to Account → Connected apps and remove the connection. For REST API keys (not MCP), go to Account → API keys. Static bearer tokens are for the REST API only — not MCP.

## Related terms

- [Agency Tech Stack](https://heykiku.com/glossary/agency-tech-stack)
- [Agency Knowledge Base](https://heykiku.com/glossary/agency-knowledge-base)
- [Single Source of Truth](https://heykiku.com/glossary/single-source-of-truth)