Setup - Koalr Docs

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

Claude Code
Claude.ai
Codex
Cursor
Other clients

Add the server:

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:

claude mcp list

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.

Add the server:

codex mcp add koalr --url https://app.koalr.ai/api/mcp

codex mcp list

Open Settings, then MCP, then Add new global MCP server, and paste:

{
  "mcpServers": {
    "koalr": {
      "url": "https://app.koalr.ai/api/mcp"
    }
  }
}

Save the file, then click Login on the Koalr server to sign in.

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.

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.

​First call

​Disconnecting

First call

Disconnecting