Tích hợp Claude Code MCP: Kết nối Công cụ với Agent

Cập nhật lần cuối: June 28, 2026

Ban đầu, Claude Code đọc và chỉnh sửa các file cũng như chạy các lệnh shell. Nó không thể đọc các issue trên GitHub của bạn, truy vấn cơ sở dữ liệu, hoặc điều khiển một trình duyệt. Model Context Protocol (MCP) đã khắc phục khoảng trống này: nó là tiêu chuẩn cắm giắc cho phép agent giao tiếp với các công cụ và dữ liệu bên ngoài. Hướng dẫn này sẽ chỉ ra chính xác các lệnh claude mcp add, khi nào nên chọn máy chủ cục bộ so với từ xa, cách thức hoạt động của scopes, những máy chủ nào đáng để kết nối, và các kiểm tra bảo mật cần thực hiện trước khi bạn tin tưởng bất kỳ cái nào.

Câu trả lời nhanh: làm thế nào để thêm một máy chủ MCP vào Claude Code?

Bạn đăng ký một máy chủ bằng lệnh claude mcp add, sau đó Claude Code có thể gọi các công cụ của nó trong suốt phiên làm việc.

Đối với một máy chủ cục bộ chạy như một tiến trình trên máy của bạn:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Đối với một máy chủ từ xa được truy cập qua HTTPS:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Sau khi thêm máy chủ, hãy chạy /mcp bên trong Claude Code để xem trạng thái kết nối và hoàn tất bất kỳ đăng nhập OAuth nào. Sử dụng claude mcp list để xác nhận rằng nó đã được đăng ký. Tài liệu tham khảo lệnh chính thức nằm tại Claude Code MCP docs.

MCP là gì, và tại sao nên kết nối nó với Claude Code?

MCP là một giao thức mở, lần đầu tiên do Anthropic xuất bản, xác định cách một client AI và một tool server trao đổi các khả năng. Một máy chủ quảng cáo các công cụ (hành động mà agent có thể thực hiện), các tài nguyên (dữ liệu nó có thể đọc), và các prompt. Bất kỳ client nào nhận biết MCP đều có thể sử dụng bất kỳ máy chủ MCP nào, vì vậy một máy chủ GitHub hoạt động trong Claude Code, một IDE, hoặc một agent khác mà không cần các bộ nối tùy chỉnh. Đặc tả và sổ đăng ký máy chủ nằm tại modelcontextprotocol.io.

Lợi ích thực tế: thay vì dán nội dung issue vào chat, bạn chỉ cần kết nối máy chủ GitHub một lần và yêu cầu agent đọc, gắn nhãn và phản hồi các issue trực tiếp. Để tìm hiểu sâu hơn về giao thức này, hãy xem MCP explainer của chúng tôi, và để biết hướng dẫn toàn diện về công cụ trong ngữ cảnh, hãy tham khảo Claude Code ultimate guide.

Một máy chủ có thể là một script stdio nhỏ mà bạn đã viết, một Docker image, hoặc một điểm cuối SaaS do nhà cung cấp lưu trữ. Claude Code coi tất cả chúng theo cùng một cách khi chúng tuân thủ MCP.

Bạn nên sử dụng loại transport nào: cục bộ hay từ xa?

Transport là cách Claude Code tiếp cận máy chủ. Các máy chủ cục bộ chạy trên máy của bạn qua stdio; các máy chủ từ xa chạy ở nơi khác và phản hồi qua HTTP hoặc SSE. Lựa chọn thường tuân theo nơi dữ liệu được lưu trữ.

Sử dụng máy chủ stdio cục bộ khi công cụ cần các file hoặc dịch vụ trên laptop của bạn, chẳng hạn như một thư mục tài sản dự án hoặc một instance Postgres trên localhost. Sử dụng máy chủ HTTP hoặc SSE từ xa khi nhà cung cấp đã lưu trữ nó, vì bạn bỏ qua việc cài đặt và nhận được bản cập nhật mà không chạm vào cấu hình của mình. Các máy chủ từ xa gần như luôn yêu cầu bạn đăng nhập qua OAuth, điều này bạn kích hoạt từ menu /mcp.

Chọn scope: local, project hay user

Scope quyết định ai thấy máy chủ và nơi nào cấu hình được lưu trữ. Claude Code hỗ trợ ba loại, và việc chọn đúng loại sẽ giữ bí mật khỏi repo của bạn mà vẫn chia sẻ các máy chủ an toàn với nhóm.

Thiết lập scope bằng cờ --scope, ví dụ claude mcp add --scope project .... Scope project ghi một .mcp.json đã được kiểm tra vào repo, vì vậy đừng bao giờ đặt token thô ở đó; thay vào đó hãy tham chiếu đến một biến môi trường. Local scope là mặc định và là nơi an toàn nhất để thử nghiệm máy chủ mới trước khi bạn cam kết chia sẻ nó. Nếu bạn cũng xây dựng Claude Code skills, hãy giữ cho scope của máy chủ và skill nhất quán để đồng đội kéo repo sẽ có một thiết lập hoạt động.

Làm thế nào để thêm một máy chủ bằng claude mcp add?

Mẫu này giống nhau cho mọi máy chủ: một tên, một cờ transport tùy chọn, và lệnh hoặc URL. Dấu phân cách -- đánh dấu sự bắt đầu của lệnh cục bộ và các đối số của nó.

Thêm một máy chủ filesystem cục bộ được giới hạn scope vào một thư mục để agent chỉ có thể chạm vào những gì bạn cho phép:

claude mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem ~/projects/my-app

Truyền các bí mật dưới dạng biến môi trường thay vì mã hóa cứng chúng:

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

Thêm một máy chủ từ xa với transport và URL của nó:

claude mcp add --transport sse linear https://mcp.linear.app/sse

Sau đó quản lý những gì bạn có:

• claude mcp list hiển thị mọi máy chủ đã đăng ký và trạng thái của chúng.
• claude mcp get <name> in cấu hình của một máy chủ.
• claude mcp remove <name> hủy đăng ký nó.
• /mcp (gõ trong phiên) hiển thị trạng thái kết nối trực tiếp và chạy OAuth.

Hãy giữ việc sử dụng cờ gần với tài liệu chính thức; các nhà cung cấp đôi khi thay đổi tên gói hoặc URL của máy chủ, vì vậy hãy sao chép giá trị hiện tại từ README của máy chủ đó thay vì đoán.

Các máy chủ MCP phổ biến đáng kết nối

Bắt đầu bằng một máy chủ loại bỏ một công việc vặt thực sự, chứng minh nó hoạt động, sau đó thêm nhiều hơn nữa. Đây là những thứ mà các nhà phát triển tìm đến trước tiên, và mỗi cái mở khóa điều gì.

Playwright MCP server là nổi bật cho công việc front-end: agent mở trang của bạn, nhấp qua một luồng, và báo cáo những gì bị hỏng kèm theo ảnh chụp màn hình. Máy chủ cơ sở dữ liệu rất hữu ích cho các câu hỏi schema chỉ đọc, nhưng hãy giới hạn scope nó vào một read replica để một truy vấn lạc không bao giờ có thể ghi được. Khi bạn bắt đầu xâu chuỗi nhiều máy chủ lại với nhau, hãy chuyển công việc nặng sang một worker chuyên dụng bằng Claude Code subagents để phiên chính vẫn phản hồi tốt.

Kịch bản: kết nối máy chủ MCP GitHub để mở PRs

Giả sử bạn muốn agent phân loại các issue và mở pull requests trong một repo. GitHub lưu trữ một máy chủ MCP từ xa chính thức, vì vậy bạn không cần cài đặt bất cứ thứ gì cục bộ.

1. Đăng ký máy chủ được lưu trữ:

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/
   

2. Gõ /mcp trong Claude Code, chọn github, và hoàn tất đăng nhập OAuth trong trình duyệt của bạn. Token ở lại với GitHub; bạn không bao giờ dán nó vào một file.

3. Xác nhận các công cụ đã được tải bằng claude mcp list.

4. Bây giờ hãy hỏi bằng ngôn ngữ thông thường:

   • "Liệt kê các issue đang mở có nhãn bug và tóm tắt ba vấn đề hàng đầu."
   • "Mở một PR bản nháp từ fix/login-redirect sang main với mô tả ngắn."
   • "Đọc PR #214 và gắn cờ bất cứ thứ gì chạm đến xác thực (authentication)."

Agent đọc các luồng issue, soạn thảo nội dung PR, và liên kết issue phù hợp, tất cả mà không cần bạn rời khỏi terminal. Hãy cấp quyền truy cập ứng dụng GitHub vào một repository duy nhất trước, xem xét những gì agent đề xuất, và mở rộng quyền truy cập chỉ khi bạn tin tưởng quy trình đó. Danh sách công cụ đầy đủ của máy chủ và tùy chọn tự lưu trữ được tài liệu hóa trong GitHub MCP server repo.

Có an toàn để kết nối một máy chủ MCP không?

Một máy chủ MCP có thể chạy code trên máy của bạn hoặc hành động trên các tài khoản của bạn, vì vậy hãy coi mỗi cái như việc cài đặt một dependency: chỉ kết nối những máy chủ mà bạn tin tưởng. Rủi ro là có thật vì một máy chủ độc hại hoặc bị lỗi có thể rò rỉ file hoặc thực hiện các hành động phá hủy với thông tin xác thực của bạn.

Hãy đi qua danh sách kiểm tra này trước khi thêm máy chủ:

• Xác nhận nguồn gốc. Ưu tiên các máy chủ nhà cung cấp chính thức (GitHub, Sentry) hoặc các máy chủ tham chiếu đã xuất bản hơn là một gói không rõ nguồn gốc.
• Đọc những công cụ nào nó phơi bày. Một máy chủ "đọc issue của tôi" không nên yêu cầu quyền ghi vào toàn bộ ổ đĩa của bạn.
• Giới hạn scope chặt chẽ. Chỉ định các máy chủ filesystem tại một thư mục dự án và các máy chủ cơ sở dữ liệu tại một read replica.
• Giữ bí mật khỏi .mcp.json. Sử dụng biến môi trường và không bao giờ commit token thực tế.
• Cấp quyền tối thiểu trên OAuth. Cho ứng dụng GitHub một repo, chứ không phải toàn bộ org của bạn, cho đến khi bạn tin tưởng nó.
• Xem xét hành động trước khi phê duyệt. Đọc PR hoặc truy vấn mà agent đề xuất; đừng tự động phê duyệt các thao tác ghi từ một máy chủ mới.

Anthropic đánh dấu rủi ro prompt-injection đối với các máy chủ lấy nội dung web không đáng tin cậy, vì vậy hãy đặc biệt thận trọng với bất kỳ máy chủ nào kéo vào các trang tùy ý. Hướng dẫn bảo mật hiện tại nằm trong Claude Code MCP docs.

Khắc phục sự cố kết nối MCP

Hầu hết các lỗi là do cấu hình hoặc xác thực (auth), chứ không phải do giao thức. Hãy làm theo thứ tự này:

• Máy chủ không được liệt kê: chạy lại claude mcp list. Nếu nó bị thiếu, lệnh add có thể đã thất bại; kiểm tra xem có lỗi chính tả nào trong dấu phân cách -- hoặc tên gói hay không.

• Trạng thái hiển thị failed trong /mcp: tiến trình không thể khởi động. Đối với các máy chủ stdio, hãy chạy lệnh thô (ví dụ dòng npx) trong terminal của bạn để xem lỗi thực tế.

• Xác thực thất bại: mở /mcp, chọn máy chủ, và làm lại quy trình OAuth. Đối với các máy chủ dựa trên token, xác nhận rằng biến môi trường đã được đặt trong shell khởi chạy Claude Code.

• Công cụ không xuất hiện: khởi động lại phiên Claude Code để nó tải lại khả năng của máy chủ, sau đó xác minh scope là loại mà dự án hiện tại có thể thấy.

• Scope sai: một máy chủ được thêm với --scope local sẽ không hiển thị cho đồng đội; hãy thêm lại nó với --scope project nếu nó cần được chia sẻ.

Khi một máy chủ từ xa thay đổi URL hoặc một gói được đổi tên, cấu hình đã lưu của bạn sẽ bị lỗi thời (stale). Hãy kéo giá trị hiện tại từ README của máy chủ và thêm lại thay vì chỉnh sửa mù quáng.

Bài học chính

MCP biến Claude Code từ một agent file-and-shell thành một agent có thể giao tiếp với các công cụ thực tế của bạn. Thêm máy chủ bằng claude mcp add, chọn stdio cho dữ liệu cục bộ và HTTP/SSE cho dịch vụ được lưu trữ, và thiết lập scope theo người nên thấy máy chủ đó. Kết nối một máy chủ hữu ích trước, máy chủ GitHub là một khởi đầu mạnh mẽ, và xác minh nguồn gốc cũng như quyền của mọi máy chủ trước khi bạn tin tưởng nó. Giữ token trong biến môi trường, giới hạn phạm vi truy cập filesystem và database, và xem xét hành động của agent cho đến khi một máy chủ mới xứng đáng với sự tin tưởng đó.