2.4 Integrate MCP servers into Claude Code and agent workflows

Đặt MCP server đúng phạm vi (team hay cá nhân), giữ bí mật ngoài repo, và làm agent thật sự dùng tool MCP.

1. Server dùng chung cho team → .mcp.json ở gốc project (--scope project, commit vào repo). Server cá nhân → ~/.claude.json: claude mcp add mặc định là scope local (riêng bạn, chỉ project hiện tại); --scope user để dùng ở mọi project.
2. Token, API key trong .mcp.json dùng biến môi trường ${GITHUB_TOKEN} — mỗi người tự đặt biến, không commit bí mật.
3. Tool của mọi server đã cấu hình được phát hiện lúc kết nối và dùng được cùng lúc. Server project-scope từ .mcp.json cần được duyệt lần đầu.
4. Agent cứ dùng Grep thay vì tool MCP mạnh hơn → viết mô tả tool MCP chi tiết hơn (làm được gì, trả về gì). Danh mục nội dung (schema DB, cây tài liệu) → MCP resources để agent khỏi phải dò.
5. Tích hợp phổ biến (Jira, GitHub) → ưu tiên server cộng đồng có sẵn; tự viết server chỉ cho quy trình riêng của team.