Mục Lục Hướng Dẫn
Nếu bạn theo dõi các bài về Claude Code, Codex hay OpenCode, chắc hẳn đã nhiều lần bắt gặp cụm từ MCP server. Đây không phải thuật ngữ riêng của một nhà cung cấp — mà là một chuẩn mở đang trở thành “cổng USB-C” của thế giới AI: một cách thống nhất để bất kỳ ứng dụng AI nào cũng có thể cắm vào dữ liệu và công cụ bên ngoài.
Bài viết này giải thích MCP từ góc độ thực tế, cập nhật theo đặc tả phiên bản 2026-07-28 mới nhất, và hướng dẫn bạn tự viết một MCP server chạy được ngay.
1. MCP là gì và vì sao nó quan trọng?
Model Context Protocol (MCP) là một chuẩn mở do Anthropic khởi xướng, dùng để kết nối các ứng dụng AI với các hệ thống bên ngoài: tệp tin local, cơ sở dữ liệu, API, công cụ tìm kiếm, hay thậm chí là Blender — như cách Agent Skills giúp agent nạp quy trình theo nhu cầu.
Hãy dùng hình ảnh ẩn dụ chính thức từ tài liệu MCP: MCP giống như cổng USB-C. Trước đây, mỗi app AI muốn nói chuyện với Google Calendar, Notion hay cơ sở dữ liệu phải tự viết một connector riêng — “một sợi cáp cho mỗi thiết bị”. MCP chuẩn hóa cái cổng đó lại: viết connector một lần, dùng được ở mọi nơi.
Hiện MCP được hỗ trợ rộng rãi: Claude, ChatGPT, VS Code, Cursor, Windsurf, OpenCode và nhiều runtime khác. Đây là lý do khi cấu hình một MCP server trong OpenCode, bạn có thể dùng chính cái server đó trong Claude Desktop hay Cursor mà không sửa code.
2. Kiến trúc: Host, Client, Server
MCP dùng mô hình client-server với ba thành phần:
- MCP Host: chính là ứng dụng AI mà bạn dùng — Claude Code, OpenCode, VS Code. Host quản lý một hoặc nhiều client.
- MCP Client: một component do host tạo ra cho mỗi server. Mỗi client giữ một kết nối riêng, chuyên biệt với server tương ứng.
- MCP Server: chương trình cung cấp ngữ cảnh (context) cho client. Nó có thể chạy ngay trên máy bạn (local) hoặc trên máy chủ từ xa (remote).
Ví dụ thực tế: khi OpenCode kết nối đến một filesystem server và một database server, runtime sẽ tạo hai client object riêng biệt — mỗi cái giữ một kết nối riêng. Đây là lý do bạn có thể bật/tắt từng server độc lập trong cấu hình.
Hai lớp của giao thức
MCP gồm hai lớp, và bạn nên phân biệt rõ vì nó ảnh hưởng đến cách bạn viết server:
- Data layer (lớp dữ liệu): định nghĩa giao thức JSON-RPC 2.0 dùng cho trao đổi giữa client và server — khám phá năng lực, các primitive (tools, resources, prompts) và thông báo.
- Transport layer (lớp vận chuyển): định nghĩa kênh truyền. MCP hỗ trợ hai cơ chế:
- STDIO: dùng stdin/stdout để giao tiếp trực tiếp giữa các tiến trình trên cùng một máy — không có chi phí mạng, hợp cho server local.
- Streamable HTTP: dùng HTTP POST, có thể kèm Server-Sent Events để stream. Dành cho server từ xa, hỗ trợ bearer token, API key, custom header — MCP khuyến nghị dùng OAuth.
3. Ba primitive quan trọng nhất
Đây là phần “cốt lõi” mà bạn sẽ dùng nhiều nhất. MCP định nghĩa 3 primitive mà server có thể exposing:
| Primitive | Là gì | Ví dụ | Phương thức |
|---|---|---|---|
| Tools | Hàm có thể thực thi để AI “làm việc” | Đọc file, gọi API, query database | tools/list, tools/call |
| Resources | Nguồn dữ liệu cung cấp ngữ cảnh | Nội dung file, bản ghi DB, response API | resources/list, resources/read |
| Prompts | Mẫu tương tác dùng lại được | System prompt, few-shot examples | prompts/list, prompts/get |
Client sẽ gọi */list để khám phá xem server có gì, sau đó đưa danh sách tools cho model. Khi model quyết định dùng tool, app chặn lời gọi đó, chuyển tiếp tới đúng server qua tools/call, rồi trả kết quả ngược lại cho model. Thiết kế này giúp việc liệt kê tools được động — bạn thêm tool mới, client thấy ngay.
Ngoài ra, MCP còn có primitive phía client đáng chú ý: Elicitation (elicitation/create) — cho phép server hỏi thêm thông tin hoặc xác nhận hành động từ người dùng. Đây là cơ chế để các thao tác nhạy cảm không bị tự động thực hiện.
4. Điểm mới trong spec 2026-07-28 (đáng chú ý)
Nếu bạn từng đọc hướng dẫn MCP cũ, sẽ thấy một vài thay đổi lớn ở phiên bản mới — đây là lý do nhiều tutorial trên mạng bị lỗi thời:
- Khám phá bằng
server/discover: thay vì chỉ dựa vào handshakeinitialize, client gửiserver/discoverđể lấy phiên bản, năng lực và danh tính server. Kết quả thường có thể cache lại. - Mọi request đều mang
_meta: chứaio.modelcontextprotocol/protocolVersion, thông tin client và capability. MCP hiện là stateless — mỗi request tự chứa đủ thông tin, server không suy luận từ request trước. - Roots, Sampling, Logging đã bị deprecated (từ bản 2026-07-28). Thay vào đó: truyền đường dẫn qua tham số tool/URI, tích hợp trực tiếp với API của LLM provider, và log ra
stderrhoặc OpenTelemetry. - Tương thích ngược: SDK TypeScript mới dùng
serveStdio()— tự đàm phán phiên bản, nên cùng một server trả lời được cả client 2026 lẫn client dùng handshakeinitializeđời 2025.
5. Tự tạo MCP Server đầu tiên (TypeScript)
Chúng ta sẽ làm một server tối giản với một tool trả về thời gian hiện tại. Đây là “Hello World” của MCP — đủ để bạn hiểu vòng lặp mà không bị rối bởi cấu hình phức tạp.
Bước 1: Khởi tạo dự án
mkdir my-mcp-server
cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/server zod
npm install -D @types/node typescript
Thêm vào package.json: "type": "module". Tạo file tsconfig.json với target: ES2022, module: Node16, outDir: ./build, rootDir: ./src.
Bước 2: Viết server
Tạo src/index.ts:
import { McpServer } from "@modelcontextprotocol/server";
import { serveStdio } from "@modelcontextprotocol/server/stdio";
function createServer() {
const server = new McpServer({
name: "my-server",
version: "1.0.0",
});
server.registerTool(
"get_time",
{
description: "Trả về thời gian hiện tại theo múi giờ Việt Nam",
inputSchema: {},
},
async () => ({
content: [
{
type: "text",
text: new Date().toLocaleString("vi-VN", {
timeZone: "Asia/Ho_Chi_Minh",
}),
},
],
})
);
return server;
}
serveStdio(createServer, {
onerror: (e) => console.error("MCP error:", e),
});
Lưu ý cực kỳ quan trọng: với STDIO, không bao giờ dùng console.log() — nó ghi ra stdout và sẽ làm hỏng các thông điệp JSON-RPC. Hãy dùng console.error() để log ra stderr. Đây là lỗi kinh điển khiến server “chạy nhưng client không thấy tool”.
Bước 3: Build và kiểm tra
npm run build
npx @modelcontextprotocol/inspector --cli node build/index.js
--protocol-era modern --method tools/list
Kết quả phải liệt kê được tool get_time. Chạy thêm lần nữa với --protocol-era legacy để kiểm tra tương thích ngược với client đời 2025.
Bước 4: Kết nối vào host
Ví dụ với Claude Desktop, mở file cấu hình (%AppData%Claudeclaude_desktop_config.json trên Windows) và thêm:
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["C:PATHTOmy-mcp-serverbuildindex.js"]
}
}
}
Lưu lại và khởi động lại ứng dụng. Biểu tượng MCP sẽ xuất hiện khi có ít nhất một server được cấu hình đúng.
6. Top MCP server đáng cài cho dân AI Agent
Tự viết server là một chuyện, nhưng sức mạnh thực sự của MCP nằm ở hệ sinh thái có sẵn. Một số cái tên đáng thử:
- Filesystem: cho phép agent đọc/ghi các thư mục bạn chỉ định — nền tảng cho mọi tác vụ xử lý tệp local.
- GitHub: tạo issue, đọc PR, quản lý repo trực tiếp từ cửa sổ chat.
- PostgreSQL / SQLite: để chatbot truy vấn cơ sở dữ liệu bằng ngôn ngữ tự nhiên.
- Fetch / Web search: lấy nội dung web theo thời gian thực, khắc phục hạn chế “kiến thức cũ” của model.
- Sentry: đọc lỗi production và gợi ý sửa — ví dụ kinh điển trong tài liệu chính thức của MCP.
- Blender MCP: điều khiển Blender bằng lệnh, tạo mô hình 3D từ mô tả.
Khi cài nhiều server cùng lúc, hãy cẩn trọng với quyền truy cập — mỗi server là một “cổng” có thể thực thi hành động thay bạn. Nguyên tắc: chỉ cấp quyền tối thiểu cần thiết và dùng cơ chế Elicitation để xác nhận các thao tác nhạy cảm.
7. MCP và Agent Skills: khác nhau thế nào?
Đây là câu hỏi hay gặp trong cộng đồng,nhất là với độc giả đã đọc bài về Agent Skills:
- Agent Skills là cách đóng gói quy trình, script và tiêu chuẩn thành một thư mục mà agent nạp theo nhu cầu — giống như “sổ tay hướng dẫn công việc”.
- MCP là chuẩn giao tiếp để agent kết nối với dữ liệu và công cụ bên ngoài — giống như “ổ cắm và dây cáp”.
Hai khái niệm này bổ trợ cho nhau, không thay thế. Bạn có thể viết một Agent Skill hướng dẫn agent cách dùng một MCP server cụ thể — và thực tế nhiều bộ skill chất lượng cao đã làm vậy.
FAQ
MCP có phải là sản phẩm của riêng Anthropic không?
Không. Đây là chuẩn mở (open protocol) được cộng đồng và nhiều công ty như OpenAI, Microsoft hỗ trợ. Bạn có thể tự implement server/client theo đặc tả.
Tôi có cần viết server bằng TypeScript không?
Không. Có SDK chính thức cho Python, TypeScript, Java, Kotlin, C# và nhiều ngôn ngữ khác. Chọn ngôn ngữ bạn thuần thục nhất.
MCP có làm agent chậm đi không?
Bản thân giao thức rất nhẹ, đặc biệt với STDIO. Độ trễ thường đến từ API bên ngoài mà server gọi tới, chứ không phải từ MCP.
Làm sao debug MCP server?
Dùng MCP Inspector (@modelcontextprotocol/inspector) — công cụ chính thức để liệt kê tool, gọi thử và xem thông điệp JSON-RPC trao đổi giữa client và server.
Tài liệu tham khảo: modelcontextprotocol.io — phần Introduction, Architecture và Build an MCP Server (spec 2026-07-28).
