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.

60 phútNâng cao
Bạn sẽ học được
  • 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ầnVai trò
HostỨng dụng AI người dùng tương tác (Claude, Claude Code)
ClientBộ kết nối trong host, giữ một kết nối tới mỗi server
ServerChương trình cung cấp khả năng: dữ liệu, công cụ
Khả năngÝ nghĩaVí dụ
ToolsHàm mô hình được gọi để thực hiện hành độngTra điểm, tạo phiếu yêu cầu
ResourcesDữ liệu đọc được qua URIQuy chế, danh mục học phần
PromptsMẫ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.

Lưu ý

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.

Thực hành
  1. Chạy máy chủ mẫu và thử bằng MCP Inspector.
  2. Thêm một công cụ đọc dữ liệu từ tệp CSV.
  3. 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.

Tóm tắt bài họ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.