Tidio

官方

透過 MCP 將 Tidio 與您的網站連接。無需離開程式開發環境即可嵌入小工具。

你可以用 Tidio MCP 做什麼?

  • 驗證並連結您的 Tidio 帳戶 — 執行 tidio_connect 並提供您的網站網址,透過瀏覽器登入後自動擷取您的公開金鑰。
  • 檢查連線狀態並取得嵌入程式碼 — 使用 tidio_status 確認已成功連線,並為您的網站擷取 JavaScript 程式碼片段。
  • 使用現有金鑰產生嵌入程式碼 — 呼叫 generate_tidio_embed 並提供您的公開金鑰,以產生聊天小工具程式碼,可選擇非同步或同步載入方式。
  • 中斷連線並清除已儲存的憑證 — 執行 tidio_disconnect 以移除本機儲存的權杖與公開金鑰。

文件

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 並自動取得您的公開金鑰。

運作方式:

  1. 在您的瀏覽器中開啟 Tidio 登入頁面
  2. 您使用 Tidio 帳號進行驗證
  3. 自動回傳您的公開金鑰與嵌入程式碼

參數:

  • site_url(必要):將嵌入 Tidio 的網站網址

範例:

Connect Tidio to https://mywebsite.com

tidio_status

檢查您的連線狀態並取得嵌入程式碼。

參數:

tidio_disconnect

清除已儲存的憑證。

generate_tidio_embed

為特定的公開金鑰產生嵌入程式碼(若您已持有金鑰)。

參數:

  • public_key(必要):您的 Tidio 公開金鑰
  • loading_mode(選用):"async"(預設)或 "sync"

運作原理

  1. 使用者呼叫 tidio_connect 並提供其網站網址
  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" }

嵌入程式碼輸出

連接器會產生最佳化的非同步載入程式碼:

開發

安裝相依套件

npm install

以開發模式執行

npm run dev

建置生產版本

npm run build

執行已建置的版本

npm start

需求

  • Node.js 18 以上版本
  • 一個 Tidio 帳號(免費方案即可使用)

授權

MIT

相關資源

  • Tidio - 即時聊天與聊天機器人平台
  • Model Context Protocol - AI 整合的開放標準
  • Lovable - AI 驅動的應用程式開發