Claude - Xây dựng connector riêng với Model Context Protocol (MCP)
Hiểu kiến trúc MCP và tự viết máy chủ MCP để Claude truy cập dữ liệu, công cụ của đơn vị bạn.
- Kiến trúc host – client – server
- Ba thành phần: tools, resources, prompts
- Viết máy chủ MCP bằng Python
- Kết nối với Claude và bảo mật
Cơ sở lý thuyết
MCP (Model Context Protocol) là chuẩn mở do Anthropic tạo ra để ứng dụng AI kết nối với công cụ và dữ liệu – giống "cổng USB-C" cho AI: viết một lần, dùng được với nhiều ứng dụng hỗ trợ MCP.
| Thành phần | Vai trò |
|---|---|
| Host | Ứng dụng AI người dùng tương tác (Claude, Claude Code) |
| Client | Bộ kết nối trong host, giữ một kết nối tới mỗi server |
| Server | Chương trình cung cấp khả năng: dữ liệu, công cụ |
| Khả năng | Ý nghĩa | Ví dụ |
|---|---|---|
| Tools | Hàm mô hình được gọi để thực hiện hành động | Tra điểm, tạo phiếu yêu cầu |
| Resources | Dữ liệu đọc được qua URI | Quy chế, danh mục học phần |
| Prompts | Mẫu prompt dựng sẵn | "Soạn thông báo lịch thi" |
- Hai kiểu truyền: stdio (máy chủ chạy cục bộ) và HTTP (máy chủ từ xa – dùng làm custom connector trên claude.ai).
- Custom connector kết nối từ hạ tầng đám mây của Anthropic, nên máy chủ phải truy cập được qua Internet; xác thực bằng OAuth.
- Bảo mật: mô tả công cụ rõ ràng, phân quyền theo người dùng, ghi nhật ký, chỉ mở dữ liệu cần thiết.
Máy chủ MCP tối giản (Python)
pip install "mcp[cli]"from mcp.server.fastmcp import FastMCP
mcp = FastMCP("dao-tao")
HOC_PHAN = {"WEB01": "Lập trình web – 3 TC", "CSDL01": "Cơ sở dữ liệu – 3 TC"}
@mcp.tool()
def tra_hoc_phan(ma: str) -> str:
"""Tra tên và số tín chỉ của học phần theo mã."""
return HOC_PHAN.get(ma.upper(), "Không tìm thấy học phần")
@mcp.resource("quyche://thi")
def quy_che_thi() -> str:
"""Tóm tắt quy chế thi hiện hành."""
return open("quy_che_thi.md", encoding="utf-8").read()
if __name__ == "__main__":
mcp.run() # stdio; dùng transport HTTP khi triển khai làm connector từ xaỨng dụng thực tế
Bài toán: phòng đào tạo muốn cán bộ hỏi Claude về lịch học, học phần, quy chế bằng ngôn ngữ tự nhiên mà không tải tài liệu lên mỗi lần. Giải pháp: máy chủ MCP đọc từ CSDL đào tạo (chỉ đọc), triển khai qua HTTPS với OAuth của trường, quản trị viên gói Team thêm làm custom connector cho tổ chức. Claude kế thừa quyền của từng cán bộ nên mỗi người chỉ thấy dữ liệu mình được phép.
Chỉ kết nối máy chủ MCP tin cậy; không cấp quyền ghi khi chưa cần. Kiểm tra kỹ dữ liệu cá nhân trước khi mở qua connector.
- Chạy máy chủ mẫu và thử bằng MCP Inspector.
- Thêm một công cụ đọc dữ liệu từ tệp CSV.
- Cấu hình kết nối trong Claude Desktop hoặc Claude Code.
Nguồn chính: Model Context Protocol, Custom connectors using remote MCP. Tính năng và giá có thể thay đổi; hãy đối chiếu với trang chính thức.
- MCP là chuẩn mở kết nối AI với công cụ và dữ liệu.
- Tools, resources, prompts.
- Bảo mật và phân quyền là bắt buộc.
Trang 20 / 21

