MCP server là gì? Giải thích dễ hiểu kèm ví dụ thật với ZoCloud
MCP server là một chương trình cung cấp công cụ cho AI theo chuẩn mở Model Context Protocol (MCP). Thay vì chỉ trả lời bằng chữ, AI như Claude, ChatGPT hay Cursor đọc danh sách công cụ mà MCP server khai báo, rồi gọi chúng để làm việc thật: đọc file, truy vấn dữ liệu, deploy app. Ví dụ với ZoCloud: khi bạn nói "deploy app này", agent gọi công cụ deploy_folder của MCP server ZoCloud và nhận lại link HTTPS.
MCP giải quyết vấn đề gì
Một mô hình ngôn ngữ tự nó chỉ sinh ra chữ. Muốn nó làm việc với hệ thống bên ngoài, trước đây mỗi ứng dụng AI phải tự viết tích hợp riêng cho từng dịch vụ: plugin cho ứng dụng này, "function calling" theo kiểu của ứng dụng kia. Mỗi dịch vụ phải làm lại nhiều lần.
MCP chuẩn hoá phần này, giống cách cổng USB chuẩn hoá việc cắm thiết bị:
- Dịch vụ viết một MCP server, mô tả các công cụ của mình.
- Mọi ứng dụng AI hỗ trợ MCP (gọi là client, hay host) đều dùng được server đó.
Chuẩn này do Anthropic công bố và hiện được nhiều công cụ AI hỗ trợ, như Claude Code, Claude Desktop, Claude.ai, Cursor và ChatGPT.
Các khái niệm chính
| Khái niệm | Ý nghĩa |
|---|---|
| Host / client | Ứng dụng AI bạn đang dùng (Claude Code, Cursor, ChatGPT…), kết nối tới MCP server |
| MCP server | Chương trình cung cấp khả năng cho AI |
| Tool (công cụ) | Một hành động có tên, mô tả và tham số (ví dụ logs nhận target, trả về log) |
| Resource, prompt | Dữ liệu và mẫu lời nhắc server có thể cung cấp thêm; nhiều server chỉ dùng tool |
| Transport | Cách client và server nói chuyện: stdio (chương trình trên máy) hoặc HTTP (server từ xa) |
Luồng làm việc điển hình:
- Client kết nối, hỏi server "anh có những công cụ gì?".
- Server trả về danh sách: tên, mô tả, tham số theo JSON Schema.
- Khi bạn yêu cầu, mô hình chọn công cụ phù hợp và điền tham số.
- Client gửi lời gọi, server thực hiện và trả kết quả.
- Mô hình đọc kết quả, quyết định bước tiếp theo (gọi thêm công cụ, hay trả lời bạn).
Điều quan trọng: mô hình không tự có quyền gì. Mọi việc nó làm đều đi qua công cụ, và công cụ chỉ làm được những gì server cho phép với thông tin xác thực bạn cung cấp.
Hai kiểu MCP server: trên máy và từ xa
MCP stdio (chạy trên máy bạn)
Client khởi động MCP server như một chương trình con và trao đổi qua đầu vào, đầu ra chuẩn. Server chạy với quyền trên máy bạn, nên làm được việc như đọc thư mục dự án. Xác thực với dịch vụ thường bằng token đặt trong biến môi trường.
Hợp với: agent lập trình trên máy (Claude Code, Cursor, Claude Desktop), khi agent cần đụng tới file của bạn.
MCP từ xa (remote MCP qua HTTPS)
Server là một địa chỉ HTTPS. Client kết nối qua mạng, và người dùng đăng nhập bằng OAuth: bạn được đưa tới trang của dịch vụ, xem ứng dụng xin quyền gì, bấm cho phép. Ứng dụng AI nhận một token có thời hạn, không bao giờ thấy mật khẩu của bạn.
Hợp với: ChatGPT, Claude.ai và các ứng dụng chạy trên web, không cài được chương trình trên máy bạn.
Ví dụ thật: MCP server của ZoCloud
ZoCloud là nền tảng deploy app, database, tên miền tại Việt Nam. Nó có cả hai kiểu MCP server.
zo mcp: MCP server trên máy
Cài zo CLI và tạo token ở Tài khoản → Token truy cập → Tạo token:
curl -fsSL https://app.zocloud.io/install.sh | sh
zo version
Khai báo với Claude Code:
claude mcp add zocloud -e ZOCLOUD_TOKEN=zc_pat_… -- zo mcp
Hoặc với Cursor, Claude Desktop (file .cursor/mcp.json hay cấu hình mcpServers):
{
"mcpServers": {
"zocloud": {
"command": "zo",
"args": ["mcp"],
"env": { "ZOCLOUD_TOKEN": "zc_pat_…" }
}
}
}
Vì chạy trên máy, zo mcp có thêm hai công cụ cần đọc thư mục: detect (ZoCloud sẽ build thư mục thế nào) và deploy_folder (tải thư mục lên và deploy). Hướng dẫn chi tiết cho từng agent ở bài vibe coding, deploy từ Cursor và Claude Code.
https://app.zocloud.io/mcp: MCP server từ xa
Trong ChatGPT hay Claude.ai, bạn thêm một connector với URL https://app.zocloud.io/mcp, chọn xác thực OAuth. Ứng dụng mở trang ZoCloud: bạn đăng nhập, chọn tổ chức mà ứng dụng được làm việc, xem danh sách việc nó được làm và bấm Cho phép.
Server từ xa không đọc được file trên máy bạn, nên thay cho deploy_folder là deploy_files: AI gửi kèm các file nó vừa viết (tối đa 8 MB, 2.000 file). Build lâu thì AI nhận trạng thái "đang build" và theo dõi tiếp bằng wait_deployment. Cách thêm connector từng bước ở bài deploy app từ ChatGPT và Claude.
Các công cụ ZoCloud cung cấp
Công cụ nhận target dạng tổ-chức/project/service (thêm @staging cho environment khác):
| Nhóm | Công cụ |
|---|---|
| Tài khoản | whoami |
| Deploy | detect, deploy_folder (chỉ zo mcp), deploy_files, wait_deployment, deploy_repo, deploy_image, list_templates, deploy_template |
| Vận hành | status, logs, set_variables, scale, rollback, add_volume, set_cron, run_cron |
| Environment | list_environments, create_environment |
| Database | create_database, database_public |
| Storage | create_bucket |
| Tên miền | add_domain, check_domain, buy_domain, list_domains, dns_records, set_dns_record, remove_dns_record |
| AI | ai_models, create_ai_key, ai_usage |
Một yêu cầu như "Deploy thư mục này vào myorg/shop/web, thêm PostgreSQL và gắn DATABASE_URL" thường thành chuỗi gọi: whoami → detect → create_database → set_variables (DATABASE_URL=${{pg.DATABASE_URL}}) → deploy_folder → nếu lỗi thì logs, sửa code, deploy lại.
An toàn khi cho AI dùng MCP server
MCP trao cho AI khả năng hành động thật, nên nguyên tắc chung là: cấp ít quyền nhất đủ để làm việc, và chọn MCP server có rào chắn ở phía server, không chỉ dựa vào việc mô hình "ngoan".
Cách ZoCloud đặt các rào chắn đó:
Phạm vi token
- Token mang đúng quyền của bạn theo vai trò trong tổ chức. Khi tạo token, chọn Tổ chức để giới hạn trong một tổ chức (token khi đó cũng không đụng tới tài khoản của bạn: không đổi mật khẩu, không tạo token mới).
- Chọn Chỉ đọc nếu agent chỉ cần xem log, trạng thái: mọi công cụ thay đổi như deploy,
set_variables,create_databaseđều bị từ chối. - Đặt Số ngày hiệu lực ngắn, thu hồi khi xong. Danh sách token ghi Dùng lần cuối.
- Kết nối OAuth từ ChatGPT, Claude.ai làm việc trong tổ chức bạn chọn lúc cho phép, hiện trong Tài khoản → Token truy cập với tên ứng dụng; xoá ở đó là ngắt ngay.
Bí mật không đi theo code
deploy_folder và zo deploy không bao giờ gửi file .env* (trừ .env.example), và bỏ qua .git, node_modules, các mẫu trong .gitignore. Khoá API, mật khẩu được đặt bằng set_variables, lưu mã hoá.
Tiêu tiền cần đúng giá đã đồng ý
buy_domain chỉ chạy sau check_domain và phải kèm confirm_price_vnd đúng giá đã báo cho bạn; giá đổi thì không mua gì. Qua kết nối từ xa (ChatGPT, Claude.ai), mặc định không mua được: xem giá thì được, còn mua thì trong portal hoặc qua zo mcp.
Xem lại mọi việc
Mục Hoạt động của tổ chức ghi lại mọi thao tác, kể cả qua token. Đặt thêm Giới hạn chi tiêu cho phần dùng vượt gói để không có bất ngờ.
Một rủi ro chung của MCP cần biết: prompt injection. Nội dung agent đọc được (trang web, file, log) có thể chứa lời nhắc độc hại để lừa agent gọi công cụ. Rào chắn phía server như trên giới hạn thiệt hại; bạn vẫn nên đọc kỹ trước khi đồng ý các bước quan trọng, và không cấp token rộng hơn cần thiết.
Tự viết MCP server?
Nếu bạn muốn cho AI dùng hệ thống nội bộ của mình, có SDK MCP chính thức cho nhiều ngôn ngữ (TypeScript, Python, Go…). Vài kinh nghiệm từ việc làm MCP server của ZoCloud:
- Mô tả công cụ rõ ràng: mô hình chọn công cụ dựa vào tên và mô tả. Ghi rõ khi nào dùng, khi nào không.
- Trả lỗi có hướng dẫn bước tiếp theo, để agent tự sửa thay vì đoán.
- Hành động nguy hiểm cần xác nhận ở phía server (như
confirm_price_vnd), không chỉ dặn trong mô tả. - Xác thực theo người dùng, không dùng một khoá chung cho mọi người.
Tài liệu đầy đủ của ZoCloud: zo CLI và MCP server, thành viên và token. Có thể bắt đầu thử ngay với gói Dùng thử miễn phí.