> ## 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.

# 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/QBbibzt-K6hz3_Cs/images/icons/claude.svg?fit=max&auto=format&n=QBbibzt-K6hz3_Cs&q=85&s=f95d6b09112201a96adca01c1d1ac3e2" 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/QBbibzt-K6hz3_Cs/images/icons/claude.svg?fit=max&auto=format&n=QBbibzt-K6hz3_Cs&q=85&s=f95d6b09112201a96adca01c1d1ac3e2" 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/QBbibzt-K6hz3_Cs/images/icons/openai.svg?fit=max&auto=format&n=QBbibzt-K6hz3_Cs&q=85&s=14da94cc189f7438f9e32d7a905bf42d" href="/install/chatgpt" width="16" height="16" data-path="images/icons/openai.svg">OpenAI assistant</Card>
      <Card title="Codex" icon="https://mintcdn.com/klarityai/MU2wbXaDNR6iydvr/images/icons/codex.svg?fit=max&auto=format&n=MU2wbXaDNR6iydvr&q=85&s=e9ce68236e2833823ebc14bbf5e9fe33" href="/install/codex" width="16" height="16" data-path="images/icons/codex.svg">OpenAI CLI</Card>
      <Card title="Cursor" icon="https://mintcdn.com/klarityai/QBbibzt-K6hz3_Cs/images/icons/cursor.svg?fit=max&auto=format&n=QBbibzt-K6hz3_Cs&q=85&s=913892db55291211284418c8ba87ef3d" href="/install/cursor" width="16" height="16" data-path="images/icons/cursor.svg">IDE</Card>
      <Card title="Gemini CLI" icon="https://mintcdn.com/klarityai/QBbibzt-K6hz3_Cs/images/icons/gemini.svg?fit=max&auto=format&n=QBbibzt-K6hz3_Cs&q=85&s=4c84d2d81e2611396b105a3c1a85b7a0" href="/install/gemini-cli" width="16" height="16" data-path="images/icons/gemini.svg">Google CLI</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>