Tích hợp MCP Server

Những điều bạn cần biết

MCP server (Model Context Protocol) mở rộng năng lực của Claude bằng cách kết nối nó với các hệ thống bên ngoài — cơ sở dữ liệu, API, công cụ phát triển, hệ thống theo dõi issue. Cấu hình chúng đúng cách sẽ quyết định liệu nhóm của bạn có dùng chung một bộ công cụ nhất quán hay rơi vào tình trạng hỗn loạn cấu hình.

Hệ thống phân cấp phạm vi

Cấu hình MCP server tồn tại ở hai cấp độ, và việc nhầm lẫn giữa chúng là nguồn gốc phổ biến của nhiều vấn đề.

Cấp dự án: .mcp.json Nằm ở gốc kho mã của dự án. Được quản lý phiên bản (version-controlled). Được chia sẻ với mọi thành viên trong nhóm khi họ clone hoặc pull kho mã. Dùng cấu hình này cho các server mà toàn bộ nhóm cần — tích hợp Jira, các tool GitHub, các connector API nội bộ của bạn.

jsonCopy

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@community/mcp-server-jira"],
      "env": {
        "JIRA_URL": "${JIRA_URL}",
        "JIRA_TOKEN": "${JIRA_TOKEN}"
      }
    }
  }
}

Cấp người dùng: ~/.claude.json Nằm trong thư mục home của người dùng. Mang tính cá nhân. KHÔNG được quản lý phiên bản. KHÔNG được chia sẻ với đồng nghiệp. Dùng cấu hình này cho các server thử nghiệm, tích hợp cá nhân, hoặc các server bạn đang thử nghiệm trước khi đề xuất cho cả nhóm.

Nguyên tắc cốt lõi: tất cả tool từ mọi server đã cấu hình (cả cấp dự án và cấp người dùng) đều được phát hiện tại thời điểm kết nối và sẵn sàng sử dụng cùng lúc. Không có bước kích hoạt thủ công nào cả — nếu một server đã được cấu hình và có thể truy cập được, các tool của nó sẽ xuất hiện trong bộ công cụ của agent.

Mở rộng biến môi trường

File .mcp.json hỗ trợ cú pháp ${VARIABLE_NAME} để mở rộng biến môi trường. Đây là cách bạn giữ thông tin xác thực (credentials) ngoài phạm vi quản lý phiên bản trong khi vẫn chia sẻ cấu hình server với nhóm của mình.

jsonCopy

{
  "env": {
    "GITHUB_TOKEN": "${GITHUB_TOKEN}",
    "DATABASE_URL": "${DATABASE_URL}"
  }
}

Mỗi lập trình viên tự thiết lập token của riêng mình cục bộ (trong shell profile, file .env, hoặc trình quản lý secret). File .mcp.json chỉ tham chiếu tên biến, không chứa giá trị thật. Điều này có nghĩa là:

• File cấu hình an toàn để commit vào quản lý phiên bản
• Mỗi lập trình viên xác thực bằng thông tin đăng nhập của riêng mình
• Việc xoay vòng token không đòi hỏi thay đổi file cấu hình
• Không có secret nào bị lộ qua lịch sử kho mã

Resource của MCP

Resource của MCP là một cơ chế để hiển thị các danh mục nội dung cho agent mà không cần các lệnh gọi tool mang tính thăm dò. Thay vì agent phải gọi tool để khám phá dữ liệu nào đang có sẵn, resource trình bày thông tin đó ngay từ đầu.

Ví dụ về những gì nên hiển thị dưới dạng resource:

• Tóm tắt issue — danh sách các issue Jira hiện tại kèm tiêu đề và trạng thái
• Cây phân cấp tài liệu — mục lục cho tài liệu nội bộ của bạn
• Schema cơ sở dữ liệu — tên bảng, kiểu cột, và các mối quan hệ

Lợi ích là giảm số truy vấn không cần thiết. Nếu không có resource, một agent có thể phải gọi list_tables, rồi describe_table cho từng bảng, tiêu tốn nhiều lệnh gọi tool chỉ để hiểu bối cảnh dữ liệu. Với một resource schema cơ sở dữ liệu, thông tin đó có sẵn ngay lập tức.

Resource cho agent khả năng nhìn thấy dữ liệu sẵn có. Tool cho phép agent hành động trên dữ liệu đó. Sự kết hợp này có nghĩa là ít lệnh gọi lãng phí hơn và các thao tác chính xác hơn.

Quyết định xây dựng hay dùng sẵn

Đây là một trong những quyết định thực tế nhất được kiểm tra trong đề thi. Khi nhóm của bạn cần tích hợp với một hệ thống bên ngoài, câu hỏi đặt ra là: xây dựng một MCP server tùy chỉnh hay dùng một server cộng đồng có sẵn?

Dùng server cộng đồng cho các tích hợp tiêu chuẩn:

• Jira, GitHub, Slack, Linear, Notion — tất cả đều có MCP server cộng đồng được duy trì
• Chúng bao phủ các use case tiêu chuẩn, được cộng đồng kiểm thử, và nhận cập nhật thường xuyên
• Dùng chúng tiết kiệm thời gian phát triển và gánh nặng bảo trì

Chỉ xây dựng server tùy chỉnh khi:

• Nhóm của bạn có quy trình làm việc đặc thù mà server cộng đồng không thể xử lý
• Bạn cần logic nghiệp vụ tùy chỉnh được nhúng vào lớp tool
• Bạn cần tích hợp với hệ thống nội bộ độc quyền không có server cộng đồng nào hỗ trợ

Đề thi luôn thiên về lựa chọn thực dụng. "Đánh giá server cộng đồng trước" luôn là câu trả lời đúng khi có liên quan đến một tích hợp tiêu chuẩn. "Xây dựng tùy chỉnh" chỉ đúng khi tình huống mô tả rõ ràng các yêu cầu đặc thù của nhóm mà server cộng đồng không thể đáp ứng.

Nâng cao mô tả tool của MCP

Một vấn đề tinh vi nhưng quan trọng: khi một tool MCP có mô tả sơ sài, agent có thể ưu tiên dùng các tool tích hợp sẵn (như Grep) ngay cả khi tool MCP có năng lực tốt hơn. Điều này xảy ra vì model có bối cảnh tốt hơn về các tool tích hợp sẵn — mô tả của chúng phong phú và chi tiết hơn.

Cách khắc phục: nâng cao mô tả tool MCP của bạn để giải thích chi tiết năng lực và đầu ra. Thay vì:

search_codebase: "Tìm kiếm mã nguồn"

Hãy viết:

search_codebase: "Thực hiện tìm kiếm mã nguồn theo ngữ nghĩa trên toàn bộ kho mã bằng đánh chỉ mục nhận biết AST. Trả về các hàm, class, và phương thức khớp cùng với đầy đủ ngữ cảnh bao gồm đường dẫn file, số dòng, và mã nguồn xung quanh. Chính xác hơn grep dựa trên văn bản khi tìm mã nguồn theo ý định thay vì khớp chuỗi chính xác. Dùng tool này thay vì Grep khi tìm kiếm mã nguồn theo chức năng thay vì nội dung chứa trong đó."

Mô tả được nâng cao này cung cấp cho model đủ bối cảnh để ưu tiên tool MCP khi nó thực sự có năng lực tốt hơn phương án tích hợp sẵn.

Bẫy thi

Tình huống luyện tập

Không tìm thấy câu hỏi luyện tập "q-2-4-001".

Bài tập thực hành

Nguồn tham khảo

• Claude Certified Architect Foundations Exam Guide — Domain 2, Task Statement 2.4 — Anthropic
• MCP Server Configuration — Claude Code Documentation — Anthropic
• Model Context Protocol — Resources — Model Context Protocol