Context7 là gì: đưa tài liệu mới nhất vào AI lập trình qua MCP

Thử hình dung anh chị nhờ AI trong Cursor viết đoạn đăng nhập cho trang web công ty. Mười giây sau có ngay code, trình bày đẹp, chú thích đầy đủ. Chạy thử thì báo lỗi: hàm này không tồn tại. Hỏi lại, AI xin lỗi rất lễ phép rồi đưa một hàm khác, cũng không tồn tại.

AI không cố tình nói dối. Nó học từ dữ liệu cũ, còn thư viện thì đã đổi. Context7 ra đời để đặt cuốn tài liệu bản mới nhất lên bàn trước khi AI bắt tay vào viết.

Đọc nhanh trong 30 giây

• Context7 là dịch vụ của Upstash đưa tài liệu và ví dụ code mới nhất của thư viện vào thẳng prompt của AI. Bản web ra ngày 31/03/2025, bản MCP công bố ngày 11/04/2025.
• Cách dùng: thêm cụm use context7 vào câu hỏi, AI tự tìm đúng thư viện và đúng đoạn tài liệu.
• Cài bằng một khối cấu hình npx -y @upstash/context7-mcp trong Cursor hoặc Windsurf, cần Node.js 18 trở lên.
• Hợp với người dùng AI viết code cho các thư viện đổi nhanh như Next.js, React Query, NextAuth.

Context7 là gì?

Context7 là dịch vụ của Upstash, dùng để đưa tài liệu và ví dụ code mới nhất của các thư viện lập trình vào prompt của AI, để AI bớt viết code theo phiên bản cũ hoặc bịa ra hàm không có thật. README của repo upstash/context7 liệt kê ba triệu chứng nó chữa: ví dụ code lỗi thời dựa trên dữ liệu huấn luyện từ cả năm trước, API bịa ra không có thật, câu trả lời chung chung cho phiên bản thư viện cũ.

Ví von cho dễ hình dung: anh chị thuê một kỹ sư giỏi vừa đi tàu viễn dương về sau một năm không có mạng. Tay nghề vẫn tốt, chỉ là không biết thư viện vừa đổi hàm. Context7 giống người thủ thư đứng cạnh, nghe anh ấy định làm gì là rút ngay đúng trang tài liệu mới nhất đặt lên bàn.

Cùng một câu hỏi, khác nhau ở chỗ AI có được xem tài liệu mới trước khi trả lời hay không.

Context7 lấy tài liệu thế nào?

Context7 chuẩn bị tài liệu qua năm bước trước khi AI hỏi tới, theo bài giới thiệu ngày 31/03/2025 của Upstash.

Tài liệu được tách, làm giàu, đánh chỉ mục và lưu sẵn, nên lúc AI hỏi chỉ việc lấy ra.

1. Parse: tách đoạn code và ví dụ từ tài liệu gốc.
2. Enrich: dùng LLM thêm giải thích ngắn và thông tin mô tả.
3. Vectorize: chuyển nội dung thành vector để tìm theo ý nghĩa.
4. Rerank: chấm điểm độ liên quan bằng thuật toán riêng.
5. Cache: lưu trên Redis để trả kết quả nhanh.

Bản MCP thêm hai công cụ để AI tự gọi, theo README:

Tham số topic giúp chỉ lấy phần cần, ví dụ "routing" hay "hooks", thay vì đổ cả bộ tài liệu vào ngữ cảnh. Tham số tokens giới hạn độ dài trả về. Giống như hỏi thủ thư đúng chương, chứ không bê cả kệ sách về bàn.

Cài Context7 MCP cho Cursor và Windsurf

Context7 MCP cần Node.js 18.0.0 trở lên và một MCP client như Cursor, Windsurf, Claude Desktop, theo README.

Một khối cấu hình bốn dòng, khởi động lại trình soạn code là dùng được.

1. Với Cursor, vào Settings, chọn Cursor Settings, chọn MCP, bấm Add new global MCP server.
2. Dán đoạn sau vào file ~/.cursor/mcp.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

3. Với Windsurf, dán đúng đoạn cấu hình trên vào file cấu hình MCP của Windsurf.
4. Khởi động lại trình soạn code, mở chat ở chế độ agent và thêm use context7 vào câu hỏi.
5. Muốn kiểm tra server chạy đúng chưa, README gợi ý dùng MCP Inspector:

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

Với Claude Desktop, README có ghi tên trong danh sách client hỗ trợ nhưng tại ngày ra mắt chưa có hướng dẫn cài riêng. Nếu anh chị chưa rõ MCP là gì, bài MCP là gì: Model Context Protocol cho doanh nghiệp giải thích cách AI kết nối với công cụ bên ngoài.

Thử ngay với hai việc thật

Việc 1: thư viện vừa ra hàm mới. README lấy ví dụ hàm after của Next.js. Trong Cursor, gõ:

How do I use the new Next.js `after` function? use context7

Câu hỏi tiếng Việt cũng được, miễn có cụm use context7:

Viết middleware bảo vệ trang /admin bằng NextAuth, chỉ cho tài khoản có quyền admin vào. use context7

AI sẽ gọi resolve-library-id để tìm NextAuth, rồi get-library-docs với chủ đề liên quan, sau đó mới viết code.

Việc 2: máy chưa cài được Node.js. Bản web ra mắt trước đó vẫn dùng được: vào trang Context7, tìm thư viện và chủ đề, chép đường link tài liệu rồi dán vào khung chat của Cursor hay công cụ AI khác.

Mẹo

Khi hỏi, nêu rõ chủ đề hẹp như "middleware", "routing", "server actions" thay vì hỏi chung chung. AI sẽ truyền chủ đề đó vào tham số topic, lấy đúng đoạn tài liệu cần, đỡ tốn ngữ cảnh và trả lời trúng hơn.

Context7 chưa làm được gì?

Lưu ý

• Chỉ có tài liệu công khai: Context7 lấy từ tài liệu chính thức của thư viện. Với thư viện nội bộ công ty, tài liệu không nói cách đưa vào.
• Phụ thuộc dịch vụ ngoài: MCP server gọi tới hệ thống của Upstash để lấy tài liệu. Câu hỏi gửi đi có chứa tên thư viện và chủ đề, nên tránh ghi thông tin nhạy cảm của dự án vào câu hỏi có use context7.
• Giấy phép và chi phí: mã nguồn MCP server theo giấy phép MIT. Upstash cho biết Context7 miễn phí, tài liệu không nói về giới hạn số lượt gọi.
• Dự án rất mới: gói npm @upstash/context7-mcp mới lên bản đầu ngày 08/04/2025, tên công cụ và tham số có thể còn đổi.
• Không thay được việc chạy thử: tài liệu đúng phiên bản giúp AI viết đúng hơn, anh chị vẫn phải chạy và kiểm tra.

Nhận xét của chuyên gia

Trong các buổi đào tạo AI lập trình, lỗi tôi hay gặp không phải AI viết dở, mà là AI viết theo phiên bản cũ. Người mới không biết nên tin, mất cả buổi sửa lỗi. Context7 xử lý đúng chỗ đau đó với cách cài chỉ vài dòng.

Hợp với ai: đội làm web, app dùng thư viện mã nguồn mở thay đổi nhanh; người học lập trình bằng AI; công ty đã cho nhân viên dùng Cursor hoặc Windsurf.

Chưa hợp với ai: dự án chủ yếu dùng thư viện nội bộ hoặc phần mềm đóng; môi trường không cho máy dev gọi dịch vụ ngoài. Với doanh nghiệp có quy định bảo mật, nên ghi Context7 vào danh sách công cụ được phép và dặn nhân viên không dán code bí mật vào câu hỏi.

Cách bắt đầu của tôi: cài cho hai ba người trong nhóm, chọn một thư viện hay gây lỗi nhất, so sánh câu trả lời có và không có use context7 trong một tuần. Kết quả so sánh đó là lý lẽ tốt nhất để cả đội cùng dùng.

Một câu để nhớ: AI không cần thông minh hơn để viết đúng, nó cần đọc đúng tài liệu.

Câu hỏi thường gặp

Context7 có miễn phí không?

Upstash cho biết Context7 miễn phí, mã nguồn MCP server theo giấy phép MIT. Anh chị vẫn trả phí cho công cụ AI đang dùng như Cursor.

Context7 dùng với ChatGPT được không?

Bản MCP cần một MCP client như Cursor, Windsurf, Claude Desktop. Với công cụ không hỗ trợ MCP, anh chị dùng bản web: chép link tài liệu từ Context7 rồi dán vào khung chat.

Có phải gõ use context7 mỗi lần không?

Theo README, cụm use context7 là cách báo cho AI gọi Context7. Không có cụm này, AI có thể trả lời từ kiến thức sẵn có như bình thường.

Xem thêm các mốc khác trong chuỗi dòng thời gian AI.

Nguồn: Upstash, Context7 MCP: Up-to-Date Docs for Any Cursor Prompt, 11/04/2025.