Tidio MCP连接器

一个将AI助手连接到Tidio实时聊天的MCP服务器,支持自动设置、OAuth认证和凭证持久化。

  • by TidioPoland
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 TidioPoland/tidio-mcp-connector

使用说明

Tidio MCP连接器

MCP(模型上下文协议)服务器,将AI助手连接到 视频 实时聊天-与 自动设置

特性

  • 自动设置:只需一个命令即可连接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桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

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

与可爱

此MCP连接器适用于 可爱的 以及类似的人工智能驱动开发平台。将其添加为自定义MCP服务器。

配备MCP检查员(测试)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

可用工具

tidio_connect (推荐)

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

它是如何工作的:

  1. 打开浏览器进入Tidio的登录页面
  2. 您使用Tidio帐户进行身份验证
  3. 自动返回您的公钥和嵌入代码

参数:

  • site_url (必填):Tidio将嵌入的网站URL

例子:

Connect Tidio to https://mywebsite.com

tidio_status

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

参数: 无

tidio_disconnect

清除存储的凭据。

参数: 无

generate_tidio_embed

为特定公钥生成嵌入代码(如果您已经有公钥)。

参数:

  • public_key (必填):您的Tidio公钥
  • loading_mode (可选): "async" (默认)或 "sync"

运作原理

  1. 用户呼叫 tidio_connect 使用他们的网站URL
  2. 浏览器打开 转到Tidio的身份验证页面
  3. 用户登录 到他们的Tidio帐户
  4. 已收到回拨 -MCP服务器获取刷新令牌
  5. 进行了API调用 -将令牌交换为访问令牌,然后检索公钥
  6. 已保存凭据 到 ~/.tidio-mcp/credentials.json
  7. 返回嵌入代码 -已准备好添加到网站

凭据存储

凭据存储在本地 ~/.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"
}

嵌入代码输出

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

<script type="text/javascript">
document.tidioChatCode = "YOUR_PUBLIC_KEY";
(function() {
  function asyncLoad() {
    var tidioScript = document.createElement("script");
    tidioScript.type = "text/javascript";
    tidioScript.async = true;
    tidioScript.src = "//code.tidio.co/YOUR_PUBLIC_KEY.js";
    document.body.appendChild(tidioScript);
  }
  if (window.attachEvent) {
    window.attachEvent("onload", asyncLoad);
  } else {
    window.addEventListener("load", asyncLoad, false);
  }
})();
</script>

发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start

需求

  • Node.js 18+
  • Tidio帐户(免费版有效)

许可证

麻省理工学院

相关