Connect the Analytics API with MCP

MCP (Model Context Protocol) is an open standard that lets AI tools like Claude and Cursor pull live data from other services. Once you connect Tidio's Analytics API over MCP, you can ask your AI assistant questions like "How many tickets did we close last week?" or "Show me Lyro's resolution rate by day" and get answers straight from your Tidio data. No API calls, no code, no BI tool required.

This guide walks you through connecting Tidio to Claude Code, Claude Desktop and Cursor. Pick the tool you use and follow its section below.

Step 1: Get your API credentials

Credentials are generated exactly as for the OpenAPI - see instructions to generate Client ID and Client Secret you'll use to authenticate.

Step 2: Connect your AI tool

The Analytics MCP server lives at:

https://taa-mcp.data.tidio.com/mcp

Every tool below connects to this same address. They just ask for it in different ways.

Claude Code

Open a terminal (a plain text window for typing commands, already built into your computer):

Mac: press Cmd + Space, type Terminal, press Enter.
Windows: press the Windows key (⊞), type PowerShell, press Enter.

Then paste one of the commands below, replacing the placeholders with your real credentials.

💻 Paste into your terminal — two-header method:

claude mcp add --header "X-Tidio-Openapi-Client-Id: YOUR_CLIENT_ID" --header "X-Tidio-Openapi-Client-Secret: YOUR_CLIENT_SECRET" --transport http Tidio-Analytics-API https://taa-mcp.data.tidio.com/mcp

If you get command not found: claude when you try the command below, Claude Code isn't installed on your computer yet. Install it first following these instructions.

Claude Desktop

Claude Desktop's settings UI doesn't yet support custom authentication headers, so we connect through a small, official bridge tool called mcp-remote. It runs locally on your machine and forwards your credentials securely. You only need Node.js installed (most computers already have it, or you can get it from nodejs.org).

Open Claude Desktop and go to Settings > Developer > Edit Config. This opens (or creates) your claude_desktop_config.json file in a text editor, not a terminal.
Add the following, replacing the placeholder values with your real credentials.

{
  "mcpServers": {
    "tidio-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://taa-mcp.data.tidio.com/mcp",
        "--header",
        "X-Tidio-Openapi-Client-Id:${TIDIO_CLIENT_ID}",
        "--header",
        "X-Tidio-Openapi-Client-Secret:${TIDIO_CLIENT_SECRET}"
      ],
      "env": {
        "TIDIO_CLIENT_ID": "YOUR_CLIENT_ID",
        "TIDIO_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Save the file and restart Claude Desktop.

Cursor

Follow Cursor instructions.
In the configuration file, add the following, replacing the placeholder values with your real credentials.

{
  "mcpServers": {
    "tidio-analytics": {
      "url": "https://taa-mcp.data.tidio.com/mcp",
      "headers": {
        "X-Tidio-Openapi-Client-Id": "YOUR_CLIENT_ID",
        "X-Tidio-Openapi-Client-Secret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Open Cursor's Customize panel in the sidebar to confirm "tidio-analytics" is listed and enabled.

Optional: Building a single-header token

Some tools require single-header token. Follow these instructions to combine your Client ID and Client Secret into one value. It needs a one-line command, which you paste into a terminal:

Mac: press Cmd + Space, type Terminal, press Enter.
Windows: press the Windows key (⊞), type PowerShell, press Enter.

With that window open, copy the command for your system below, paste it in, and replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with your real credentials from Step 1, then press Enter:

💻 Paste into your terminal (Mac/Linux):

auth_header="$(echo -n "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" | base64)"
echo $auth_header

💻 Paste into your terminal (Windows PowerShell):

$auth_header = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"))
$auth_header

The terminal prints a long string of letters and numbers right under your command, that's your token. Copy it, you'll paste it into your tool's config as one header: Authorization: Bearer <the token you just copied>.

What you can ask for

Once connected, every Analytics API endpoint is available as a matching tool, one to one. See Analytics API referece for details. Your AI assistant decides which tool(s) to call based on your question, so you don't need to know the exact names, but it's recommended to read the documentation to know what data is in scope.

Good to know

Read-only. These tools can only read your analytics data. They can't send messages, change settings, or modify anything in your account.
Same data, same limits. The Analytics API pulls from the same dataset as the OpenAPI, follows the same rate limits and permissions and the same rules apply to data freshness.
One set of credentials, every tool. You don't need separate keys for Claude, Cursor, or anything else. If you ever need to revoke access, disabling the Client Secret in Settings > Developer > OpenAPI disconnects it everywhere at once.
Large date ranges may need follow-up questions. The underlying endpoints return up to 100 rows per call. Your AI assistant will usually page through results automatically, but if a question covers a lot of data, asking a narrower question (by date range or agent, for example) gets you a faster, more reliable answer.

Prompts you can try

Once you're connected, just ask in plain English. A few to get you started:

What are the top reasons people contact us, such as shipping, returns or sizing. Analyze last 30 days.
When do we miss the most chats, by day of week and hour? This can help with staffing. Analyze last 30 days.
Which topics most often get handed from Lyro to a human agent? Analyze last 30 days.
Analyze chat ratings from the last 30 days. What do we need to focus on?