MCP server

Hadir Chat runs a Model Context Protocol (MCP) server, so AI apps such as Claude, ChatGPT and Cursor can answer questions from your workspace's data. It offers the same tools as Hadir Assistant, and every one of them only reads; none can send, change or delete anything. It works if Hadir Assistant and MCP connections are enabled on your workspace.

The server

• URL: https://app.hadir.chat/mcp
• Transport: Streamable HTTP, one JSON-RPC 2.0 message per POST, answered as JSON. Methods: initialize, ping, tools/list, tools/call.
• Every tool answer starts with the workspace name and its time zone, then the result in the user's language, then the same data as JSON (also in structuredContent).

Two ways to sign in

OAuth (Claude and ChatGPT)

Give the app the URL only. The server advertises its sign-in through /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server, and apps register themselves. The person then signs in to Hadir Chat in the same browser and sees Connect an app to Hadir Assistant, where they tick what the app may reach under What it can reach, pick Expires after, and select Approve and connect. Access tokens last an hour and refresh on their own. Step by step for each app: Connect Claude and ChatGPT.

A key (the Claude API, Cursor, other apps)

1. As an administrator, open Settings, then Integrations, then the MCP (Claude and ChatGPT) card.
2. Select Add a new MCP connection. Fill in Connection name, App, What it can reach and Expires after (30 days, 90 days or never), then Create connection.
3. Copy the Key; it starts with hdr_mcp_. You can show it again later with Show key after confirming your password.

Send the key as a bearer token:

curl https://app.hadir.chat/mcp \
  -H "Authorization: Bearer hdr_mcp_…" -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

With the Claude API, put the URL in mcp_servers and the key in authorization_token.

What a connection can see

Every call gets the narrowest of three limits: the role of the person who made the connection, the scopes ticked for it, and what the plan includes. tools/list returns only the tools that pass all three. A refused call is not a protocol error: it comes back with isError: true and a sentence saying what is missing, so the AI can tell the person. Revoking a connection, its expiry, the person leaving the workspace or the plan dropping the feature all take effect on the next call.

Each connection may make 30 tool calls a minute. Every call is listed under Hadir Assistant, Logs, MCP requests, with the person, the tool, its inputs and the result. The chats inside Claude or ChatGPT never reach Hadir Chat.

The tools

Scope in brackets. Some also need the matching feature in your plan, such as deals, appointments or a connected store.

• account_info (Overview): the workspace's plan, limits, channels, integrations, features and business hours.
• account_summary (Overview): new and resolved conversations, first response, open and waiting, for a period.
• compare_periods (Overview): two periods side by side, with the change.
• unanswered_conversations (Conversations): open conversations waiting for a reply, oldest first.
• sla_status (Conversations): conversations past their SLA target or within 30 minutes of it.
• search_conversations (Conversations): find conversations by name, phone or conversation number.
• conversation_transcript (Conversations): the last 30 messages of one conversation.
• agent_summary (Team performance): one agent's figures for a period.
• team_ranking (Team performance): agents ranked by one figure.
• available_now (Team performance): agents online now and their open conversations.
• contact_search (Customers): find a customer by name, phone or email.
• customer_360 (Customers): one customer's conversations, deals, tasks, appointments, satisfaction and orders.
• deals (Sales and orders): deals by status, owner or stage.
• deal_details (Sales and orders): one deal with its open tasks.
• tasks (Sales and orders): tasks due today or overdue.
• appointments (Appointments): appointments in a period.
• appointment_types (Appointments): the appointment types.
• free_slots (Appointments): free slots for up to 14 days.
• order_lookup (Store): a customer's recent store orders.
• orders_summary (Store): new store orders in a period, per store.
• campaigns (Campaigns): WhatsApp campaigns by state.
• campaign_results (Campaigns): one campaign's delivery, replies and opt-outs.
• journey_results (Campaigns): automated messages' results for 7, 30 or 90 days.
• csat_summary (Quality and operations): customer satisfaction for a period.
• whatsapp_health (Quality and operations): each WhatsApp number's quality and daily limit.
• service_meter (Quality and operations): WhatsApp service messages this month.
• hadir_ai_usage (Quality and operations): this month's Hadir AI replies and allowance.

Note: a key acts as the person who created it. Give each app its own connection with only the scopes it needs, and select Revoke on any you no longer use.