Phần 9 của 5180% hoàn thành

MCP — kết nối tool và dữ liệu ngoài

English title: MCP — Connect Tools and External Data

Bài 9 trong chuỗi 15 bài hướng dẫn Cursor. Thêm "tay" cho Cursor — kết nối database, API, GitHub, Linear, Notion, v.v. MCP (Model Context Protocol) là giao thức cho phép Cursor kết nối với các server bên ngoài (MCP server); mỗi server cung cấp tools (vd. query database, list PR, tạo issue). Cursor cấu hình qua mcp.json (global hoặc theo project) hoặc cài server một cú click qua Marketplace. Bài này giới thiệu MCP và cách bắt đầu.

Mở đầu: Thêm tay cho Cursor

Mặc định, AI trong Cursor "thấy" codebase và chat. Nếu bạn muốn AI "đọc issue GitHub của repo này" hoặc "chạy query mẫu lên database staging", cần kết nối Cursor với dịch vụ ngoài. MCP làm điều đó: một MCP server (vd. GitHub MCP) cung cấp các tool (list_issues, create_pr, ...); Cursor gọi tool khi relevant (vd. user hỏi "có bao nhiêu PR đang mở?"). Bạn cài server (qua Marketplace hoặc config mcp.json), Cursor và AI sẽ dùng tool khi phù hợp.

1. Đi sâu: MCP là gì

Tại sao chủ đề này quan trọng: Nhiều task dev cần dữ liệu ngoài code: API, DB, issue tracker. MCP mở rộng "tay" của AI mà không cần bạn paste từng response vào chat.

Hiểu sai thường gặp: Nhiều người nghĩ "MCP = chỉ GitHub". Thực tế MCP là protocol mở; có server cho GitHub, database, Notion, Linear, custom API, v.v.

Bản chất đúng: Model Context Protocol (MCP) = giao thức chuẩn để client (Cursor) kết nối với server (MCP server). Server expose tools (hàm có thể gọi) và có thể resources (dữ liệu đọc). Cursor gửi request (vd. "gọi tool list_pr với repo X"); server trả về kết quả; Cursor đưa kết quả vào context cho AI. AI có thể quyết định gọi tool nào dựa trên prompt của user.

2. Khái niệm

MCP server: Ứng dụng chạy (local hoặc remote) implement MCP; cung cấp tools (vd. query DB, list issues). Cursor kết nối tới server qua config.
mcp.json: File cấu hình — khai báo MCP server nào được bật. Đặt global tại ~/.cursor/mcp.json hoặc theo project tại .cursor/mcp.json. Cấu trúc tùy Cursor version — tham khảo Cursor Docs và help/customization/mcp.
Marketplace: Trong Cursor có thể có Marketplace (hoặc tương đương) để cài MCP server one-click; sau khi cài, server xuất hiện trong config và Agent có thể gọi tools.
Tools: Các hành động MCP server cung cấp (vd. get_table_schema, run_query, list_pr). Agent gọi tool khi user hỏi liên quan.

3. Workflow: Cấu hình MCP

Chọn server cần dùng — Ví dụ: GitHub (list PR, issue), database (query), Notion (đọc/ghi page). Xem Cursor Marketplace hoặc docs MCP.
Cài server — Qua Marketplace: bấm cài. Hoặc thủ công: cài MCP server (npm/script), rồi thêm entry vào mcp.json với command hoặc URL.
Cấu hình mcp.json (nếu cần) — Một số server cần env (vd. GITHUB_TOKEN). Khai báo trong mcp.json hoặc env; không commit token vào repo.
Kiểm tra — Mở Cursor, hỏi một câu liên quan (vd. "list open PRs in this repo") — nếu cấu hình đúng, Agent có thể gọi tool và trả lời.

4. Bảo mật

Token / secret: MCP server thường cần API key hoặc token. Lưu trong env hoặc secret store; không ghi vào mcp.json rồi commit. Dùng .env (và .gitignore) hoặc Cursor secret nếu hỗ trợ.
Giới hạn quyền: Chỉ bật server cần dùng; tránh cài quá nhiều tool khiến context loãng và rủi ro quyền.

5. Ứng dụng

Sau bài này bạn đã biết: MCP = kết nối Cursor với tool/dữ liệu ngoài; mcp.json và Marketplace. Bài tiếp: Cursor CLI — chạy Agent từ terminal (script, CI, hoặc không mở IDE).

Bài tiếp: Cursor CLI — agent từ terminal (bài 10).