Nhận dự án mới tháng 11/2026 · phản hồi trong ngày làm việcZalo · GitHub

MCP server cho CRM: để AI tra khách, ghi chú và tạo việc

Nhân viên ngồi trước laptop xem giao diện ZCRM: hội thoại Zalo, khung chat, hồ sơ khách (dữ liệu mẫu)

MCP server cho CRM là lớp công cụ đặt giữa AI và CRM: AI chỉ làm được việc server cho phép, như tìm khách, đọc lịch sử, thêm ghi chú, tạo việc nhắc hẹn. Việc đọc cho chạy ngay. Việc ghi phải hẹp, ghi tên người yêu cầu và qua bước người đồng ý khi khó hoàn tác.

Blog đã có bài MCP là gì, cách AI đọc dữ liệu công ty cho chủ doanh nghiệp và bài MCP server tự dựng: kiến trúc và lỗi dễ mắc cho đội kỹ thuật (transport, OAuth, tám lỗi). Bài này hẹp hơn: một ca dùng cụ thể là CRM. Thứ tự: bộ công cụ nên có, cách viết định nghĩa cho ba việc trong tiêu đề, việc nào đọc và việc nào ghi, dữ liệu cá nhân của khách, quyền theo người dùng, ví dụ thật từ cổng MCP của tôi, CRM đã có MCP sẵn, rồi điểm bất lợi. Định nghĩa công cụ theo đặc tả MCP bản 2026-07-28 trên modelcontextprotocol.io, kiểm ngày 09/11/2026.

Bộ công cụ nên có cho một CRM

Sale hỏi AI những câu rất đều: khách này là ai, lần trước nói gì, ai phụ trách, hôm nay gọi ai. Bộ công cụ bám đúng các câu đó, mỗi công cụ một việc.

Ba việc qua MCP: tra khách, ghi chú, tạo việc; việc ghi phải qua bước người đồng ý
Ba việc AI làm với CRM qua MCP: tra khách, ghi chú, tạo việc; các việc ghi dữ liệu đi qua bước người đồng ý.
Công cụLàm gìLoạiCách cho chạy
search_customersTìm khách theo tên, số điện thoại, email; trả danh sách gọnĐọcChạy ngay
get_customerHồ sơ một khách và lịch sử trao đổi, ghi chú, đổi trạng tháiĐọcChạy ngay
add_noteThêm một ghi chú vào lịch sử kháchGhi, chỉ thêmChạy, ghi tên người yêu cầu
create_taskTạo việc hoặc nhắc hẹn gắn với khách, có hạn và người làmGhi, chỉ thêmHiện lại nội dung trước khi tạo
update_statusĐổi trạng thái khách trong quy trình bánGhi, thay đổiChỉ khi người dùng yêu cầu rõ

Tôi không đưa vào MCP ở bước đầu: xoá khách, gộp khách trùng, gửi tin hàng loạt, xuất cả danh sách. Việc khó hoàn tác hoặc đưa dữ liệu ra ngoài nên làm trên giao diện CRM có người bấm.

Viết định nghĩa cho ba việc: tra khách, ghi chú, tạo việc

Trang Tools của đặc tả MCP (kiểm 09/11/2026) ghi mỗi công cụ có name, description, inputSchema là một JSON Schema, có thể thêm title, outputSchema và annotations. Tên nên dài 1 đến 128 ký tự, chỉ chữ ASCII, số, gạch dưới, gạch ngang, dấu chấm. Mô hình AI tự quyết lúc gọi, nên phần mô tả phải nói rõ khi nào gọi và gọi xong thay đổi gì.

Tra khách: hẹp và có giới hạn

Ví dụ định nghĩa:

{"name": "search_customers", "description": "Tìm khách trong phạm vi người đang hỏi. Trả tối đa 20 dòng: mã khách, tên, trạng thái, người phụ trách. Không trả số điện thoại đầy đủ.", "inputSchema": {"type": "object", "properties": {"keyword": {"type": "string", "maxLength": 100}, "status": {"type": "string", "enum": ["new", "contacted", "won", "lost"]}, "limit": {"type": "integer", "minimum": 1, "maximum": 20}}, "required": ["keyword"], "additionalProperties": false}, "annotations": {"readOnlyHint": true}}

Đáng giữ: enum cho trạng thái để AI không tự đặt nhãn mới, maximum cho số dòng.

Ghi chú: chỉ thêm, không sửa, không xoá

{"name": "add_note", "description": "Thêm ghi chú vào lịch sử một khách, ghi tên người đang kết nối. Chỉ ghi điều người dùng nói hoặc đã xác nhận.", "inputSchema": {"type": "object", "properties": {"customer_id": {"type": "integer", "minimum": 1}, "note": {"type": "string", "minLength": 1, "maxLength": 2000}}, "required": ["customer_id", "note"], "additionalProperties": false}, "annotations": {"readOnlyHint": false, "destructiveHint": false}}

Theo bảng kiểu dữ liệu của đặc tả, destructiveHint: false nghĩa là công cụ chỉ thêm, không phá dữ liệu cũ. customer_id lấy từ kết quả tra khách, không cho AI đoán.

Tạo việc nhắc hẹn: kiểm ngày ở server

Công cụ create_task nhận customer_id, title, due_at (chuỗi có "format": "date-time") và assignee_id, mặc định là chính người hỏi. Ngày đã qua hoặc người nhận không thuộc nhóm thì server trả lỗi thực thi với isError: true và câu giải thích, như đặc tả hướng dẫn, để AI sửa tham số rồi gọi lại thay vì tạo việc sai.

Đặc tả cũng cảnh báo: annotations chỉ là gợi ý, ứng dụng không được tin chúng nếu server không đáng tin. Gắn readOnlyHint không thay được việc server tự chặn thao tác ghi.

Việc đọc chạy ngay, việc ghi cần người đồng ý

Đặc tả trang Tools viết: vì an toàn, luôn nên có người trong vòng lặp có quyền từ chối lời gọi công cụ; ứng dụng nên hỏi xác nhận với thao tác nhạy cảm, hiện tham số cho người dùng trước khi gọi, và ghi nhật ký mỗi lần dùng công cụ. Phía server phải kiểm mọi đầu vào, kiểm soát truy cập, giới hạn tần suất và làm sạch kết quả trả về.

Tôi chia ba mức cho CRM:

  1. Đọc: tra khách, xem hồ sơ. Chạy ngay, có giới hạn số dòng.
  2. Ghi chỉ thêm: ghi chú, tạo việc. Chạy được, nhưng mỗi bản ghi mang tên người yêu cầu, và AI phải đọc lại nội dung cho người dùng trước khi tạo việc.
  3. Ghi thay đổi: đổi trạng thái, đổi người phụ trách. Chỉ khi người dùng nói rõ; trạng thái kiểu «rác» hay «mất khách» thì hỏi lại một lần.

Dữ liệu cá nhân của khách

Tên, số điện thoại, email, lời nhắn của khách là dữ liệu cá nhân. Luật Bảo vệ dữ liệu cá nhân số 91/2025/QH15 có hiệu lực từ 01/01/2026, theo trang Ngân hàng Nhà nước (kiểm 09/11/2026); trang nêu chủ thể dữ liệu có quyền đồng ý, không đồng ý hoặc rút lại sự đồng ý, và cấm làm lộ, làm mất dữ liệu cá nhân. Tôi không tư vấn pháp lý; đây là cách để AI chạm ít dữ liệu nhất:

  • Trả gọn. Kết quả tra khách chỉ có mã, tên, trạng thái, người phụ trách. Số điện thoại che bớt, chỉ hiện đủ khi người dùng mở hồ sơ một khách.
  • Không đưa dữ liệu khách vào header. Đặc tả cho phép đẩy tham số ra header HTTP bằng x-mcp-header, nhưng ghi rõ không nên làm vậy với mật khẩu, khoá, token hay thông tin định danh cá nhân, vì các thiết bị mạng trung gian đọc được header.
  • Nhật ký ghi thao tác, không chép nguyên hồ sơ. Ai, lúc nào, công cụ gì, mã khách nào là đủ.
  • Lời dặn của server cấm chép dữ liệu khách ra ngoài. Không đưa vào bài viết, email gửi người khác hay sang hệ thống khác.

Quyền theo người dùng, không theo khoá chung

Lỗi hay gặp là cả công ty dùng một khoá quản trị CRM cho MCP: AI của nhân viên mới thấy mọi khách như giám đốc. Đặc tả cho phép tools/list trả bộ công cụ khác nhau theo quyền của người gọi, ví dụ chỉ trả công cụ mà phạm vi quyền được cấp cho phép. Cách làm ở CRM:

  • Nhân viên sale thấy khách được giao cho mình; quản lý thấy cả nhóm.
  • Server kiểm quyền ở mỗi lời gọi, kể cả khi AI đưa một mã khách hợp lệ lấy từ chỗ khác.
  • Khách ngoài phạm vi trả «không tìm thấy», không trả «không có quyền», để không lộ là khách đó tồn tại.

Phần xác thực OAuth và kiểm token đúng đối tượng nằm ở bài kiến trúc MCP server đã dẫn ở trên; bài Claude Code nối MCP với Slack, email, CRM bàn thêm quyền tối thiểu và nhật ký.

Ví dụ thật: phần khách liên hệ trong cổng MCP của tôi

Cổng MCP tôi dùng quản trị nhiều website bất động sản có một nhóm công cụ cho khách để lại liên hệ trên web, giống một CRM nhỏ. Tôi đọc mô tả công cụ và lời dặn của server ngày 09/11/2026:

  • list_leads liệt kê khách mới nhất trước, lọc theo trạng thái và nhu cầu, tối đa 50 dòng mỗi trang. Chuyên viên chỉ thấy khách giao cho mình, quản lý thấy tất cả. Mô tả ghi rõ đây là dữ liệu cá nhân, chỉ dùng để tư vấn.
  • get_lead trả thông tin khách, tin hay dự án khách quan tâm, lời nhắn và lịch sử xử lý. Khách ngoài phạm vi trả «không tìm thấy».
  • add_lead_note ghi chú tối đa 2.000 ký tự, kèm tên người đang kết nối. Mô tả dặn AI chỉ ghi điều người dùng nói hoặc đã xác nhận, không bịa nội dung cuộc gọi.
  • update_lead_status đổi giữa năm trạng thái: mới, đang tư vấn, đã hẹn xem nhà, chốt được, rác. Chỉ đổi khi người dùng yêu cầu rõ, «rác» thì hỏi lại trước; lịch sử ghi người đổi.

Mỗi lời gọi chỉ chạm một website; thao tác đăng, gỡ, xoá thì lần gọi đầu chỉ trả mã xác nhận, người dùng đồng ý rồi mới gọi lại. Cổng chưa có công cụ tạo việc nhắc hẹn: trạng thái «đã hẹn xem nhà» chỉ là nhãn, không tự nhắc ai. Đó là việc tôi sẽ thêm theo đúng khuôn create_task ở trên. Nếu anh chị cần chăm khách Zalo với nhắc việc sẵn trong phần mềm, bài CRM cho Zalo nói cách chọn.

Nếu CRM của anh chị đã có MCP server sẵn

Một số hãng CRM đã có máy chủ MCP chính thức. Trang MCP của HubSpot (kiểm 09/11/2026) mô tả máy chủ MCP từ xa cho phép công cụ AI tương thích MCP đọc và ghi dữ liệu CRM, gồm liên hệ, công ty, thương vụ, ghi chú, việc cần làm, xác thực bằng OAuth. Bài MCP server cho HubSpot CRM đi sâu hơn. Trước khi bật, kiểm phạm vi quyền xin cấp, AI chạy dưới tài khoản của ai, thao tác ghi có bước xác nhận nào. Nếu tự viết, bài dựng MCP server đầu tiên bằng TypeScript là điểm bắt đầu.

Điểm bất lợi khi cho AI vào CRM qua MCP

  • AI vẫn có thể ghi sai ý. Ghi chú đúng định dạng nhưng tóm sai lời khách thì server không chặn được. Người phụ trách nên đọc lại ghi chú do AI soạn.
  • Thêm một lớp phải giữ. CRM đổi trường dữ liệu là định nghĩa công cụ phải sửa theo.
  • Bước xác nhận làm chậm. Đổi trạng thái mười khách là mười lần hỏi. Đổi lại, không có thay đổi nào người phụ trách không biết.
  • Dữ liệu khách đi qua mô hình AI. Đọc điều khoản dữ liệu của gói AI đang dùng.

Câu hỏi thường gặp về MCP cho CRM

MCP server cho CRM khác gọi thẳng API của CRM thế nào?

API cho phép mọi thao tác khoá được cấp. MCP server chỉ đưa ra vài công cụ hẹp có mô tả cho AI, kiểm quyền theo người dùng và đặt luật xác nhận trước khi ghi.

Có nên cho AI xoá khách qua MCP không?

Theo tôi là không, ít nhất ở bước đầu. Xoá, gộp khách và gửi tin hàng loạt nên làm trên giao diện CRM có người bấm.

Làm sao để AI không thấy số điện thoại của khách?

Đặt ở server: kết quả tra khách che bớt số, chỉ trả đủ khi người dùng mở hồ sơ một khách thuộc phạm vi của họ. Không dựa vào lời dặn AI tự che.

Công ty nhỏ có cần tự viết MCP server cho CRM?

Nếu CRM đang dùng đã có MCP chính thức thì dùng trước, kiểm kỹ phạm vi quyền. Tự viết khi cần luật riêng, như phạm vi theo nhóm sale hay bước xác nhận khác hãng.

Nguồn: modelcontextprotocol.io, đặc tả bản 2026-07-28 (Tools, Schema: ToolAnnotations); sbv.gov.vn (Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15); developers.hubspot.com/mcp, kiểm ngày 09/11/2026. Mô tả công cụ list_leads, get_lead, add_lead_note, update_lead_status là cấu hình cổng MCP của tôi, đọc ngày 09/11/2026.

Lộc Nguyễn

Dựng đội agent làm việc thật cho doanh nghiệp. Viết lại những gì đã làm, có số đo kèm theo.

Về tác giả →

Khoá Claude miễn phí cho người không rành kỹ thuật

8 bài, làm theo từng bước: từ lần đầu mở Claude đến nối Zalo, bảng tính và email. Để lại email, nhận bài 1 ngay.

MCP server cho CRM: AI tra khách, ghi chú, tạo việc