Bốn cấp vừa qua, mọi thứ Claude biết đều nằm trong repo: code, CLAUDE.md, skill, subagent. Nhưng công việc thật còn ở chỗ khác: issue trên GitHub, lỗi trên Sentry, dữ liệu trong database, thiết kế trên Figma. Nếu bạn đang chép tay từ các tab đó vào chat, cấp này dành cho bạn. Bài đầu tiên giải thích MCP là gì, nó khác skill ở đâu, và nối thử một server không cần tài khoản.
MCP là gì
MCP (Model Context Protocol) là một chuẩn mã nguồn mở để nối AI với công cụ bên ngoài. Một MCP server là phần đứng giữa: một bên nói chuyện với dịch vụ (GitHub, database, trình duyệt…), bên kia đưa cho Claude Code những công cụ để dùng dịch vụ đó.
Dấu hiệu bạn cần MCP rất rõ: bạn cứ chép dữ liệu từ một công cụ khác vào chat. Mở issue, copy nội dung, dán cho Claude. Mở dashboard, copy con số, dán tiếp. Nối server rồi, Claude tự đọc và thao tác trực tiếp với hệ thống đó, thay vì làm việc với những gì bạn dán vào.
Vài ví dụ docs đưa ra:
- "Làm tính năng mô tả trong issue ENG-4521 rồi tạo PR trên GitHub."
- "Xem Sentry để biết tính năng đó đang lỗi thế nào."
- "Tìm 10 người dùng đã dùng tính năng này trong database PostgreSQL."
Server có thể chạy trên máy bạn hoặc là dịch vụ host sẵn trên internet. Vì là chuẩn mở, một server viết theo MCP dùng được với các ứng dụng AI khác cũng hỗ trợ MCP, không riêng Claude Code.
Server cung cấp những gì
Một server có thể đưa cho Claude Code ba thứ:
- Tools (công cụ): việc Claude gọi được, như tìm issue, chạy query, mở trang web. Tên công cụ có dạng
mcp__<server>__<công cụ>, ví dụmcp__github__list_issues. Bạn sẽ gặp dạng tên này khi đặt quyền. - Resources (tài nguyên): dữ liệu bạn kéo vào prompt bằng
@, giống nhắc tới một file:@github:issue://123. Gõ@là thấy chúng trong danh sách gợi ý. - Prompts: prompt dựng sẵn của server, hiện thành lệnh slash dạng
/mcp__github__pr_review 456.
Server nào cũng có công cụ; resources và prompts thì tùy server.
Về cách nối, có hai kiểu chính:
- HTTP: server ở trên mạng, bạn đưa một URL. Docs khuyên dùng kiểu này cho server từ xa. Kiểu SSE cũ đã bị bỏ dần.
- stdio: server là một chương trình chạy trên máy bạn, ví dụ
npx some-mcp-server. Hợp với công cụ cần truy cập trực tiếp vào máy.
MCP khác skill ở đâu
Cả hai đều "mở rộng Claude", nên dễ nhầm. Docs phân biệt gọn:
| MCP | Skill | |
|---|---|---|
| Là gì | Giao thức nối với dịch vụ bên ngoài | Kiến thức, quy trình, tài liệu tham khảo |
| Đưa cho Claude | Công cụ và quyền truy cập dữ liệu | Cách làm việc |
| Ví dụ | Nối Slack, query database, điều khiển trình duyệt | Checklist review, quy trình deploy, quy ước API |
Nói ngắn: MCP cho Claude cánh tay để chạm vào hệ thống khác. Skill cho Claude hiểu biết để dùng cánh tay đó cho đúng.
Chúng không thay nhau mà bổ sung cho nhau. Ví dụ với database: MCP server lo kết nối và đăng nhập, còn một skill ghi schema của team và các mẫu query hay dùng. Thiếu MCP, Claude không với tới database. Thiếu skill, Claude với tới được nhưng phải đoán bảng nào chứa gì.
Còn thứ tự thêm vào dự án, docs gợi ý theo dấu hiệu: Claude sai một quy ước hai lần thì sửa CLAUDE.md; dán cùng một quy trình lần thứ ba thì viết skill; cứ chép dữ liệu từ một tab Claude không thấy thì nối MCP.
Server đầu tiên: docs của Claude Code
Docs có sẵn một server host trên mạng, không cần đăng nhập, để tìm kiếm trong tài liệu Claude Code. Dùng nó để làm quen cả quy trình. Chạy trong terminal, không phải trong phiên claude:
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpclaude-code-docs là tên bạn tự đặt. Claude Code dùng tên này để ghi nhãn công cụ và trong các lệnh quản lý. Lệnh in ra "Added HTTP MCP server … to local config" và tên file vừa sửa.
Kiểm tra kết nối:
claude mcp listDòng của server phải có ✔ Connected. Khi thử, chúng tôi còn thấy các connector của tài khoản claude.ai (Google Drive, Gmail…) trong danh sách, vì Claude Code cũng nạp chúng. Các trạng thái khác: ! Needs authentication (cần đăng nhập, bài 5.2), ✘ Failed to connect (server không trả lời).
Dùng thử: mở claude và hỏi:
Use the claude-code-docs server to look up what MCP_TIMEOUT doesNhắc tên server để chắc câu trả lời đi qua server; bình thường Claude tự chọn công cụ phù hợp. Lần đầu có thể bị hỏi quyền, cứ cho phép. Trong output, lần gọi công cụ ghi tên server: đó là bằng chứng câu trả lời đến từ server chứ không phải trí nhớ của Claude. Lần chúng tôi thử, Claude trả lời đúng: thời gian chờ server khởi động, tính bằng mili giây, mặc định 30 giây.
Gỡ khi xong: claude mcp remove claude-code-docs. Trong phiên, gõ /mcp để xem trạng thái các server.
Mặc định claude mcp add lưu server ở scope local: chỉ bạn, chỉ dự án này, trong file ~/.claude.json. Chia sẻ cho team qua .mcp.json là chủ đề bài 5.2.
Chi phí ngữ cảnh
Mỗi server nối vào đều chiếm một ít ngữ cảnh. Claude Code giữ phần đó nhỏ bằng tool search, bật sẵn: lúc mở phiên chỉ nạp tên công cụ và hướng dẫn của server, còn mô tả đầy đủ của từng công cụ chỉ nạp khi Claude cần. Khi thử, chúng tôi thấy đúng như vậy: Claude gọi một bước ToolSearch để nạp hai công cụ của server docs, rồi mới dùng chúng.
Kết quả trả về cũng có giới hạn. Output quá 25.000 token (mặc định, chỉnh bằng MAX_MCP_OUTPUT_TOKENS) hoặc quá 50.000 ký tự được lưu ra file, Claude đọc file đó khi cần. Một lần tìm kiếm của chúng tôi trả về 80 KB và được lưu ra file, không tràn vào hội thoại.
Dù vậy, server không dùng tới vẫn tốn chỗ ở mọi phiên. Gỡ những server bạn không còn dùng.
Tin server trước khi nối
Nối một server là cho Claude dùng công cụ của bên khác, với dữ liệu thật. Docs nhắc rõ: kiểm tra bạn tin server đó trước khi nối. Server lấy nội dung từ bên ngoài (trang web, issue do người lạ viết) có thể mang theo prompt injection: những câu cố ý viết ra để lừa Claude làm điều bạn không muốn.
Quyền với công cụ MCP đặt giống công cụ khác, theo tên:
mcp__claude-code-docskhớp mọi công cụ của server đó;mcp__github__list_issueskhớp một công cụ.
Một cách làm an toàn: cho phép sẵn các công cụ chỉ đọc, còn công cụ ghi hay xóa thì để Claude Code hỏi mỗi lần. Token, quyền và an toàn là chủ đề của bài 5.3. Bài sau, 5.2, nối GitHub và chia sẻ cấu hình server cho cả team qua .mcp.json.