Tidio MCP Server

官方

通过MCP将Tidio与您的网站连接。无需退出编程环境即可嵌入小部件。

访问 tid.io

文档

Tidio MCP 连接器

一个将 AI 助手连接到 Tidio 在线客服的 MCP（模型上下文协议）服务器 - 支持自动设置

功能特性

自动设置：一条命令即可连接 Tidio - 无需手动复制密钥
OAuth 认证：打开浏览器进行安全的 Tidio 登录，自动获取您的公钥
凭据持久化：凭据会保存在本地，供后续会话使用
嵌入代码生成：为任何网站获取即用型 JavaScript 代码

安装

npm install tidio-mcp-connector

或者克隆并在本地构建：

git clone https://github.com/your-username/tidio-mcp-connector.git cd tidio-mcp-connector npm install npm run build

使用方法

与 Claude Desktop 配合使用

添加到您的 Claude Desktop 配置中 (~/Library/Application Support/Claude/claude_desktop_config.json)：

{ "mcpServers": { "tidio": { "command": "npx", "args": ["tidio-mcp-connector"] } } }

与 Lovable 配合使用

此 MCP 连接器可与 Lovable 及类似的 AI 驱动开发平台配合使用。将其添加为自定义 MCP 服务器。

与 MCP Inspector 配合使用（测试）

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

可用工具

`tidio_connect`（推荐）

连接到 Tidio 并自动获取您的公钥。

工作原理：

打开浏览器跳转到 Tidio 的登录页面
您使用 Tidio 账户进行认证
自动返回您的公钥和嵌入代码

参数：

site_url（必填）：将嵌入 Tidio 的网站 URL

示例：

Connect Tidio to https://mywebsite.com

`tidio_status`

检查您的连接状态并获取嵌入代码。

参数： 无

`tidio_disconnect`

清除已存储的凭据。

`generate_tidio_embed`

为特定的公钥生成嵌入代码（如果您已有公钥）。

参数：

public_key（必填）：您的 Tidio 公钥
loading_mode（可选）："async"（默认）或 "sync"

工作原理

用户调用 tidio_connect 并传入其网站 URL
浏览器打开 Tidio 的认证页面
用户登录 其 Tidio 账户
收到回调 - MCP 服务器获取刷新令牌
发起 API 调用 - 用令牌换取访问令牌，然后获取公钥
凭据保存 到 ~/.tidio-mcp/credentials.json
返回嵌入代码 - 可直接添加到网站

凭据存储

凭据本地存储在 ~/.tidio-mcp/credentials.json：

{ "public_key": "abc123...", "access_token": "...", "refresh_token": "...", "site_url": "https://example.com", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }

嵌入代码输出

连接器生成优化的异步加载代码：

开发

安装依赖

npm install

在开发模式下运行

npm run dev

构建生产版本

npm run build

运行构建后的版本

npm start

环境要求

Node.js 18+
一个 Tidio 账户（免费套餐即可）

许可证

MIT