Tidio

Trình kết nối MCP Tidio

Một máy chủ MCP (Model Context Protocol) kết nối trợ lý AI với trò chuyện trực tiếp Tidio - 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 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 clone 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

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 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ác 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 của bạn đến trang đăng nhập 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 của bạn

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 của bạn và lấy mã nhúng.

Tham số: Không có

tidio_disconnect

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

Tham số: Không có

generate_tidio_embed

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

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 lệnh gọi API - trao đổi token lấy access token, sau đó lấy khóa công khai
6. Thông tin xác thực được lưu vào ~/.tidio-mcp/credentials.json
7. Mã nhúng được trả về - 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 không đồng bộ được tối ưu hóa:

<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>

Phát triển

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start