MCP của Claude Code: kết nối máy chủ, phạm vi, MCP từ xa và ví dụ thực tế

Thêm máy chủ

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

Máy chủ stdio là các chương trình mà Claude Code khởi chạy giúp bạn — hầu hết máy chủ do cộng đồng phát triển là các gói npm hoặc Python chạy theo cách này. Máy chủ từ xa là các URL; chúng xác thực bằng OAuth (chạy /mcp trong một phiên và làm theo quy trình trên trình duyệt) hoặc bằng một header bạn truyền vào khi thêm máy chủ, như trong ví dụ PostHog. Hãy kiểm tra tài liệu của từng nhà cung cấp để biết URL hiện tại — các endpoint từ xa có thể thay đổi.

Phạm vi và .mcp.json

• cục bộ (mặc định) — được lưu trong cài đặt người dùng của bạn, chỉ dành cho dự án này. Các máy chủ cá nhân, riêng tư.
• dự án (--scope project) — được ghi vào .mcp.json ở thư mục gốc của kho mã và được chia sẻ với mọi người sao chép kho mã đó. Claude Code sẽ hỏi trước khi tin cậy các máy chủ của dự án lần đầu.
• người dùng (--scope user) — có sẵn trong mọi dự án trên máy của bạn.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json hỗ trợ mở rộng biến môi trường, nên kho mã có thể chứa định nghĩa máy chủ trong khi mỗi nhà phát triển cung cấp thông tin xác thực riêng.

Sử dụng máy chủ trong một phiên

Sau khi kết nối, các công cụ của máy chủ sẽ sẵn sàng sử dụng — hãy yêu cầu "các lỗi trong 24 giờ qua từ PostHog" và Claude Code sẽ gọi công cụ. Có thể tham chiếu tài nguyên mà máy chủ cung cấp bằng lượt nhắc @ (@github:issue://123), đưa chúng vào ngữ cảnh khi cần. Các lời nhắc do máy chủ định nghĩa xuất hiện dưới dạng lệnh dấu gạch chéo trong /mcp__<server>__<prompt>. /mcp hiển thị trạng thái kết nối, cho phép bạn kết nối lại hoặc xác thực, đồng thời liệt kê từng công cụ kèm mô tả.

Các ví dụ đáng sao chép

• PostHog MCP — phân tích sản phẩm ngay trong tác nhân: "mã này được kiểm soát bởi cờ tính năng nào và đang được triển khai ra sao?" PostHog cung cấp một máy chủ MCP từ xa; hãy thêm máy chủ bằng --transport http và khóa API cá nhân của bạn dưới dạng header bearer.
• GitHub — dùng các issue và pull request làm ngữ cảnh; kết hợp với Action trong hướng dẫn GitHub cho quy trình rà soát.
• Playwright — trình duyệt thực để kiểm thử đầu cuối và kiểm tra giao diện bạn vừa thay đổi; xem hướng dẫn tự động hóa QA.
• Postgres / SQLite — truy vấn và di chuyển dữ liệu có nhận biết lược đồ; hãy cấp tài khoản người dùng chỉ đọc, trừ khi bạn chủ đích cho phép ghi.
• Hệ thống tệp bên ngoài kho mã — --add-dir đơn giản hơn khi cần thêm thư mục; MCP dành cho những thứ không phải là tệp.

Chi phí và ngữ cảnh

Mỗi kết quả công cụ mà máy chủ MCP trả về đều được đưa vào cuộc hội thoại và gửi lại trong mỗi lượt tiếp theo. Máy chủ trả về 5,000 hàng có thể khiến ngữ cảnh phình to đột biến. Ưu tiên công cụ có giới hạn, yêu cầu bản tóm tắt và /compact sau một truy vấn nặng. Máy chủ chạy cục bộ hoặc kết nối với nhà cung cấp; chúng không đi qua endpoint mô hình, nên ANTHROPIC_BASE_URL=https://aiprimetech.io không bị ảnh hưởng — chỉ tính phí các token mà kết quả sử dụng.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.