Bài trước bạn đã chạy một MCP server ngay trên máy mình. Bài này đi bước tiếp theo: đưa một remote MCP server (máy chủ MCP chạy trên internet) vào Claude dưới dạng custom connector. Bạn sẽ hiểu máy chủ cần đáp ứng điều gì, chọn kiểu đăng nhập nào cho đúng, và những rủi ro an toàn phải kiểm soát khi tự xây kết nối riêng.
Custom connector khác MCP cục bộ ở điểm nào?
Một MCP server có thể chạy theo hai cách:
| MCP cục bộ / Desktop extension | Custom connector (remote MCP) | |
|---|---|---|
| Chạy ở đâu | Trên máy tính của bạn | Trên máy chủ có địa chỉ URL |
| Ai kết nối tới | Claude Desktop, qua mạng máy bạn | Hạ tầng đám mây của Anthropic |
| Dùng được ở | Claude Desktop | claude.ai, Desktop, Cowork, di động, Claude Code |
Custom connector có trên mọi gói: Free, Pro, Max, Ultra, Team và Enterprise. Riêng gói Free chỉ thêm được một custom connector.
Điều kiện bắt buộc: máy chủ phải “nhìn thấy” từ internet
Đây là lỗi hay gặp nhất. Claude không gọi máy chủ từ máy tính của bạn mà từ đám mây của Anthropic. Máy chủ trong mạng nội bộ, sau VPN hoặc bị tường lửa chặn sẽ không kết nối được, dù bạn mở được nó trên máy mình.
Địa chỉ máy chủ là HTTPS, dạng https://mcp.example.com/mcp. Nếu máy chủ là nội bộ, hãy cho phép (allowlist) các dải IP
của Anthropic trong tường lửa; danh sách IP nằm trên trang IP addresses trong tài liệu của Anthropic.
Tự xây remote MCP server: những gì cần chuẩn bị
Nếu bạn (hoặc lập trình viên của bạn) tự viết máy chủ, tài liệu “Build an MCP server for Claude” trên claude.com nêu các quyết định chính:
- Giao thức truyền (transport): dùng Streamable HTTP. Claude vẫn hỗ trợ HTTP+SSE kiểu cũ nhưng chuẩn này đang dần bị thay thế.
- Cách đăng nhập: OAuth 2.0 (mỗi người một tài khoản), thông tin đăng nhập cố định qua request header, hoặc không đăng nhập. Nên quyết định trước khi viết công cụ.
- Nội dung cung cấp: tools, prompts và resources. Claude chưa hỗ trợ resource subscriptions và sampling.
- Giới hạn: trên claude.ai và Desktop, mỗi kết quả công cụ tối đa khoảng 150.000 ký tự, mỗi lần gọi công cụ chờ tối đa 240 giây.
- Kiểm thử: thêm máy chủ vào Claude như một custom connector rồi thử trực tiếp; dùng MCP Inspector để kiểm tra luồng đăng nhập.
Với OAuth, nhớ cho phép địa chỉ callback https://claude.ai/api/mcp/auth_callback.
Thêm custom connector vào Claude
Gói cá nhân (Free, Pro, Max, Ultra)
- Vào Customize → Connectors.
- Bấm + Add rồi chọn Add custom connector (một số giao diện ghi Custom → Web).
- Nhập tên hiển thị và địa chỉ MCP server URL, bấm Continue.
- Xem lại cài đặt đăng nhập Claude tự phát hiện, chọn tùy chọn phù hợp (xem mục dưới), rồi bấm Add.
Gói Team và Enterprise
Trên Team, chỉ Owner và Primary Owner được thêm custom connector; trên Enterprise còn có người mang vai trò tùy chỉnh có quyền quản lý thư viện. Owner vào Organization settings → Connectors, bấm Add, chọn Custom → Web và làm các bước tương tự. Sau đó từng thành viên vào Customize → Connectors, tìm connector có nhãn Custom và bấm Connect để đăng nhập bằng tài khoản của mình.
Chọn kiểu đăng nhập cho đúng
Ở mục Authentication bạn có ba lựa chọn:
- Sign in now: mỗi người phải đăng nhập qua OAuth trước khi dùng.
- Sign in when needed: kết nối trước, chỉ hỏi đăng nhập khi máy chủ yêu cầu.
- No sign in: ai có URL cũng dùng được. Nếu máy chủ dùng API key, chọn mục này và thêm key ở Request headers.
Ở mục OAuth client, tùy chọn được khuyên dùng là Use Claude’s published identity (máy chủ phải hỗ trợ); ngoài ra có Register automatically và Use your own OAuth client.
Request headers lưu API key hoặc bearer token để Claude gửi kèm mọi yêu cầu (tối đa bốn header; tài liệu ghi đang
beta cho một số tổ chức). Claude gửi đúng giá trị bạn nhập, nên với Authorization hãy gõ cả tiền tố Bearer .
Lưu ý: không sửa được phần đăng nhập sau khi đã thêm. Muốn đổi, bạn xóa connector (Remove hoặc menu ba chấm) rồi thêm lại.
Ví dụ thực tế: Một cửa hàng online có API quản lý đơn hàng. Lập trình viên dựng một remote MCP server với hai công cụ “tra đơn” và “cập nhật trạng thái”, dùng OAuth để mỗi nhân viên đăng nhập bằng tài khoản riêng. Sau khi Owner thêm connector, nhân viên có thể hỏi: “Liệt kê các đơn hôm qua chưa giao, nhóm theo tỉnh. Chưa cập nhật gì cả, chỉ cho tôi xem danh sách.”
An toàn khi dùng kết nối tự xây
Anthropic không kiểm định dịch vụ bạn thêm qua custom connector. Công cụ có thể đọc, tạo, sửa, xóa dữ liệu và hành động thay bạn, nên:
- Chỉ kết nối máy chủ của tổ chức bạn tin tưởng; đọc kỹ các quyền (OAuth scopes) và thu hẹp nếu được.
- Cảnh giác với prompt injection: máy chủ xấu có thể giấu chỉ dẫn trong dữ liệu trả về.
- Trên Team/Enterprise, thông tin đăng nhập cố định được dùng chung, nên chọn loại có quyền hạn hẹp.
- Chỉ bấm Allow always với máy chủ thật sự tin cậy. Khi chạy Research, Claude có thể gọi công cụ mà không hỏi lại, nên tắt công cụ có quyền ghi.
Những điều bạn học được trong bài này
- Custom connector nối Claude với remote MCP server qua URL, có trên mọi gói (Free giới hạn 1 cái)
- Claude gọi máy chủ từ đám mây Anthropic, nên máy chủ phải truy cập được qua internet hoặc allowlist IP của Anthropic
- Tự xây máy chủ: dùng Streamable HTTP, chọn kiểu đăng nhập trước, tôn trọng giới hạn 150.000 ký tự và 240 giây
- Ba kiểu đăng nhập: Sign in now, Sign in when needed, No sign in; API key đặt ở Request headers
- Team/Enterprise: Owner thêm connector, từng thành viên tự Connect
- Chỉ kết nối máy chủ tin cậy, giới hạn quyền và để ý prompt injection
Cần nhớ: Custom connector là “cửa riêng” bạn tự mở cho Claude vào một dịch vụ chưa được Anthropic kiểm định. Hãy cấp quyền ở mức tối thiểu, thử trước với dữ liệu không quan trọng, và luôn xem lại các thao tác ghi hoặc xóa trước khi cho phép.
Nguồn tham khảo: Get started with custom connectors using remote MCP – Claude Help Center; Build an MCP server for Claude – Claude Docs; Add a connector that isn’t in the directory – Claude Docs
Câu hỏi thường gặp
Máy chủ chạy tốt trên máy tôi, sao Claude báo không kết nối được?
Vì Claude gọi máy chủ từ đám mây của Anthropic, không phải từ máy bạn. Máy chủ sau VPN, mạng nội bộ hay tường lửa sẽ không tới được. Hãy đưa máy chủ ra internet công cộng hoặc allowlist dải IP của Anthropic.
Tôi muốn đổi API key của connector thì làm sao?
Phần đăng nhập (OAuth hay request header) không sửa được sau khi thêm. Bạn xóa connector trong Customize → Connectors rồi thêm lại với key mới; nếu là connector của tổ chức, các thành viên cần kết nối lại.
