AI导哈

Tidio MCP服务器

Tidio MCP服务器是一个模型上下文协议（MCP）服务器，与Tidio客户服务平台集成，通过Tidio OpenAPI使Tidio功能可直接在LLM客户端（如Claude Desktop）中使用。

  • by adrmrn
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 adrmrn/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 从 Docker 中心.

  1. 安装并运行 Docker 桌面版

  2. 安装并打开 克劳德桌面版

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

  4. 添加以下配置，用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"
      }
    }
  }
}

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

选项2：技术用户（Python）

  1. 克隆此存储库

  2. 安装依赖项 uv sync

  3. 复制 .env.example 到 .env 并设置您的Tidio凭据

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

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

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

可用工具

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

缺少端点

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

  • []创建多个联系人(POST /contacts/batch)
  • []更新多个联系人(PATCH /contacts/batch)
  • []获取浏览页面历史记录(GET /contacts/{contact_id}/viewed-pages)
  • []获取联系信息(POST /contacts/{contact_id}/messages)

贡献

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

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

相关 MCP