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

# Claude Code

> Install the Klarity plugin or register the MCP server in Claude Code.

Two install paths are supported. The plugin path is preferred — it ships the bundled skill prompt and uses OAuth.

## Plugin install (preferred, OAuth)

From a Claude Code session, run these two commands one after the other.

<Steps>
  <Step title="Install the marketplace">
    ```text theme={null}
    /plugin marketplace add klarity-ai/klarity-mcp
    ```
  </Step>

  <Step title="Install the plugin">
    ```text theme={null}
    /plugin install klarity@klarity
    ```
  </Step>

  <Step title="Sign in">
    The first request that hits a Klarity tool will prompt you to authenticate.
  </Step>
</Steps>

## Manual MCP add (API key)

Use this for long-running background agents. Generate an API key from `Settings → MCP` in your Klarity workspace (see [Authentication](/authentication#api-key)), then run:

```bash theme={null}
claude mcp add --transport http klarity \
  https://api.klarity.ai/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"
```

<Warning>
  Treat the API key like a password. Anyone with the key can query your Klarity workspace. Rotate it from `Settings → MCP` if it's exposed.
</Warning>

## Verify

In a Claude Code session, ask:

```text theme={null}
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.