Tidio MCP

Tidio MCP 服务器

与Tidio客户服务平台集成的模型上下文协议（MCP）服务器。

它就像一层覆盖在 Tidio OpenAPI（REST API），使Tidio功能可以直接在Claude Desktop等LLM客户端中使用。

需求

• Tidio 帐户 --Tidio Plus计划（或更高）
• API证书 --客户端ID和客户端密码（请参阅 授权指南)
• 环境 --Docker或Python 3.13+ 紫外线

设置

选项1：非技术用户（Claude Desktop+Docker）

您可以快速开始使用即用型Docker镜像 adrmrn/tidio-mcp 从 .

1. 安装并运行

1. 安装并打开 克劳德桌面

1. 在Claude Desktop中，转到 设置 → 开发者 → 编辑配置，并打开 claude_desktop_config.json 文本编辑器中的文件

1. 添加以下配置，用Tidio凭据替换占位符：

   {
     "mcpServers": {
       "Tidio": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "TIDIO_CLIENT_ID",
           "-e", "TIDIO_CLIENT_SECRET",
           "adrmrn/tidio-mcp:latest"
         ],
         "env": {
           "TIDIO_CLIENT_ID": "PASTE_YOUR_CLIENT_ID_HERE",
           "TIDIO_CLIENT_SECRET": "PASTE_YOUR_CLIENT_SECRET_HERE"
         }
       }
     }
   }

1. 保存文件并重新启动Claude Desktop

选项2：技术用户（Python）

1. 克隆此存储库

1. 安装依赖项 uv sync

1. 复制 .env.example 向 .env 并设置您的Tidio凭据

1. 将以下配置添加到MCP客户端：

   {
     "mcpServers": {
       "Tidio": {
         "command": "uv",
         "args": [
           "--directory",
           "/absolute/path/tidio-mcp",
           "run",
           "server.py"
         ]
       }
     }
   }

1. 重新启动MCP客户端以应用配置

可用工具

• 获取部门
• 获取操作员
• 获取联系人
• 获取联系方式
• 删除联系人
• 获取门票
• 获取门票详细信息
• 创建票证
• 更新工单
• 删除工单
• 取消分配票证
• 对工单的回复
• 在工单中添加内部注释

计划特征/缺失端点

• \[\]分页
• \[\]筛选

以下端点尚未实现，但计划在未来进行更新：

• \[\]创建联系人(POST /contacts)
• \[\]创建多个联系人(POST /contacts/batch)
• \[\]更新多个联系人(PATCH /contacts/batch)
• \[\]更新联系人属性(PATCH /contacts/{contact_id})
• \[\]获取浏览页面历史记录(GET /contacts/{contact_id}/viewed-pages)
• \[\]获取联系人属性(GET /contact-properties)
• \[\]获取联系信息(POST /contacts/{contact_id}/messages)
• \[\]高端产品(PUT /products/batch)
• \[\]删除产品(DELETE /products/{product_id})

贡献

欢迎投稿！\ 如果你想改进这个项目，可以随时提出问题或提交PR。

对于开发，存储库包括 Makefile 使用方便的命令来构建、调试和测试项目。