CCAR-F Day 5 - MCP & Claude Code

stdio transport

Kết nối qua stdin/stdout (server chạy cục bộ) | Định nghĩa: Cách MCP server chạy như một tiến trình cục bộ, giao tiếp qua stdin/stdout. | Ví dụ: MCP server cục bộ thường dùng stdio (A local MCP server usually uses stdio.)

HTTP transport

Kết nối qua HTTP (server ở xa) | Định nghĩa: Cách MCP server từ xa nhận yêu cầu qua HTTP (Streamable HTTP). | Ví dụ: MCP server từ xa được truy cập qua HTTP (A remote MCP server is reached over HTTP.)

mcp__server__tool

Quy ước đặt tên tool MCP | Định nghĩa: Tên tool MCP trong Claude Code có dạng mcp__<tên server>__<tên tool>; dùng khi khai báo quyền. | Ví dụ: Cho phép mcp__github__create_issue trong permissions (Allow mcp__github__create_issue in permissions.)

least privilege

Nguyên tắc quyền tối thiểu | Định nghĩa: Chỉ cấp cho agent/tool đúng quyền tối thiểu cần dùng. | Ví dụ: Subagent chỉ-đọc thì chỉ nhận các tool đọc (Give a read-only subagent only the read tools.)

idempotent

Lặp lại nhiều lần vẫn cho cùng kết quả | Định nghĩa: Gọi nhiều lần cho kết quả như gọi một lần, nên thử lại (retry) an toàn. | Ví dụ: Làm process_refund idempotent để retry không hoàn tiền hai lần (Make process_refund idempotent so retries are safe.)

Grep / Glob / Read

Ba tool có sẵn của Claude Code | Định nghĩa: Grep tìm theo nội dung, Glob tìm theo tên file, Read đọc file; dùng để khảo sát code từng bước. | Ví dụ: Dùng Grep tìm nơi gọi hàm, rồi Read các file khớp (Use Grep to find callers, then Read the matching files.) | Bẫy thi: Grep = tìm theo nội dung; Glob = tìm theo tên file.

server-side tool

Tool chạy phía server | Định nghĩa: Tool do Anthropic chạy trên server (ví dụ web search), bạn không cần tự thực thi. | Ví dụ: Web search là một server-side tool (Web search is a server-side tool.) | Bẫy thi: Khác tool của bạn: tool của bạn thì bạn tự chạy rồi gửi tool_result.

CLAUDE.md

File hướng dẫn cho Claude Code | Định nghĩa: File Claude Code tự đọc ở đầu phiên: quy ước code, lệnh build, quy tắc dự án. | Ví dụ: Đặt quy ước code của nhóm trong CLAUDE.md của dự án (Put team coding conventions in the project CLAUDE.md.)

user-level CLAUDE.md

CLAUDE.md cấp người dùng | Định nghĩa: File ~/.claude/CLAUDE.md chỉ áp dụng cho riêng bạn, không chia sẻ qua git. | Ví dụ: Quy ước trong ~/.claude/CLAUDE.md thì đồng đội không thấy (Conventions in ~/.claude/CLAUDE.md are not shared with teammates.) | Bẫy thi: Muốn cả nhóm dùng chung thì dùng CLAUDE.md cấp dự án.

project-level CLAUDE.md

CLAUDE.md cấp dự án | Định nghĩa: CLAUDE.md nằm trong repo, commit lên git để cả nhóm dùng chung. | Ví dụ: Commit CLAUDE.md cấp dự án lên version control (Commit the project-level CLAUDE.md to version control.)

@import

Cú pháp nhập thêm file vào CLAUDE.md | Định nghĩa: Cú pháp @đường-dẫn trong CLAUDE.md để nạp thêm file, giúp chia nhỏ hướng dẫn thành các module. | Ví dụ: Dùng @import để nạp payments-standards.md (Use @import to pull in payments-standards.md.)

.claude/rules/

Thư mục chứa file quy tắc riêng | Định nghĩa: Thư mục chứa các file quy tắc, có thể gắn với một nhóm đường dẫn. | Ví dụ: Tạo một file trong .claude/rules/ cho quy ước Terraform (Create a file under .claude/rules/ for Terraform conventions.)

paths (frontmatter)

Khóa paths ở đầu file rule | Định nghĩa: Khóa YAML ở đầu file rule để quy tắc chỉ nạp khi Claude sửa file khớp mẫu đường dẫn, đỡ tốn context. | Ví dụ: paths: ['terraform/**/*'] chỉ nạp rule cho file Terraform (paths: ['terraform/**/*'] loads the rule only for Terraform files.)

/memory

Lệnh xem và sửa file memory | Định nghĩa: Lệnh xem và sửa các file memory (CLAUDE.md) đang được nạp. | Ví dụ: Chạy /memory để xem file CLAUDE.md nào đang được nạp (Run /memory to see which CLAUDE.md files are loaded.) | Bẫy thi: Dùng để gỡ lỗi khi Claude không làm theo hướng dẫn.

/init

Lệnh khởi tạo CLAUDE.md | Định nghĩa: Tạo CLAUDE.md khởi đầu bằng cách phân tích dự án. | Ví dụ: Chạy /init để sinh CLAUDE.md mẫu (Run /init to generate a starter CLAUDE.md.)