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

# Setup

> Connect Claude Code, Claude.ai, Codex or Cursor to Koalr in a minute.

The in-app version of this page, with your server URL pre-filled, is at **Integrations, AI agents (MCP)** in Koalr.

<Tabs>
  <Tab title="Claude Code">
    Add the server:

    ```bash theme={"system"}
    claude mcp add --transport http koalr https://app.koalr.ai/api/mcp
    ```

    Then run `/mcp` inside Claude Code, choose **koalr**, and sign in with your Koalr account in the browser window that opens. Confirm with:

    ```bash theme={"system"}
    claude mcp list
    ```
  </Tab>

  <Tab title="Claude.ai">
    Open **Settings**, then **Connectors**, then **Add custom connector**. Enter:

    ```
    https://app.koalr.ai/api/mcp
    ```

    Save, then click **Connect** and sign in with your Koalr account.
  </Tab>

  <Tab title="Codex">
    Add the server:

    ```bash theme={"system"}
    codex mcp add koalr --url https://app.koalr.ai/api/mcp
    ```

    Sign in when prompted, then confirm with:

    ```bash theme={"system"}
    codex mcp list
    ```
  </Tab>

  <Tab title="Cursor">
    Open **Settings**, then **MCP**, then **Add new global MCP server**, and paste:

    ```json theme={"system"}
    {
      "mcpServers": {
        "koalr": {
          "url": "https://app.koalr.ai/api/mcp"
        }
      }
    }
    ```

    Save the file, then click **Login** on the Koalr server to sign in.
  </Tab>

  <Tab title="Other clients">
    Any client that supports remote MCP servers over Streamable HTTP with OAuth works. Point it at `https://app.koalr.ai/api/mcp`; the server advertises its OAuth metadata and your client will open the sign-in.
  </Tab>
</Tabs>

## First call

Ask your agent to list your Koalr workspaces. It calls `list_workspaces`, which returns each organisation you belong to with its `org_id` and your role. Every other tool takes a `site_id` from `list_sites`, and an `org_id` when you want a workspace other than the default you chose at sign-in.

## Disconnecting

Remove the server from your client and the agent stops immediately. Sign-ins expire within 24 hours. See [Authentication](/api/mcp/authentication).