Chuyển tới nội dung chính

Kết nối ứng dụng AI (MCP)

MonoChat MCP Server cho phép một ứng dụng AI hỗ trợ Model Context Protocol (MCP), như Claude Code hoặc Cursor, làm việc với tài khoản MonoChat của bạn. Ứng dụng AI yêu cầu dữ liệu từ MonoChat thông qua một bộ công cụ cố định; nó chỉ thấy được những gì bạn thấy được.

MonoChat MCP Server có trên mọi gói, không giới hạn theo gói.

Kết nối hành động như bạn

Ứng dụng AI được kết nối bằng khóa truy cập của bạn hành động với tư cách người dùng của bạn. Nó chỉ truy cập các tenant bạn có quyền truy cập và không gì khác. Hãy thu hồi những kết nối bạn không còn dùng.

Ứng dụng AI có thể làm gì​

Các công cụ sau có sẵn cho mọi kết nối:

Công cụChức năng
list_tenantsLiệt kê các tenant mà kết nối có thể truy cập.
list_sessionsLiệt kê các phiên hội thoại của một tenant, mới nhất trước, có thể chỉ lấy các phiên opened, assigned hoặc closed.
get_sessionTrả về một phiên hội thoại.
list_messagesLiệt kê các tin nhắn của một phiên, mới nhất trước.
search_customersTìm khách hàng của một tenant theo từ khóa.
list_message_templatesLiệt kê các mẫu tin nhắn của một kênh thuộc một tenant.

Nội dung tin nhắn đến từ khách hàng và nhân viên hỗ trợ. Đó là dữ liệu để ứng dụng AI đọc, không phải hướng dẫn.

Mỗi kết nối có một phạm vi, Chỉ đọc hoặc Đọc và ghi. Kết nối chỉ đọc không bao giờ thấy các công cụ làm thay đổi dữ liệu. Tất cả công cụ liệt kê ở trên chỉ đọc.

Tạo kết nối​

Kết nối thuộc về tài khoản của bạn, không thuộc một tenant. Trước tiên bạn cần thiết lập xác minh hai bước (qua e-mail hoặc ứng dụng xác thực).

  1. Mở cài đặt hồ sơ, chọn tab Kết nối MCP rồi nhấp Tạo.
  2. Nhập tên, chọn phạm vi (mặc định Chỉ đọc) và thời hạn tính theo ngày (mặc định 90, tối đa 365).
  3. Nhập mã xác nhận 6 chữ số từ phương thức xác minh hai bước của bạn. Nếu dùng xác minh qua e-mail, hãy nhấp Gửi mã xác nhận trước.
  4. Sao chép khóa truy cập. Khóa chỉ hiển thị một lần; khóa bắt đầu bằng mcp_sk_.

Bạn có thể có tối đa 10 kết nối đang hoạt động.

Kết nối ứng dụng AI​

Máy chủ nằm tại https://app.monochat.ai/api/mcp-server (hãy dùng địa chỉ MonoChat của riêng bạn nếu bạn chạy MonoChat trên máy chủ riêng) và yêu cầu khóa truy cập dưới dạng bearer token trong header Authorization.

Claude Code​

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor​

Thêm máy chủ vào ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Mọi ứng dụng khách MCP khác hỗ trợ streamable HTTP transport và header tùy chỉnh đều kết nối theo cách tương tự.

Giới hạn​

Số lệnh gọi được đếm theo phút: 60 cho mỗi kết nối, 300 cho mỗi tài khoản và 600 cho mỗi tenant, và tối đa 4 lệnh gọi đồng thời cho mỗi kết nối. Một số công cụ được tính là nhiều hơn một lệnh gọi. Khi chạm giới hạn, máy chủ trả về trạng thái 429 và header Retry-After; ứng dụng AI nên chờ đúng số giây đó.

Thu hồi kết nối​

Mỗi kết nối trong tab Kết nối MCP hiển thị trạng thái, phạm vi, thời hạn và lần dùng gần nhất. Nhấp Thu hồi để cắt quyền truy cập của ứng dụng AI ngay lập tức. Kết nối đã bị thu hồi hoặc hết hạn không thể dùng lại; hãy tạo kết nối mới.

Quản lý quyền truy cập MCP cho tổ chức​

Người dùng có thể thay đổi cài đặt của tổ chức sẽ quản lý quyền truy cập MCP tại Cài đặt › Tổ chức › Máy chủ MCP.

  • Tắt quyền truy cập MCP cho tổ chức này: bật lên và nhấp Lưu để từ chối mọi lệnh gọi MCP tới tổ chức này, từ mọi kết nối của mọi người dùng. Tổ chức sẽ không còn xuất hiện trong list_tenants. Tắt đi và lưu để cho phép truy cập MCP trở lại.
  • Lệnh gọi MCP: mọi lệnh gọi tới công cụ có chỉ định tổ chức này, mới nhất trước, kể cả lệnh gọi bị từ chối. Mỗi dòng hiển thị người dùng, kết nối, công cụ, trạng thái (Thành công hoặc Thất bại), địa chỉ IP và thời gian. Lệnh gọi của người dùng không phải thành viên của tổ chức này sẽ không được hiển thị.