Kết nối các Trợ lý AI (MCP)

DM Champ cung cấp một MCP server chính thức — một điểm cuối Model Context Protocol cho phép các trợ lý AI như Claude Code, Claude Desktop, ChatGPT, Cursor và các ứng dụng của riêng bạn điều khiển trực tiếp tài khoản DM Champ của bạn. Hãy hỏi bằng ngôn ngữ tự nhiên (“liệt kê các chiến dịch trực tiếp của tôi”, “thêm khách hàng tiềm năng này”, “AI đã tiêu tốn của tôi bao nhiêu trong tuần này?”) và trợ lý sẽ gọi API DM Champ cho bạn.

Đây là cùng một API v1 được ghi lại trong phần API, được xác thực bằng khóa API của riêng bạn. Máy chủ MCP xây dựng một công cụ cho mỗi thao tác trong đặc tả API đã công bố của chúng tôi, vì vậy nó bao gồm hầu hết, nhưng không phải tất cả, API v1: danh bạ, tin nhắn, chiến dịch, tác nhân AI, cơ sở kiến thức, cuộc hẹn, phân tích, thẻ, danh sách và tài khoản phụ. Các chương trình phát sóng, Tự động hóa và Giao dịch hiện chưa khả dụng dưới dạng công cụ MCP — hãy sử dụng trực tiếp REST API cho các mục đó. Trong phạm vi những gì nó hiển thị, không có quyền cho mỗi công cụ và không có mặc định chỉ đọc, vì vậy khóa API là toàn bộ quyền kiểm soát truy cập.

Điểm cuối (Endpoint): https://mcp.youraiconnector.com/mcp
Xác thực: khóa API DM Champ của bạn (được gửi dưới dạng tiêu đề X-API-Key)
Yêu cầu: gói dịch vụ có quyền truy cập API. Tạo khóa API →

Khóa API của bạn hoạt động trên tài khoản của chính bạn, với các quyền tương tự như phần còn lại của API — và có thể đọc các tài khoản khách hàng mà bạn quản lý, nếu bạn đang sử dụng gói đại lý (xem bên dưới). Hãy coi nó như mật khẩu. Bạn có thể thu hồi nó bất kỳ lúc nào từ Cài đặt → Tích hợp → Khóa API, thao tác này sẽ ngay lập tức cắt quyền truy cập của trợ lý.

Claude Code

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Sau đó, chạy /mcp bên trong Claude Code để xác nhận rằng nó hiển thị dm-champ ✓ đã kết nối.

Theo mặc định, máy chủ được thêm ở phạm vi cục bộ (chỉ bạn, dự án này). Sử dụng --scope user để làm cho nó khả dụng trong tất cả các dự án của bạn, hoặc --scope project to commit it to a repo’s .mcp.json cho nhóm của bạn:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Chỉnh sửa tệp claude_desktop_config.json của bạn (Cài đặt → Nhà phát triển → Chỉnh sửa cấu hình) và thêm:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Khởi động lại Claude Desktop. Các công cụ DM Champ sẽ xuất hiện trong menu công cụ.

ChatGPT

Các trình kết nối MCP tùy chỉnh khả dụng trên ChatGPT Business, Enterprise và Pro. Chủ sở hữu hoặc quản trị viên không gian làm việc trước tiên phải bật chế độ nhà phát triển / trình kết nối tùy chỉnh trong cài đặt không gian làm việc — nếu không, tùy chọn tạo trình kết nối sẽ không bao giờ xuất hiện.

Sau đó, hãy tạo trình kết nối với:

URL: https://mcp.youraiconnector.com/mcp
Xác thực: Tiêu đề tùy chỉnh
Tên tiêu đề: X-API-Key
Giá trị tiêu đề: khóa API DM Champ của bạn

URL phải kết thúc bằng /mcp. Chỉ dán https://mcp.youraiconnector.com là lỗi phổ biến nhất — ChatGPT kiểm tra chính xác địa chỉ đó, không tìm thấy gì ở đó và hiển thị “Unable to add connector URL”.

Cursor & các ứng dụng khách MCP khác

Hầu hết các trình chỉnh sửa hỗ trợ MCP đều sử dụng cùng một cấu trúc .mcp.json như hiển thị ở trên (một máy chủ HTTP với url và tiêu đề X-API-Key). Thêm một máy chủ dm-champ trỏ đến https://mcp.youraiconnector.com/mcp và dán khóa API của bạn vào tiêu đề.

Claude API (tích hợp vào ứng dụng của riêng bạn)

Bạn có thể kết nối MCP server theo chương trình với trình kết nối MCP của Claude API, vì vậy một tác nhân (agent) mà bạn xây dựng có thể sử dụng các công cụ DM Champ mà không cần ứng dụng khách riêng biệt:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

Bạn có thể làm gì

Trong phần API v1 mà máy chủ MCP hiển thị, trợ lý sẽ tự động chọn công cụ phù hợp:

Chiến dịch: liệt kê, tạo, cập nhật, tạm dừng/tiếp tục, kiểm tra cấu hình bot.
Liên hệ: tìm kiếm, tạo, gắn thẻ, thêm vào danh sách, nhập dữ liệu.
Cơ sở kiến thức / Câu hỏi thường gặp: thêm, chỉnh sửa, nhập hàng loạt, phê duyệt các đề xuất của AI.
Tin nhắn: đọc cuộc trò chuyện, gửi tin nhắn cho liên hệ.
Cuộc hẹn: liệt kê, đặt lịch, hủy lịch.
Tác vụ: tạo, hoàn thành, liệt kê.
Phân tích: thống kê tin nhắn, mức sử dụng tín dụng, chi phí AI.
Kênh: kiểm tra trạng thái kết nối, bắt đầu quy trình kết nối.

Hỏi về tài khoản của khách hàng (đại lý)

Một kết nối bao gồm mọi tài khoản bạn quản lý. Bạn không cần thêm kết nối thứ hai cho mỗi khách hàng: trên gói đại lý, trợ lý có thể đọc bất kỳ tài khoản khách hàng nào dưới quyền của bạn, vì vậy bạn có thể hỏi về tất cả chúng trong một cuộc trò chuyện.

Chỉ cần nêu tên khách hàng:

“Bella’s Bistro có bao nhiêu liên hệ?”
“AI đã tiêu tốn của mỗi khách hàng của tôi bao nhiêu trong tuần này?”
“Những chiến dịch nào đang hoạt động cho Northside Dental và trạng thái các kênh của họ như thế nào?”

Điều này bao gồm việc đọc danh bạ, tin nhắn, cuộc trò chuyện, chiến dịch, cuộc hẹn, tác vụ, thẻ, sự kiện, câu hỏi thường gặp, nguồn cơ sở kiến thức, số điện thoại, kênh, webhook và phân tích. Chúng tôi kiểm tra xem tài khoản có thực sự là của bạn trước khi thực hiện bất kỳ thao tác nào — việc yêu cầu một tài khoản không thuộc quyền sở hữu của bạn sẽ trả về kết quả “không tìm thấy”. Nếu không nêu tên khách hàng, trợ lý sẽ đọc tài khoản của chính bạn, giống như trước đây.

Việc thay đổi tài khoản của khách hàng bị hạn chế hơn. Việc thiết lập các tác nhân AI, hàm tùy chỉnh, mẫu WhatsApp, điểm truy cập, kết nối kênh, trạng thái chiến dịch và mua số điện thoại đều hoạt động cho một khách hàng cụ thể; hầu hết các thao tác ghi khác vẫn chạy trên tài khoản của chính bạn, vì vậy hãy thực hiện các thao tác đó từ khóa của chính khách hàng đó hoặc từ REST API, vốn bao quát nhiều hơn.

Đây cũng là câu trả lời cho khách hàng điều hành nhiều doanh nghiệp dưới một thông tin đăng nhập. Hãy cấp cho mỗi doanh nghiệp một tài khoản riêng, sau đó mời email của khách hàng làm thành viên nhóm trên tất cả các tài khoản đó: họ chỉ cần đăng nhập một lần và chuyển đổi giữa các thương hiệu của mình bằng bộ chọn tài khoản trong thanh bên.

Cung cấp tài liệu trợ giúp cho trợ lý của bạn

Máy chủ MCP cung cấp cho trợ lý tài khoản của bạn; nó không cung cấp tài liệu này cho trợ lý. Nếu bạn cũng muốn trợ lý trả lời chính xác các câu hỏi “làm thế nào để…”, hãy hướng nó đến https://docs.youraiconnector.com/llms.txt (một chỉ mục của mọi trang trợ giúp kèm liên kết đến phiên bản Markdown của từng trang) hoặc https://docs.youraiconnector.com/llms-full.txt (toàn bộ tài liệu trong một tệp Markdown duy nhất). Cả hai đều công khai, không cần khóa và được xây dựng lại sau mỗi lần thay đổi tài liệu. Xem Đọc các tài liệu này dưới dạng Markdown.

Tìm hoặc tạo khóa API của bạn

Khóa API mà kết nối này sử dụng nằm tại Cài đặt → Tích hợp → Khóa API — một phần riêng biệt, tách biệt với Webhooks. Xem Truy cập API để biết các bước chính xác.

Khắc phục sự cố

“Unable to add connector URL” (ChatGPT) / “connection refused” — địa chỉ đang thiếu /mcp ở cuối. Hãy sử dụng https://mcp.youraiconnector.com/mcp, thay vì https://mcp.youraiconnector.com.
Needs authentication / 401 — khóa API của bạn bị thiếu hoặc không chính xác. Hãy thêm lại máy chủ với một X-API-Key hợp lệ.
Một công cụ trả về 403 — gói dịch vụ hoặc vai trò nhóm của bạn không cho phép thực hiện hành động đó; máy chủ MCP không áp đặt thêm bất kỳ hạn chế nào, đó là cùng một quy trình kiểm tra quyền như API.
Không tìm thấy công cụ — danh sách công cụ được tạo trực tiếp từ API, vì vậy nó luôn khớp với phiên bản hiện tại; hãy kết nối lại để làm mới.
Cảnh báo bảo mật hoặc chứng chỉ trên tên miền của riêng bạn — việc trỏ bản ghi DNS về phía chúng tôi là chưa đủ: tên miền phụ cũng phải được xác minh trong bảng điều khiển trước khi có thể cung cấp kết nối bảo mật. Các đại lý white-label có thể đặt địa chỉ MCP trên tên miền của riêng họ (ví dụ: mcp.youragency.com) từ thẻ Custom domain trong mục Settings → White Labeling — trước tiên hãy thêm CNAME tại nhà đăng ký của bạn, sau đó nhập tên máy chủ vào khối MCP domain (AI assistants) và nhấp vào Verify, quy trình tương tự như các tên miền phụ có thương hiệu khác của bạn. Cho đến khi được xác minh, hãy sử dụng địa chỉ tiêu chuẩn ở trên — nó không có thương hiệu, vì vậy bạn có thể chia sẻ an toàn với khách hàng.

Các bước tiếp theo

Truy cập API — tạo hoặc xoay vòng khóa mà kết nối này sử dụng.
Webhooks — đối tác dựa trên đẩy (push-based) cho kết nối MCP dựa trên kéo (pull-based) này.

Kết nối các Trợ lý AI (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor & các ứng dụng khách MCP khác #

Claude API (tích hợp vào ứng dụng của riêng bạn) #

Bạn có thể làm gì #

Hỏi về tài khoản của khách hàng (đại lý) #

Cung cấp tài liệu trợ giúp cho trợ lý của bạn #

Tìm hoặc tạo khóa API của bạn #

Khắc phục sự cố #

Các bước tiếp theo #