If your question isn’t here, reach out to hello@klarity.ai.Documentation Index
Fetch the complete documentation index at: https://developers.klarity.ai/llms.txt
Use this file to discover all available pages before exploring further.
I keep getting a sign-in or auth error. What's wrong?
I keep getting a sign-in or auth error. What's wrong?
The most common cause is that the MCP hasn’t been enabled in your Klarity workspace yet. Both OAuth and API-key auth require this one-time setup:
- Log in to Klarity in a browser.
- Go to Settings → MCP.
- Pick the workspace you want to expose and complete the in-app setup.
My organization doesn't have Klarity yet. Can I use this?
My organization doesn't have Klarity yet. Can I use this?
Not directly. Klarity is a commercial service — you need an active workspace and a provisioned user account to use the MCP. Contact hello@klarity.ai to talk about access.
The connector says my org hasn't approved it.
The connector says my org hasn't approved it.
Your organization’s Klarity workspace admin needs to approve the Klarity connector (Claude) or app (ChatGPT) before users can sign in. Ask your admin, or have them reach out to hello@klarity.ai.
How do I switch between Klarity workspaces from inside my assistant?
How do I switch between Klarity workspaces from inside my assistant?
Ask your assistant to switch — for example, “switch my Klarity workspace to EMEA-ops.” It will call
switch_mcp_workspace (the only write tool exposed in production). This only affects the active session; it does not change your default workspace in Klarity.See Workspace tools for the details.How do I rotate or revoke an API key?
How do I rotate or revoke an API key?
Go to Settings → MCP in your Klarity workspace. You can view, disable, or rotate existing keys from the same screen where you generated them.If you suspect a key has been exposed, revoke it immediately, generate a new one, and update your client configuration. See Authentication → Keep keys safe.
How do I confirm the MCP is connected?
How do I confirm the MCP is connected?
In your AI client, ask something like:If the assistant calls the
search tool and returns processes from your workspace, you’re connected. If it falls back to generic answers or says it has no access to Klarity, the install hasn’t completed — re-check the install steps for your client.Can I create or edit processes through the MCP?
Can I create or edit processes through the MCP?
No. Every tool in production is read-only with one exception:
switch_mcp_workspace. All process, artifact, and graph edits happen in the Klarity Architect UI. See Limitations.The assistant says 'no evidence found in the workspace.' Is something broken?
The assistant says 'no evidence found in the workspace.' Is something broken?
Usually not. That response means the workspace doesn’t yet have captured data covering the question — typically a capture gap, not an MCP bug. The gap itself is useful: it tells you what to capture next.If the question should have evidence and the assistant can’t find it, try refining the query — single searches miss, and processes use organization-specific names. See Operating principles.
Which client should I use?
Which client should I use?
Any MCP-compatible client works. Use the install page that matches what you have today: