> ## Documentation Index
> Fetch the complete documentation index at: https://klarityai-add-transformation-playbook.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Pick a client, authenticate, and ask your first question.

<Info>
  You need an active Klarity workspace and a user account. If you're not sure whether your organization has one, contact [hello@klarity.ai](mailto:hello@klarity.ai).
</Info>

<Steps>
  <Step title="Pick your client">
    Klarity MCP works with any MCP-compatible client. Use the install page that matches yours.

    <Columns cols={2}>
      <Card title="Claude" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/claude.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=954a68879b7fb2cad9cbfe743f176bc8" href="/install/claude" width="16" height="16" data-path="images/icons/claude.svg">Anthropic assistant</Card>
      <Card title="Claude Code" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/claude.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=954a68879b7fb2cad9cbfe743f176bc8" href="/install/claude-code" width="16" height="16" data-path="images/icons/claude.svg">Anthropic CLI</Card>
      <Card title="ChatGPT" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/openai.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=d073a51d5219ba50a9a65c3d8307378d" href="/install/chatgpt" width="16" height="16" data-path="images/icons/openai.svg">OpenAI assistant</Card>
      <Card title="Codex" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/codex.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=7f39438e9dbca212b871a24f09401bcf" href="/install/codex" width="16" height="16" data-path="images/icons/codex.svg">OpenAI CLI</Card>
      <Card title="Cursor" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/cursor.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=34c35bac915d6b016f048b6dc03e650d" href="/install/cursor" width="16" height="16" data-path="images/icons/cursor.svg">IDE</Card>
      <Card title="Gemini CLI" icon="https://mintcdn.com/klarityai-add-transformation-playbook/kWsntikZi6DFW0sT/images/icons/gemini.svg?fit=max&auto=format&n=kWsntikZi6DFW0sT&q=85&s=77af3d36db7e3aaf30f67b8c2160eeaf" href="/install/gemini-cli" width="16" height="16" data-path="images/icons/gemini.svg">Google CLI</Card>
      <Card title="GitHub Copilot" icon="github" href="/install/github-copilot">GitHub CLI and app</Card>
    </Columns>
  </Step>

  <Step title="Authenticate">
    Two methods are supported:

    * **OAuth** — preferred where the client supports it. Sign in to Klarity from the client; no key handling.
    * **API key** — used in alpha clients and as a fallback. Generate a key from `Settings → MCP` in your Klarity workspace and pass it as a `Bearer` token.

    See [Authentication](/authentication) for the full setup.
  </Step>

  <Step title="Ask your first question">
    Start with something concrete from your workspace. The MCP is most useful when the question references *your* processes, systems, or teams.

    Examples:

    * "How does our vendor onboarding process work today?"
    * "What changed in our month-end close in the last 30 days?"
    * "Which processes depend on System X?"
    * "Find the highest-leverage automation opportunities in our P2P value stream."

    See [How-to guides](/guides/process-performer) for end-to-end recipes.
  </Step>
</Steps>

## What to expect

The first time the assistant calls a Klarity tool, it will prompt you to authenticate (OAuth) or read your configured API key. After that, the assistant chains MCP tools in the background — searching the Process Index, fetching specific processes, pulling observations, and drilling into the activity timelines behind those observations — and answers in business language, citing the workspace evidence behind each claim.

If the assistant cannot find evidence for a claim in your workspace, it should say so plainly. That gap is itself useful information.

## Next steps

<Columns cols={2}>
  <Card title="Read the concepts" icon="book-open" href="/concepts/discover-structure-improve">
    The Discover → Structure → Improve loop, and the three intelligence layers.
  </Card>

  <Card title="Browse the tools" icon="screwdriver-wrench" href="/tools/overview">
    Every tool the MCP exposes, with selection guidance.
  </Card>
</Columns>