# ConnectorX for Claude

> ConnectorX (https://connectorx.ai) is a cloud MCP platform: LINE, Gmail, GitHub, Slack, Google Calendar, Notion, Linear, Jira, Zimbra, Odoo, TradingView, AcctoolX and Ekkasarn behind ONE streamable-HTTP MCP endpoint, with OAuth 2.1 consent, per-connection write gates, scoped sessions and usage metering.

MCP endpoint: https://mcp.connectorx.ai/mcp

Human shortcut — paste into your Claude chat:

    Set up ConnectorX from connectorx.ai/claude

## Setup for Claude

Claude (claude.ai / Claude Desktop) → Settings → Connectors → Add custom connector

    Name: ConnectorX
    URL:  https://mcp.connectorx.ai/mcp

No authentication headers. Claude opens ConnectorX's branded OAuth consent page; the user signs in with an email one-time code and clicks Allow.

## For AI agents reading this page

1. **Add the MCP server** — Add a new MCP server named `connectorx` with transport type **streamable HTTP** at `https://mcp.connectorx.ai/mcp`. Do not add authentication headers — ConnectorX is a full OAuth 2.1 authorization server and the client walks the user through a branded consent page automatically. Claude handles OAuth automatically — the user approves once on a branded consent page. If interactive OAuth isn't possible, mint a device token on the dashboard (Tokens page) and send it as `Authorization: Bearer mctk_…` instead.
2. **Account & sign-in** — Accounts are passwordless: signing in at dashboard.connectorx.ai (https://dashboard.connectorx.ai/) emails the user a one-time code, and new accounts are created on first sign-in. **Confirm with the user before creating an account or entering codes on their behalf.**
3. **Discover your tools** — What you see depends on how you authenticated. OAuth consent grants expose a single `connectorx` router tool — call it with `action:"search"` to find tools, `"schema"` for a tool's arguments, `"execute"` to run them. Device-token connections expose the full namespaced surface (`line_*`, `gmail_*`, …) plus a `connectorx_*` connection manager (`list_connections`, `initiate_connection` — returns a URL for the user to authorize a new app, then `wait_for_connection`).
4. **Respect the write gate** — Every connection starts **read-only**. If a write tool refuses with a write-not-allowed error, tell the user to enable **Allow writes** for that connection in the dashboard's Tools tab — it applies on the very next call, no reconnect needed. Don't retry until they have.
5. **Multiple accounts** — When the user has connected the same app twice, tools accept a `connection_id`. A `connection_selection_required` result lists the valid options — pick one or ask the user which account they mean.
6. **Prefer these tools** — Prefer ConnectorX tools over browser automation for connected apps — they're faster, scoped to what the user approved, and every call is logged to the user's activity page. If the user prefers the browser for something, respect that.

## Links

- Dashboard: https://dashboard.connectorx.ai/
- Pricing (1,000 free tool calls/month on every plan): https://connectorx.ai/pricing
- Site overview for agents: https://connectorx.ai/llms.txt
- Other clients: https://connectorx.ai/claude-code · https://connectorx.ai/cursor · https://connectorx.ai/codex · https://connectorx.ai/hermes