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 並自動取得您的公開金鑰。
運作方式:
- 在您的瀏覽器中開啟 Tidio 登入頁面
- 您使用 Tidio 帳號進行驗證
- 自動回傳您的公開金鑰與嵌入程式碼
參數:
site_url(必要):將嵌入 Tidio 的網站網址
範例:
Connect Tidio to https://mywebsite.com
tidio_status
檢查您的連線狀態並取得嵌入程式碼。
參數: 無
tidio_disconnect
清除已儲存的憑證。
generate_tidio_embed
為特定的公開金鑰產生嵌入程式碼(若您已持有金鑰)。
參數:
public_key(必要):您的 Tidio 公開金鑰loading_mode(選用):"async"(預設)或"sync"
運作原理
- 使用者呼叫
tidio_connect並提供其網站網址 - 瀏覽器開啟 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
相關資源
- Tidio - 即時聊天與聊天機器人平台
- Model Context Protocol - AI 整合的開放標準
- Lovable - AI 驅動的應用程式開發