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

> Add xysq as a custom integration in Claude web or desktop. About three minutes, OAuth handles authentication.

Claude (web and desktop) connects to xysq as a custom integration. OAuth handles authentication, so there's no API key to copy. Takes about three minutes.

<Steps>
  <Step title="Open Claude's integration settings">
    In **Claude.ai** (web) or the **Claude desktop app**:

    1. Click your profile picture (top right).
    2. Open **Settings**.
    3. Go to **Integrations** in the sidebar.
    4. Click **Add custom integration**.
  </Step>

  <Step title="Paste the server URL">
    In the **Add custom integration** dialog, paste this into the **MCP server URL** field:

    ```text theme={"dark"}
    https://api.xysq.ai/mcp
    ```

    If Claude asks for OAuth client credentials, copy them from the in-app guide (open **Connect → Claude** in [app.xysq.ai](https://app.xysq.ai); the client ID and secret are shown there).

    Click **Add** (or **Save**) to finish registering the integration.
  </Step>

  <Step title="Approve the OAuth flow">
    When you connect, Claude opens a browser tab to xysq's OAuth approval page.

    1. Sign in to xysq if prompted.
    2. Review the access Claude is requesting.
    3. Click **Approve**.

    The tab closes automatically and Claude shows xysq as connected.

    <Tip>If the popup gets blocked, allow popups for claude.ai and try the **Connect** button again. Use **Disconnect → Connect** to retry if the OAuth token ever expires.</Tip>
  </Step>

  <Step title="Verify the connection">
    Start a new conversation and ask:

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

    Claude triggers its first tool call, and the in-app guide marks the connection verified.

    <Tip>If Claude doesn't use the tool automatically, be explicit: "Use the xysq tools to pull my context."</Tip>
  </Step>
</Steps>