Đứng trên vai người khổng lồ
Bạn hiếm khi cần viết MCP server từ đầu. Anthropic và cộng đồng đã làm sẵn hàng loạt server chất lượng. Bài này dạy cách cắm chúng vào Cursor/Cline.
Cấu hình MCP bằng một file JSON
Cả Cursor, Cline và Claude Desktop đều cấu hình MCP qua một file JSON khai báo các server. Cấu trúc cốt lõi giống nhau:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/ban/projects"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
}
}
}
- Cursor: Settings → MCP → thêm server (hoặc sửa file
~/.cursor/mcp.json/.cursor/mcp.jsontrong dự án). - Cline: mở "MCP Servers" trong panel Cline → Configure (sửa file cấu hình của Cline).
- Claude Desktop: sửa
claude_desktop_config.json.
⚠️
command: "npx"cần Node.js đã cài (Module ở khoá Foundation). Nhiều server còn bản chạy bằnguvx(Python) — chọn theo tài liệu của server.
3 server nên cài đầu tiên
| Server | Cho AI khả năng | Lưu ý an toàn |
|---|---|---|
| Filesystem | Đọc/ghi file trong thư mục bạn chỉ định | Chỉ trỏ vào thư mục dự án, KHÔNG trỏ vào / hay Home |
| GitHub | Tạo issue, PR, đọc repo, review code | Dùng Personal Access Token quyền tối thiểu |
| Web Search / Fetch | Tra cứu thông tin mới, đọc trang web | Cảnh giác nội dung web (prompt injection) |
Kiểm tra server đã chạy
Sau khi thêm và khởi động lại editor, hỏi AI:
"Bạn đang có những MCP tool nào? Liệt kê tên và mô tả ngắn."
Nếu thấy các tool như read_file, create_issue, web_search → kết nối thành công. Thử ngay:
"Dùng filesystem, liệt kê các file trong thư mục dự án và tóm tắt cấu trúc." "Dùng GitHub, tạo issue tiêu đề 'Test MCP' trong repo X."
Quy tắc an toàn ngay từ đầu
- Quyền tối thiểu: token GitHub chỉ cấp scope cần dùng; filesystem chỉ trỏ thư mục cần thiết.
- Chỉ cài server từ nguồn tin cậy (npm chính thức của Anthropic, repo uy tín) — MCP server là code chạy trên máy bạn.
- Hành động ghi/xoá nên duyệt tay. Đọc thì thoải mái; tạo PR, ghi file, xoá dữ liệu thì xem kỹ trước khi cho chạy.
Checklist
- Cấu hình được ít nhất 2 server (Filesystem + một server khác)
- AI liệt kê đúng danh sách tool sau khi restart
- Chạy thành công 1 lệnh đọc và 1 lệnh ghi qua MCP