Skip to main content

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.

Before you install: enable the MCP in your Klarity workspace. Sign-in will fail until you do.
  • You can switch workspaces later by asking your AI assistant.
  • For other common install issues, see the FAQ.
Cursor supports both install paths. The OAuth path is preferred — Cursor manages the token for you and there’s no key handling.

​
OAuth install (preferred)

In Cursor, open Settings → Tools & MCP → New MCP Server (or edit .cursor/mcp.json directly) and add the Klarity server: 
{
  "mcpServers": {
    "klarity_architect": {
      "type": "http",
      "url": "https://architect-v2-api.klarity.ai/mcp"
    }
  }
}
Save and reload MCP servers. Cursor detects that the server requires OAuth and shows a Connect button in the MCP panel. Click it — you’ll be redirected to Klarity to sign in, and Cursor stores the resulting credentials for you.

​
API key install

Use this for long-running background agents. Generate an API key from Settings → MCP in your Klarity workspace (see Authentication) and add it as a Bearer header: 
{
  "mcpServers": {
    "klarity_architect": {
      "type": "http",
      "url": "https://architect-v2-api.klarity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Reload MCP servers from the settings panel. The Klarity tools should appear in the MCP tool list.
Treat the API key like a password. Don’t commit .cursor/mcp.json with a live key — use a global config (~/.cursor/mcp.json) or env-var reference instead. Rotate keys from Settings → MCP in Klarity if exposed.

​
Verify

In a Cursor chat, ask: 
Search Klarity for AI transformation opportunities across our processes — where could we build skills or deploy agents?
The assistant should call search and return process results from your workspace.