Tidio MCP Server

chính thức

Kết nối Tidio với trang web của bạn qua MCP. Nhúng widget

Xem trên tid.io

Tài liệu

Tidio MCP Connector

Một máy chủ MCP (Model Context Protocol) kết nối trợ lý AI với chat trực tuyến Tidio - cùng với thiết lập tự động

Tính năng

  • Thiết lập tự động: Kết nối với Tidio chỉ bằng một lệnh - không cần sao chép khóa thủ công
  • Xác thực OAuth: Mở trình duyệt để đăng nhập Tidio an toàn, tự động lấy khóa công khai của bạn
  • Lưu trữ thông tin xác thực: Thông tin xác thực được lưu cục bộ cho các phiên sau
  • Tạo mã nhúng: Nhận mã JavaScript sẵn sàng sử dụng cho bất kỳ trang web nào

Cài đặt

npm install tidio-mcp-connector

Hoặc sao chép và build cục bộ:

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

Cách sử dụng

Với Claude Desktop

Thêm vào cấu hình Claude Desktop của bạn (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Với Lovable

Trình kết nối MCP này hoạt động với Lovable và các nền tảng phát triển ứng dụng hỗ trợ AI tương tự. Thêm nó như một máy chủ MCP tùy chỉnh.

Với MCP Inspector (Kiểm thử)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

Công cụ có sẵn

tidio_connect (Khuyến nghị)

Kết nối với Tidio và tự động lấy khóa công khai của bạn.

Cách hoạt động:

  1. Mở trình duyệt đến trang đăng nhập của Tidio
  2. Bạn xác thực bằng tài khoản Tidio của mình
  3. Tự động trả về khóa công khai và mã nhúng

Tham số:

  • site_url (bắt buộc): URL trang web nơi Tidio sẽ được nhúng

Ví dụ:

Connect Tidio to https://mywebsite.com

tidio_status

Kiểm tra trạng thái kết nối và lấy mã nhúng của bạn.

Tham số: Không có

tidio_disconnect

Xóa thông tin xác thực đã lưu.

generate_tidio_embed

Tạo mã nhúng cho một khóa công khai cụ thể (nếu bạn đã có sẵn).

Tham số:

  • public_key (bắt buộc): Khóa công khai Tidio của bạn
  • loading_mode (tùy chọn): "async" (mặc định) hoặc "sync"

Cách hoạt động

  1. Người dùng gọi tidio_connect với URL trang web của họ
  2. Trình duyệt mở đến trang xác thực của Tidio
  3. Người dùng đăng nhập vào tài khoản Tidio của họ
  4. Nhận callback - máy chủ MCP nhận refresh token
  5. Thực hiện gọi API - đổi token lấy access token, sau đó lấy khóa công khai
  6. Lưu thông tin xác thực vào ~/.tidio-mcp/credentials.json
  7. Trả về mã nhúng - sẵn sàng để thêm vào trang web

Lưu trữ thông tin xác thực

Thông tin xác thực được lưu cục bộ tại ~/.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" }

Đầu ra mã nhúng

Trình kết nối tạo mã tải bất đồng bộ được tối ưu hóa:

Phát triển

Cài đặt các gói phụ thuộc

npm install

Chạy ở chế độ phát triển

npm run dev

Build cho production

npm run build

Chạy phiên bản đã build

npm start

Yêu cầu

  • Node.js 18+
  • Một tài khoản Tidio (gói miễn phí hoạt động được)

Giấy phép

MIT

Liên quan

  • Tidio - Nền tảng chat trực tuyến và chatbot
  • Model Context Protocol - Tiêu chuẩn mở cho tích hợp AI
  • Lovable - Phát triển ứng dụng hỗ trợ AI