Claude Desktop

Connect Celigo Platform MCP to the Claude Desktop app.

Prerequisites

• Claude Desktop installed.
• An integrator.io user (see Connect a client).

Connect

If your plan offers custom connectors, add the server there — it handles the OAuth sign-in natively and needs no config file:

1. Open Customize > Connectors (Team and Enterprise admins manage these under Organization settings > Connectors) and choose Add custom connector.
2. Enter the name Celigo and the URL https://api.integrator.io/celigo-mcp.
3. Add the connector, then connect it. Your browser opens the Celigo sign-in page. Sign in and pick the account and environment the agent should work in.

The URL is region-specific. See Pick your endpoint.

Use the config file instead

Claude Desktop's config file launches local processes, so a remote server is added through the mcp-remote bridge, which forwards to the hosted endpoint. Run it without a header and mcp-remote starts the same browser sign-in on first use. Requires Node.js 18+ (provides npx).

1. Open Settings > Developer > Edit Config. This opens claude_desktop_config.json.
2. Add the celigo entry. On macOS or Linux:

{
  "mcpServers": {
    "celigo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.integrator.io/celigo-mcp"
      ]
    }
  }
}

On Windows, npx is a .cmd script that Claude Desktop can't launch directly, so run it through cmd /c:

{
  "mcpServers": {
    "celigo": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://api.integrator.io/celigo-mcp"
      ]
    }
  }
}

Swap the host to target another region. See Pick your endpoint.

1. Save and fully restart Claude Desktop. A browser window opens for the Celigo sign-in.

⚠️ A token in claude_desktop_config.json is stored in plain text. Keep the file out of version control and off shared machines, and rotate the token in Resources > API tokens if it is exposed.

To authenticate with an API token instead of the browser sign-in, append two arguments to the args array: "--header" and "Authorization: Bearer <YOUR_API_TOKEN>".

Verify

In a new chat, confirm celigo appears in the tools menu, then ask:

List my connections.

Approve the tool call when prompted. Claude calls list_connections and reports the result.