Skip to documentation

Zentrik MCP

Connect Zentrik MCP

Connect your MCP-capable tool to the same product context your team already keeps in Zentrik.

Use Zentrik MCP when you want your assistant to work from shared product context, not just the contents of the current chat.

The shared values are the same everywhere:

  • Server URL: https://zentrik.ai/mcp
  • Transport: Streamable HTTP when the client asks
  • Auth: browser-based OAuth
  • Scope: one connection = one workspace
  • Open MCP Registry: listed as ai.zentrik/mcp
  • Claude: listed in the Connectors Directory, so connect it from Claude's connector browser

Choose your client

Start with the guide for the tool you are using:

Quick fit:

  • Codex if you want the shortest hosted setup flow
  • Cursor if you want Zentrik context available inside your editor and agent workflows
  • Claude if you want product context while researching, synthesizing, or drafting

If you are in another MCP client, use the same server URL and OAuth flow. If the client only asks for a static bearer token or API key, it is not using the right auth flow for Zentrik MCP.

Once connected

Start with small, evidence-seeking requests:

  • ask what Zentrik already knows about a problem, request, or idea
  • pull the relevant opportunity, idea, or context record before you plan or build
  • add fresh notes from a call, interview, or demo without leaving your current tool
  • run a Study learning loop: find or create a private plan, revise it, monitor de-identified evidence, and generate draft findings while keeping launch and participant distribution in Zentrik
  • review and answer Idea planning questions, maintain Idea taxonomy and Initiative links, and regenerate generated Initiative documents after approved source changes
  • ask what a person or agent changed, with confirmed, no-change, or unverifiable outcomes and explicit coverage

Keep in mind:

  • access is tied to the workspace you approved
  • your role in that workspace still matters
  • if you want a different workspace, reconnect and choose it
  • if newly released tools do not appear, reconnect and approve the current permissions; some clients keep the original grant until you do
  • workspace API keys still work for /external/v1, but not for /mcp
  • every MCP write creates a durable receipt; the same shared boundary covers product writes reused by Zentrik agents
  • use system.get_change_history for product changes and system.get_activity for background jobs
  • change history states whether the requested time and channels are complete, partial, or untracked and summarizes repeated attempts so retry noise does not hide other outcomes
  • MCP and Slack-agent product mutations are fully tracked after receipt collection begins; workspace-agent history is partial; UI, External API, integration, background-job, and portal mutations are untracked

Next:

Troubleshooting

Check these steps against what you see in your workspace. If something differs, note your workspace name and the screen, then contact us.

My MCP client still tries an API key

Update the client configuration to use OAuth discovery. Legacy workspace API keys are still valid for /external/v1, but they are rejected on /mcp.

I do not see Authenticate yet

Wait a few seconds for the client to finish discovery metadata checks. If it still does not appear, reopen the client and check that the server URL is exactly https://zentrik.ai/mcp.

I received insufficient_scope

The token is valid, but it is missing at least one MCP tool scope needed for the current request. Re-run authorization and request the scopes listed in the WWW-Authenticate challenge.

I authenticated into the wrong workspace

Run the OAuth flow again and choose the correct workspace. Zentrik MCP access tokens are bound to one workspace at a time.

Continue from here

Did this guide answer your question?

Your response helps us prioritize missing or unclear documentation.

Still stuck?

Send your question to Zentrik support. This guide will be included automatically.

Ask Zentrik support