Tidio MCP Server

Claude桌面版Tidio MCP服务器

模型上下文协议（MCP）服务器，将Claude Desktop连接到Tidio的API，允许您直接从Claude访问聊天对话数据、客户支持票据和运营商信息。

🚀 快速开始

先决条件

• Node.js 18+ - 点击此处下载
• 克劳德桌面 - 点击此处下载
• Tidio 帐户 具有API访问权限（需要Plus或Premium计划）

步骤1：获取您的Tidio API凭据

1. 登录您的Tidio仪表板
2. 首选 设置 → 开发者 → OpenAPI
3. 复制您的：

- 客户端ID （开始于 ci_) - 客户端密钥 （开始于 cs_)

步骤2：安装MCP服务器

# Clone this repository
git clone https://github.com/ufarooqm/tidio-mcp-server.git
cd tidio-mcp-server

# Install dependencies
npm install

# Test the server works
npm test

步骤3：配置您的凭据

编辑 tidio-mcp.js 文件并替换凭据：

// Replace these with your actual Tidio credentials
const CLIENT_ID = 'your_client_id_here';
const CLIENT_SECRET = 'your_client_secret_here';

步骤4：配置Claude桌面

1. 查找您的Claude Desktop配置文件：

- 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%/Claude/claude_desktop_config.json

1. 添加此配置 （替换 /path/to/ 根据您的实际路径）：

{
  "mcpServers": {
    "tidio-mcp": {
      "command": "node",
      "args": [
        "/path/to/tidio-mcp-server/tidio-mcp.js"
      ]
    }
  }
}

Mac示例：

{
  "mcpServers": {
    "tidio-mcp": {
      "command": "node",
      "args": [
        "/Users/yourname/tidio-mcp-server/tidio-mcp.js"
      ]
    }
  }
}

步骤5：重新启动克劳德桌面

1. 完全退出克劳德桌面
2. 重新打开克劳德桌面
3. 开始新的对话

🛠 可用工具

配置后，您将可以在Claude中访问这些工具：

• get_contacts -获取与您的聊天有过互动的客户联系人
• get_contact_messages -按联系人ID获取完整的对话记录
• get_operators -列出所有Tidio运营商/代理商
• search_contacts -按电子邮件、姓名或其他条件搜索联系人
• get_tickets -使用过滤选项检索支持票
• get_ticket_details -获取特定门票的详细信息

📝 Claude中的示例用法

"Can you get my recent Tidio contacts and show me the conversation transcript for the most recent one?"

"Show me all open support tickets from the last week"

"Search for contacts with email containing '@gmail.com' and analyze their common issues"

🔧 故障排除

“服务器启动失败”错误

• 请确保已安装Node.js 18+： node --version
• 检查是否安装了所有依赖项： npm install
• 验证您的凭据是否正确 tidio-mcp.js

Claude中“无可用工具”

• 确保中的文件路径 claude_desktop_config.json 是正确的
• 更改配置后完全重新启动Claude Desktop
• 检查服务器启动时是否没有错误： npm test

API速率限制

• Tidio对API调用有速率限制
• 如果出现429个错误，请等待几分钟后重试

🔒 安全说明

• 永远不要将您的实际API证书提交给Git
• 考虑在生产中使用环境变量作为凭据
• 保持你的 CLIENT_SECRET 私密且安全

📞 支持

如果您遇到问题：

1. 检查上面的故障排除部分
2. 验证您的Tidio计划是否包含API访问权限
3. 独立测试服务器： npm test

🤝 贡献

请随时提交问题和增强请求！

______________________________________________________________________

由以下材料制成❤️ 为了更好地进行客户支持分析