# Tidio setup for PopMCP

You paste a Client ID and a Client Secret from your Tidio panel. The same pair works for live records and for analytics, and PopMCP finds your project from them.

- Auth: API credentials
- Setup time: 3 min
- API base URL: Live records: https://api.tidio.com. Analytics: https://taa.data.tidio.com. PopMCP picks the right one for each tool.
- Credentials screen: https://www.tidio.com/panel/settings/developer
- Provider docs: https://developers.tidio.com/docs/openapi-authorization

## Approval required before this works

No one reviews you, but Tidio's documentation says its API is only available on the Plus and Premium plans. On a paid Lyro plan alone, only product uploads for Lyro work, and the Free plan has no API.

- Typical wait: None once the project is on the plan.
- Cost: See Tidio's pricing page for Plus and Premium.
- Blocked until approved: Every tool except the two Lyro product tools. PopMCP still connects a real key on a smaller plan, and says only those tools can work.
- Works meanwhile: Decide whether the AI should only read or also reply to tickets, and generate a key pair just for PopMCP under Settings, Developer, OpenAPI.

## Before you begin

- A Tidio project on the Plus or Premium plan, which is what Tidio's API needs. On a paid Lyro plan alone, only product uploads for Lyro work.
- To be an owner or admin of the project. Only they can open the page that makes the keys.

## Get your credentials

### 1. Open the OpenAPI page

Sign in to the Tidio panel. Open Settings, then Developer, then OpenAPI. You need to be an owner or admin of the project to see it.

Screen: https://www.tidio.com/panel/settings/developer

### 2. Generate a key pair and copy both values

Select Generate OpenAPI key. Tidio shows a Client ID, starting `ci_`, and a Client Secret, starting `cs_`. Copy both now: the Client Secret is only shown once. A new pair just for PopMCP is the safest choice, because you can delete it on its own.

Screen: https://www.tidio.com/panel/settings/developer

### 3. Paste them into PopMCP

Open Tidio in PopMCP, paste the Client ID and the Client Secret, and connect. PopMCP checks the pair with Tidio and names the connection after your project. There is nothing else to fill in. New connections start read-only, and an owner or admin can allow writes.

## Fields PopMCP asks for

- Client ID (clientId) [required]: From Settings > Developer > OpenAPI in your Tidio panel: Generate OpenAPI key.
- Client Secret (clientSecret) [required]: Shown once, next to the Client ID, so copy it before you close that window. Stored encrypted, used server-side only.

## Verify

PopMCP shows Tidio as Verified, named with your project id. Ask for an overview: tidio_project_overview answers with your team, departments, ticket tags, custom fields and contact properties.

## Troubleshooting

### "Tidio did not accept these keys"

Cause: A value was copied incompletely, or the pair was deleted in Tidio. The Client Secret cannot be shown again.

Fix: Generate a new pair under Settings, Developer, OpenAPI, and paste both values.

### PopMCP says only the Lyro product tools can work

Cause: The keys are real, but Tidio says this project's plan does not include its full API.

Fix: Move the project to the Plus or Premium plan, then reconnect. Product uploads for Lyro work on a paid Lyro plan.

### A tool says there have been too many requests

Cause: Tidio limits each project per minute: 60 requests on Plus and 120 on Premium.

Fix: Wait a minute and ask again. Asking for fewer pages at once helps.

### Analytics come back empty for today or yesterday

Cause: Tidio loads analytics once a day. Yesterday's data arrives at about 10:00 UTC, and today's is never complete.

Fix: Ask about a range that ends earlier. Live tools such as tidio_list_tickets show what is happening now.

### An analytics question times out

Cause: Tidio gives each query 25 seconds, and some of its tables are large.

Fix: Ask about a shorter date range or fewer columns.

### The AI cannot answer a live chat

Cause: Tidio's API has no way to send an operator's live chat reply. It can read those conversations and reply to tickets.

Fix: Answer live chats in Tidio, or use tickets for replies the AI should send.

---

Source: https://www.docs.popmcp.com/docs/integrations/tidio/