Giao diện
MCP
MCP (Model Context Protocol, cổng kết nối công cụ) là chuẩn để agent dùng công cụ bên ngoài: trình duyệt, tài liệu thư viện, GitHub, database...
Giải quyết vấn đề gì
Ra khỏi terminal là agent "mù":
- Nó viết code giao diện nhưng không nhìn thấy trang web chạy ra sao.
- Nó gọi API thư viện theo trí nhớ lúc huấn luyện, có thể đã cũ vài phiên bản.
- Nó không đọc được issue, PR, CI của dự án.
Mỗi MCP server mở cho agent một nhóm tool mới. Agent gọi chúng như gọi tool có sẵn.
Khi nào cần
Ba nhóm đáng cài sớm:
| Nhóm | Ví dụ | Dùng khi |
|---|---|---|
| Docs thư viện | Context7 | Thư viện ra phiên bản mới thường xuyên; agent hay dùng API cũ |
| Trình duyệt | Playwright, Chrome DevTools | Làm UI: agent tự mở app, bấm thử, chụp màn hình, đọc console |
| Nền tảng code | GitHub | Agent cần đọc issue, mở PR, xem CI |
Đừng cài tràn lan: mỗi server thêm tool vào danh sách agent phải cân nhắc, và mỗi server là một chỗ có quyền chạm vào máy bạn. Chỉ thêm khi có việc cụ thể cần nó.
Ví dụ tối thiểu
Starter không có file .mcp.json. MCP đến qua plugin: practice/starter/.claude/settings.json bật plugin Context7 và Playwright từ marketplace chính thức.
json
{
"enabledPlugins": {
"context7@claude-plugins-official": true,
"playwright@claude-plugins-official": true
}
}Hai MCP này được dùng ở đâu trong starter:
practice/starter/CLAUDE.md: "Cần tài liệu thư viện mới nhất: dùng Context7 thay vì đoán API."practice/starter/.claude/skills/verify-app/SKILL.md: "Dùng Playwright MCP (hoặc Chrome DevTools MCP) mở http://localhost:3001", làm đúng luồng tính năng, chụp màn hình, xem console có lỗi đỏ không.
Muốn thêm MCP bằng tay (không qua plugin):
bash
# server chạy cục bộ (stdio)
claude mcp add <name> -- <cmd> [args]
# server từ xa (HTTP)
claude mcp add --transport http <name> <url>
# chia sẻ cho cả nhóm: ghi vào .mcp.json ở gốc repo
claude mcp add --scope project <name> -- <cmd> [args]--scope nhận local (mặc định, chỉ máy bạn, dự án này), project (ghi vào .mcp.json, commit được) hoặc user (mọi dự án của bạn). --transport sse đã deprecated.
Đọc .mcp.json trước khi tin một repo
.mcp.json trong repo quyết định chương trình nào được chạy trên máy bạn khi agent khởi động. Clone repo lạ thì mở file này ra đọc trước khi duyệt.
Bên Codex
Codex khai báo MCP trong ~/.codex/config.toml:
toml
[mcp_servers.<name>]
command = "<cmd>"
args = ["..."]Hoặc dùng lệnh: codex mcp add <name> -- <cmd>. Cùng một MCP server dùng được cho cả hai tool, chỉ khác chỗ khai báo.
Nguồn
- Claude Code MCP: https://code.claude.com/docs/en/mcp
- Marketplace chính thức: https://code.claude.com/docs/en/discover-plugins
- Codex MCP: https://learn.chatgpt.com/docs/extend/mcp.md