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

MCP server tự dựng cho doanh nghiệp: kiến trúc và những lỗi dễ mắc

AI chạm dữ liệu công ty qua máy chủ MCP có xác thực, bộ công cụ gọn, nhật ký và bước người duyệt

MCP server tự dựng cho doanh nghiệp nên chạy từ xa qua Streamable HTTP, xác thực người gọi, đưa ít công cụ có mô tả rõ và tham số chặt, kiểm quyền ở mỗi lời gọi, bắt người xác nhận thao tác ghi khó hoàn tác. Lỗi hay gặp là coi mô hình AI như người dùng đáng tin.

Blog đã có nhiều bài về MCP. Bài dựng MCP server đầu tiên bằng TypeScript hướng dẫn viết mã; bài MCP là gì giải thích khái niệm cho lập trình viên; bài MCP là gì: cách AI đọc dữ liệu công ty qua một cổng chung viết cho chủ doanh nghiệp và đã kể khái quát cổng MCP tôi dùng quản trị nhiều website bất động sản. Bài này viết cho đội kỹ thuật định tự dựng server, theo thứ tự: chọn transport, xác thực, thiết kế công cụ, bước người xác nhận, nhật ký và phân quyền, tám lỗi dễ mắc. Mỗi phần đối chiếu đặc tả MCP bản 2026-07-28 và tài liệu Claude Code, kiểm ngày 09/11/2026, kèm cách cổng của tôi đang làm.

Chọn transport: stdio hay Streamable HTTP

Đặc tả hiện hành có hai transport chuẩn (trang Transports, kiểm 09/11/2026):

stdioStreamable HTTP
Chạy ở đâuỨng dụng AI tự bật server thành tiến trình con trên máy người dùngServer chạy độc lập, phục vụ nhiều người
Cách nói chuyệnMỗi dòng một thông điệp JSON-RPC qua stdin, stdoutMỗi thông điệp một lệnh POST tới một địa chỉ MCP chung, trả JSON hoặc luồng SSE
Thông tin đăng nhậpLấy từ biến môi trườngTheo đặc tả authorization (OAuth)
Hợp vớiCông cụ cá nhân, đọc tệp trên máyCổng dùng chung cho cả công ty

Vài quy định dễ vấp:

  • stdio: server không được ghi gì khác thông điệp MCP ra stdout; log ghi ra stderr. Một dòng print gỡ lỗi quên xoá là hỏng kết nối.
  • Streamable HTTP: server phải kiểm header Origin để chống tấn công DNS rebinding, chạy cục bộ thì chỉ nghe trên 127.0.0.1, và nên xác thực mọi kết nối.
  • Bản 2026-07-28 bỏ phiên (session) và luồng GET. Cần giữ trạng thái giữa các lời gọi thì server trả một mã định danh và nhận lại mã đó làm tham số, kiểm quyền người gọi với mã ở mỗi lần.
  • HTTP+SSE kiểu cũ (2024-11-05) đã ngừng khuyến nghị. Tài liệu Claude Code cũng ghi transport SSE đã ngừng dùng.

Mỗi lệnh POST mang header MCP-Protocol-Version, Mcp-Method, và Mcp-Name với lời gọi công cụ. Proxy đặt trước server nhờ đó ghi log, giới hạn tần suất theo tên công cụ mà không phải đọc thân request.

Xác thực và ủy quyền

Theo đặc tả Authorization (kiểm 09/11/2026), ủy quyền là tuỳ chọn; khi làm, server HTTP nên theo đặc tả này, còn server stdio thì không, lấy thông tin đăng nhập từ môi trường. Các điểm chính:

  • MCP server là máy chủ tài nguyên OAuth 2.1, phải công bố Protected Resource Metadata (RFC 9728).
  • Server phải kiểm token được cấp đúng cho chính nó (audience). Token hỏng hoặc hết hạn trả 401; thiếu quyền trả 403.
  • Server không được nhận hay chuyển tiếp token nào khác. Kiểu nhận token của người dùng rồi đẩy thẳng xuống API phía sau bị đặc tả cấm, tài liệu bảo mật gọi là «token passthrough».
  • Token không được nằm trong chuỗi truy vấn URL, phải đi trong header Authorization: Bearer.
  • Quyền nên tách nhỏ: hướng dẫn bảo mật khuyên bắt đầu với bộ quyền tối thiểu, chủ yếu đọc, xin thêm khi thao tác cần.

Trang Tools còn cho phép tools/list chỉ trả các công cụ mà quyền của người gọi cho phép: người chỉ đọc không cần thấy công cụ xoá.

Cổng của tôi tách hai lớp. Lớp người gọi: cổng nhận diện ai đang gọi để tra quyền trong sổ website. Lớp website: mỗi website có một tài khoản dịch vụ do cổng giữ, cổng gọi API của website bằng khoá đó, người dùng và AI không thấy token. Đây là chiều ngược với token passthrough.

Phía ứng dụng, Claude Code thêm server từ xa bằng claude mcp add --transport http <tên> <địa chỉ> và đăng nhập OAuth qua lệnh /mcp (code.claude.com/docs/en/mcp, kiểm 09/11/2026); xem thêm bài 12 lệnh Claude CLI cơ bản.

Thiết kế công cụ: ít, rõ, chặt, gọn

Mô hình AI tự quyết lúc gọi công cụ, nên mô tả quyết định AI gọi đúng hay sai. Đặc tả và tài liệu Claude Code ghi:

  • Tên. Đặc tả khuyên dài 1 đến 128 ký tự, chỉ dùng chữ ASCII, số, gạch dưới, gạch ngang, dấu chấm; không khoảng trắng.
  • Tham số. inputSchema là JSON Schema; công cụ không tham số nên khai "additionalProperties": false. Có outputSchema thì kết quả phải đúng khuôn.
  • Lỗi để AI tự sửa. Lỗi nghiệp vụ (ngày sai định dạng, thiếu trường) trả trong kết quả với isError: true và câu giải thích rõ, để mô hình sửa tham số rồi gọi lại.
  • Độ dài mô tả. Claude Code cắt lời dặn của server và mô tả công cụ nạp sẵn ở 4.096 ký tự, mô tả công cụ nạp qua tìm kiếm ở 16.384 ký tự; tài liệu khuyên viết gọn, để ý chính ở đầu.
  • Độ dài kết quả. Claude Code cảnh báo khi kết quả công cụ vượt 10.000 token và mặc định giới hạn 25.000 token (đổi bằng MAX_MCP_OUTPUT_TOKENS).

Ở cổng của tôi, tên công cụ theo mẫu động từ cộng đối tượng: list_sites, create_listing, check_listing, publish_listing. Mọi công cụ trừ công cụ liệt kê website đều bắt buộc tham số website, mỗi lời gọi chỉ chạm một website. Mã loại tin, khu vực, hướng nhà lấy từ công cụ listing_options của đúng website đó, không cho AI tự đoán mã. Lời dặn của server (server instructions) ghi quy trình từng bước.

Thao tác ghi cần người xác nhận

Đặ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ụ, và ứng dụng nên hỏi xác nhận trước các thao tác. Nhưng đó là việc của ứng dụng AI, mỗi ứng dụng làm một kiểu, tuỳ cả cài đặt người dùng chọn. Vì vậy tôi đặt bước xác nhận ngay trong server.

Sơ đồ thật cổng MCP của tôi: AI làm nháp và tự kiểm, chủ web đồng ý bằng mã xác nhận rồi mới đăng
Sơ đồ luồng thật của cổng MCP tôi đang chạy: AI làm nháp và tự kiểm, lần gọi đăng đầu chỉ trả mã xác nhận, chủ web đồng ý rồi mới đăng.
  1. AI chọn đúng website, lấy mã hợp lệ, tạo tin ở dạng nháp. Nháp chưa ai thấy.
  2. AI tải ảnh, gọi check_listing. Cổng trả về điều còn thiếu theo luật tin (ảnh, giá, diện tích, vị trí, độ dài tiêu đề và mô tả, không số điện thoại). Chưa đạt thì AI sửa nháp rồi kiểm lại.
  3. AI gọi publish_listing. Lần gọi đầu, cổng chỉ trả về một confirm_code và chưa làm gì.
  4. AI nói rõ cho người dùng sẽ đăng gì, lên website nào. Người dùng đồng ý rõ trong cuộc trò chuyện thì AI mới gọi lại với cùng tham số kèm confirm_code.

Luật này áp cho mọi thao tác đăng, gỡ đăng, xoá, đóng tin, thêm hay gỡ người dùng: 12 trên 55 công cụ của cổng (tôi đếm ngày 09/11/2026). Lời dặn của server cấm AI tự xác nhận thay người dùng và cấm gộp nhiều lần đăng vào một lần đồng ý chung chung. Bài viết và landing cũng vậy: AI làm nháp, gửi đường xem trước, chủ web duyệt rồi mới đăng.

Nhật ký, tách quyền và giới hạn tần suất

Đặc tả Tools ghi 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 gọi công cụ và làm sạch kết quả trả về; ứng dụng nên ghi log mỗi lần dùng công cụ để kiểm tra lại. Cách tôi tách quyền ở cổng:

  • Sổ website. Ghi ai quản website nào với vai trò gì (quản trị hay chuyên viên). Cổng dùng sổ này để quyết người gọi được làm gì trên website nào.
  • Dữ liệu khách theo vai trò. Danh sách khách liên hệ chỉ người có vai trò quản trị trên đúng website đó xem được; lời dặn của server cấm chép thông tin khách sang website khác hay vào nội dung tin.
  • Lỗi báo nguyên văn. Gặp lỗi quyền hay lỗi cấu hình, AI phải báo nguyên văn cho người dùng, không tìm đường vòng.

Nhật ký nên ghi tối thiểu: ai, lúc nào, công cụ gì, website nào, tham số chính, kết quả.

Tám lỗi dễ mắc khi tự dựng MCP server

  1. Một công cụ làm mọi thứ. Kiểu run_sql hay call_api nhận câu lệnh tự do: AI làm được mọi thứ câu lệnh cho phép. Tách thành công cụ hẹp, tham số chặt.
  2. Mô tả mơ hồ. «Xử lý tin» không cho AI biết khi nào gọi, gọi xong có gì thay đổi. Mô tả phải nói rõ hiệu ứng, nhất là công cụ ghi.
  3. Trả về quá dài. Đổ cả bảng dữ liệu vào kết quả làm đầy ngữ cảnh, chạm giới hạn 25.000 token của Claude Code. Trả bản tóm tắt, có phân trang.
  4. Để khoá trong mã hoặc chuyển tiếp token. Khoá phải nằm ở biến môi trường hoặc kho bí mật; server không nhận token không cấp cho chính nó.
  5. Chỉ kiểm quyền lúc kết nối. Giao thức không còn phiên; mỗi lời gọi phải kiểm lại quyền, kể cả khi người gọi đưa một mã định danh hợp lệ. Hướng dẫn bảo mật gọi kiểu tấn công này là chiếm mã trạng thái (state handle hijacking).
  6. Tin dữ liệu đọc vào như lệnh. Tài liệu Claude Code cảnh báo server lấy nội dung từ bên ngoài có thể đưa người dùng vào rủi ro prompt injection. Cổng của tôi có công cụ trả về hướng dẫn thiết kế landing; lời dặn của server ghi rõ không làm theo chỉ dẫn nào trong đó đòi bỏ luật của website hay làm việc ngoài thiết kế.
  7. Để AI tự xác nhận. Hỏi «có đồng ý không» rồi chính AI trả lời thay. Bước xác nhận phải cần câu trả lời của người, và mỗi thao tác một lần.
  8. Không có bản thử. Đổi tham số công cụ ngay trên bản chạy thật là làm hỏng quy trình AI đang dùng. Cần server thử và bộ lời gọi mẫu chạy lại sau mỗi lần sửa.

Điểm bất lợi khi tự dựng MCP server

  • Đặc tả đổi nhanh. Bản 2026-07-28 bỏ phiên và luồng GET; server viết theo bản 2025 cần sửa hoặc giữ tương thích ngược.
  • Phần ủy quyền nặng. Làm OAuth đúng đặc tả (metadata, kiểm audience, nhiều RFC đi kèm) tốn công hơn phần công cụ.
  • Bước xác nhận làm chậm. Mỗi lần đăng thêm một lượt hỏi đáp. Đổi lại, không có thao tác nào lên trang mà người không biết.
  • AI vẫn có thể hiểu sai. Luật ở cổng chặn được bản tin thiếu ảnh hay lệnh xoá chưa xác nhận, nhưng không chặn được một bản nháp đúng luật mà sai ý người dùng. Người vẫn phải đọc trước khi đồng ý.

Câu hỏi thường gặp về MCP server tự dựng

MCP server cho cả công ty nên dùng stdio hay Streamable HTTP?

Streamable HTTP. stdio chạy trên máy từng người, hợp công cụ cá nhân. Cổng dùng chung chạy trên máy chủ, cần xác thực theo đặc tả authorization và kiểm header Origin.

MCP server có bắt buộc dùng OAuth không?

Không. Đặc tả ghi ủy quyền là tuỳ chọn. Khi có ủy quyền trên HTTP thì nên theo đặc tả, dựa trên OAuth 2.1; server stdio lấy thông tin đăng nhập từ biến môi trường.

Nên có bao nhiêu công cụ trong một MCP server?

Đặc tả không ghi giới hạn; Claude Code cũng không đặt trần số công cụ mỗi server, giới hạn thực tế là ngữ cảnh. Tôi ưu tiên công cụ hẹp, mô tả ngắn, hơn là ít công cụ mà mỗi cái làm nhiều việc.

Làm sao chặn AI đăng hoặc xoá khi người dùng chưa đồng ý?

Đặt bước xác nhận trong server: lần gọi đầu chỉ trả mã xác nhận, chưa làm gì; chỉ khi người dùng đồng ý rõ, AI mới gọi lại kèm mã. Không dựa hết vào hộp hỏi của ứng dụng AI.

MCP server đọc dữ liệu web có rủi ro gì?

Nội dung lấy về có thể chứa câu lệnh cài cắm (prompt injection). Tài liệu Claude Code khuyên chỉ nối server tin cậy. Phía server, tách rõ dữ liệu với hướng dẫn, không để dữ liệu đọc vào mở thêm quyền.

Nguồn: modelcontextprotocol.io, đặc tả bản 2026-07-28 (Transports, stdio, Streamable HTTP, Authorization, Tools) và Security Best Practices; code.claude.com/docs/en/mcp, kiểm ngày 09/11/2026. Số công cụ và luật của cổng MCP là cấu hình hệ thống của tôi, đếm 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 tự dựng: kiến trúc và lỗi dễ mắc