MCP (Model Context Protocol)

Model Context Protocol (MCP) là một chuẩn mở để kết nối công cụ AI với nguồn dữ liệu và dịch vụ bên ngoài. Một “MCP server” đóng vai trò cầu nối — cho Claude Code khả năng đọc và thao tác trực tiếp trên một hệ thống khác, thay vì bạn phải tự copy dữ liệu vào hội thoại.

Nên kết nối một MCP server khi bạn nhận ra mình đang phải copy-paste dữ liệu từ một công cụ khác (issue tracker, dashboard giám sát…) vào chat — kết nối xong, Claude có thể tự đọc và hành động trực tiếp trên hệ thống đó.

Dùng MCP để làm gì

Triển khai tính năng từ issue tracker: “Thêm tính năng được mô tả trong Jira ENG-4521 và tạo PR trên GitHub.”
Phân tích dữ liệu giám sát: “Kiểm tra Sentry xem tính năng ENG-4521 có lỗi gì không.”
Truy vấn database: “Tìm email của 10 người dùng ngẫu nhiên đã dùng tính năng ENG-4521, dựa trên database PostgreSQL.”
Tích hợp thiết kế: “Cập nhật email template dựa theo thiết kế Figma mới được đăng trong Slack.”
Tự động hoá quy trình: “Tạo Gmail draft mời 10 người dùng này tham gia buổi phỏng vấn feedback.”

Thêm một MCP server

Server HTTP (khuyến nghị cho dịch vụ trên mây)

Đây là cách được khuyến nghị để kết nối server từ xa:

claude mcp add --transport http notion https://mcp.notion.com/mcp

# Kèm header xác thực
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Server local (stdio)

Chạy như một tiến trình trên máy bạn — phù hợp cho công cụ cần truy cập hệ thống trực tiếp hoặc script tuỳ biến:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Lưu ý dấu --: mọi thứ trước -- là tuỳ chọn của bản thân lệnh claude mcp add (--transport, --env…); mọi thứ sau -- được truyền nguyên vẹn cho server.

Cấu hình trực tiếp bằng JSON

Có thể khai báo trong .mcp.json (chia sẻ với team qua git) hoặc .claude/settings.json:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@some-org/mcp-server"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Phạm vi cấu hình (scope)

Dùng cờ -s/--scope khi thêm server để quyết định phạm vi lưu cấu hình:

Scope	Ý nghĩa
`local` (mặc định)	Chỉ dùng cho bạn, trong dự án hiện tại
`project`	Chia sẻ với cả team qua file `.mcp.json` commit vào repo
`user`	Dùng cho bạn, ở mọi dự án

Quản lý server

claude mcp list              # xem danh sách server đã cấu hình
claude mcp get github         # xem chi tiết một server
claude mcp remove github      # gỡ một server

Trong phiên tương tác, gõ /mcp để xem trạng thái kết nối, số lượng tool mỗi server cung cấp, và xác thực OAuth với server yêu cầu đăng nhập. Có thể tắt tạm một server (không xoá cấu hình) ngay trong bảng /mcp.

Server được khai báo trong .mcp.json của một repo bạn mới clone sẽ ở trạng thái “chờ duyệt” cho đến khi bạn chạy claude và xác nhận tin tưởng thư mục đó — tránh việc một repo lạ tự ý kết nối server thay bạn.

Managed MCP (cho tổ chức)

Với tổ chức, quản trị viên có thể cấu hình sẵn danh sách MCP server được duyệt (allowedMcpServers/deniedMcpServers trong managed settings) để cả team dùng thống nhất, không cần từng thành viên tự cấu hình.