> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Install the xysq plugin, sign in via /mcp, done. About one minute, no API key to copy.

Claude Code connects through the xysq plugin: it registers the MCP server and bundles the memory skills, so your agent knows how and when to use them. Authentication is OAuth through your browser. Takes about a minute.

<Steps>
  <Step title="Install the plugin">
    Run these two commands in Claude Code:

    ```bash theme={"dark"}
    /plugin marketplace add xysq-ai/xysq-claude-plugin
    /plugin install xysq@xysq-official
    ```
  </Step>

  <Step title="Sign in via /mcp">
    Open the MCP panel:

    ```text theme={"dark"}
    /mcp
    ```

    You'll see **xysq** listed. Select it and approve the OAuth flow. Claude Code opens your browser, signs you in to xysq, and stores the session in your system keychain.

    You only do this once. Future sessions reuse the stored session automatically.
  </Step>

  <Step title="Verify the connection">
    In Claude Code, ask:

    ```text theme={"dark"}
    Pull my xysq context.
    ```

    That triggers the first tool call. The in-app guide at [app.xysq.ai](https://app.xysq.ai) watches for it and marks the connection verified.
  </Step>
</Steps>

## Prefer the MCP server on its own?

Optional. If you just want the server without the plugin (skills, updates), add it by URL:

```bash theme={"dark"}
claude mcp add --transport http xysq https://api.xysq.ai/mcp
```

Then run `/mcp`, select **xysq**, and approve the OAuth flow. Verify with `claude mcp list`; you should see `xysq` in the output.

## No browser? Use an API key

Only if you can't run the OAuth flow (a headless CI runner, a server-to-server automation, a shared workstation). Generate a key in the app's Claude Code connect guide, then pass it as a bearer header instead of signing in:

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