# Context7: cập nhật tài liệu cho AI — hướng dẫn cài đặt và dùng

> Context7 là nền tảng cung cấp tài liệu thư viện theo phiên bản cho AI coding agent, giúp giảm mã lỗi thời và API bị bịa. Bạn có thể cài bằng CLI với một lệnh hoặc cấu hình dưới dạng MCP; cần Node.js 22.13 trở lên cho CLI.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-27 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/context7-tai-lieu-moi-cho-ai

Context7 là repo mã nguồn cho nền tảng đưa tài liệu thư viện cập nhật vào ngữ cảnh của AI coding agent. Thay vì để AI trả lời dựa trên kiến thức cũ hoặc ví dụ chung chung, Context7 lấy tài liệu và đoạn mã theo phiên bản từ nguồn rồi cung cấp cho agent.

Công cụ này phù hợp với lập trình viên dùng Cursor, Claude Code, OpenCode hoặc một coding agent có hỗ trợ MCP. Người mới làm dự án Next.js, Supabase, Cloudflare Worker hay thư viện JavaScript cũng có thể hưởng lợi vì không phải liên tục mở nhiều tab để tìm đúng API.

Điểm đáng giá nhất là Context7 hỗ trợ cả CLI + Skills và MCP. Bạn có thể cài nhanh bằng `ctx7 setup`, sau đó yêu cầu agent dùng Context7 trong lúc viết mã. Repo hiện có khoảng 64743 sao và 3247 fork, dùng giấy phép MIT; phần backend, bộ phân tích và bộ crawl của nền tảng không nằm trong repo này.

```repo
- repo | upstash/context7
- kind | MCP server
- desc | Context7 đưa tài liệu và ví dụ mã nguồn cập nhật vào ngữ cảnh của AI coding agent.
- stars | 65k
- lang | TypeScript
- license | MIT
```

## Context7 làm được gì

Context7 tập trung vào một vấn đề rất thực tế: AI thường tạo mã dựa trên tài liệu cũ, API không tồn tại hoặc cách dùng không đúng với phiên bản thư viện bạn đang cài. Công cụ bổ sung tài liệu phù hợp vào ngữ cảnh trước khi agent trả lời.

- **Lấy tài liệu cập nhật theo thư viện**: Context7 truy xuất tài liệu và ví dụ mã nguồn từ nguồn tương ứng. Nhờ vậy, bạn có cơ sở tốt hơn khi hỏi cách dùng Next.js, Supabase, MongoDB hoặc thư viện khác.

- **Lấy tài liệu theo phiên bản**: Bạn có thể ghi rõ phiên bản trong prompt, chẳng hạn hỏi cách thiết lập Next.js 16 proxy. Context7 sẽ cố gắng khớp tài liệu với phiên bản được nêu, giúp giảm lỗi do cú pháp hoặc API thay đổi.

- **Tìm đúng Context7 ID của thư viện**: Khi bạn chưa biết ID chính xác, công cụ có lệnh tìm thư viện theo tên và câu hỏi. Kết quả giúp agent truy xuất đúng nguồn thay vì đoán tên thư viện.

- **Truy vấn tài liệu bằng CLI**: CLI có hai nhóm lệnh chính là tìm thư viện và lấy tài liệu. Cách này phù hợp khi bạn muốn agent sử dụng một skill hướng dẫn gọi `ctx7` mà không cần MCP.

- **Tích hợp tự nhiên qua MCP**: Ở chế độ MCP, coding agent có thể gọi hai công cụ `resolve-library-id` và `query-docs`. Bạn không cần tự sao chép tài liệu dài vào prompt.

- **Dùng ID thư viện trực tiếp**: Nếu đã biết ID, bạn có thể đưa ID đó vào prompt, ví dụ `/supabase/supabase` hoặc `/vercel/next.js`. Context7 có thể bỏ qua bước tìm kiếm chung và lấy thẳng tài liệu cần thiết.

- **Thiết lập quy tắc tự động**: Sau khi cài bằng `ctx7 setup`, skill có thể được cấu hình để tự gọi Context7 cho các câu hỏi liên quan đến thư viện. Bạn cũng có thể thêm quy tắc thủ công vào Cursor Settings > Rules, `CLAUDE.md` hoặc vị trí tương đương trong coding agent.

- **Có nhiều gói liên quan**: Hệ sinh thái gồm MCP server, CLI, TypeScript SDK, công cụ cho Vercel AI SDK và extension cho pi.dev. Repo này là mã nguồn của MCP server, còn người dùng cuối có thể bắt đầu từ CLI `ctx7`.

## Cần chuẩn bị gì

Bạn cần một coding agent có thể dùng Context7 qua CLI + Skills hoặc MCP. README nêu các mục tiêu cụ thể là Cursor, Claude Code và OpenCode; với client khác, tài liệu dự án có hướng dẫn cài thủ công cho nhiều client.

Nếu dùng CLI `ctx7`, máy cần Node.js 22.13 hoặc mới hơn. README không giới hạn hệ điều hành cụ thể, nên tư liệu được cung cấp chưa xác nhận chi tiết khác nhau giữa Windows, macOS và Linux.

Bạn có thể dùng API key miễn phí từ Context7 để có hạn mức cao hơn. README ghi API key là khuyến nghị, không phải điều kiện bắt buộc được nêu cho mọi cách dùng. Quy trình `npx ctx7 setup` xác thực qua OAuth, tạo API key và cài skill phù hợp.

Nếu cấu hình MCP thủ công, bạn cần MCP client, URL server `https://mcp.context7.com/mcp` và API key truyền qua header `Authorization: Bearer YOUR_API_KEY`. Hãy thay `YOUR_API_KEY` bằng key thật của bạn.

Repo có file `.env.example` với nhiều biến cấu hình như `CONTEXT7_API_KEY`, `CONTEXT7_API_URL`, `RESOURCE_URL`, các biến OAuth, proxy và telemetry. Tuy nhiên, phần README được cung cấp không mô tả giá trị hay quy trình dùng từng biến, nên không nên tự điền chúng nếu chưa xem hướng dẫn tương ứng trong repo.

Không có yêu cầu GPU trong tư liệu. README cũng không nêu tài khoản trả phí, dung lượng máy hay cấu hình phần cứng tối thiểu.

## Cài đặt từng bước

```steps
- Kiểm tra Node.js | Đảm bảo máy có Node.js 22.13 hoặc mới hơn
- Chạy trình thiết lập | Dùng npx ctx7 setup để xác thực và cài Context7
- Chọn chế độ | Chọn CLI + Skills hoặc MCP theo coding agent
- Gửi prompt có Context7 | Yêu cầu agent dùng context7 hoặc chỉ rõ Library ID
- Kiểm tra cấu hình | Chạy một câu hỏi tài liệu và xem agent trả lời theo nguồn cập nhật
```

### Kiểm tra phiên bản Node.js

CLI `ctx7` yêu cầu Node.js 22.13 hoặc mới hơn. Mở Terminal, PowerShell hoặc cửa sổ dòng lệnh mà bạn thường dùng để chạy coding agent, sau đó kiểm tra Node.js.

```bash
node --version
```

Lệnh này là bước kiểm tra phổ thông để xem phiên bản Node.js đang có. Nếu phiên bản thấp hơn 22.13 hoặc lệnh không tồn tại, README không cung cấp lệnh cài Node.js cụ thể. Bạn cần cài hoặc nâng Node.js trước khi chạy bước tiếp theo.

### Chạy trình thiết lập Context7

Trong cửa sổ dòng lệnh, chạy:

```bash
npx ctx7 setup
```

`npx` tải và chạy CLI `ctx7` mà không yêu cầu bạn cài gói này toàn cục trước. Trình thiết lập sẽ xác thực qua OAuth, tạo API key và cài skill phù hợp.

Khi trình thiết lập hỏi, hãy chọn cách tích hợp phù hợp với coding agent của bạn. README cho biết bạn có thể chọn giữa CLI + Skills và MCP. Nếu muốn nhắm vào một agent cụ thể, có thể dùng các tùy chọn được README nêu:

```bash
npx ctx7 setup --cursor
npx ctx7 setup --claude
npx ctx7 setup --opencode
```

Mỗi tùy chọn nhắm tới một coding agent tương ứng. Chỉ dùng tùy chọn phù hợp với agent bạn đang sử dụng. Nếu không chắc, chạy lệnh không có tùy chọn trước để xem trình thiết lập cung cấp lựa chọn nào.

Người mới thường vấp ở chỗ chạy lệnh trong một terminal khác với môi trường của coding agent. Hãy chạy setup bằng tài khoản người dùng có quyền ghi vào cấu hình của agent. Nếu trình duyệt mở ra để xác thực OAuth, hoàn tất bước đó rồi quay lại terminal.

### Chọn CLI + Skills hoặc MCP

Chế độ CLI + Skills cài một skill hướng dẫn agent gọi các lệnh `ctx7`. Chế độ MCP đăng ký Context7 MCP server để agent gọi công cụ tài liệu trực tiếp.

Nếu chọn CLI, hai lệnh chính được README nêu là:

```bash
ctx7 library <name> <query>
ctx7 docs <libraryId> <query>
```

Lệnh `ctx7 library` tìm trong chỉ mục Context7 theo tên thư viện và câu hỏi. Lệnh `ctx7 docs` lấy tài liệu bằng Context7-compatible library ID, chẳng hạn `/mongodb/docs` hoặc `/vercel/next.js`.

Dấu `<name>`, `<query>` và `<libraryId>` chỉ là chỗ cần thay bằng giá trị thật. Không gõ nguyên dấu ngoặc nhọn. Ví dụ, bạn có thể hỏi agent hoặc CLI về một thư viện cụ thể, nhưng tư liệu được cung cấp không đưa ra một lệnh mẫu hoàn chỉnh cho CLI ngoài cú pháp trên.

### Cấu hình MCP thủ công nếu cần

Nếu coding agent của bạn không dùng được setup tự động, README cho phép cấu hình thủ công bằng server URL và header xác thực. Thông tin cần dùng là:

```json
{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}
```

Đây là dạng minh họa để bạn điền vào phần cấu hình MCP của client. Hãy thay `YOUR_API_KEY` bằng API key thật. README không cung cấp một file cấu hình chung cho mọi client, nên vị trí dán cấu hình sẽ phụ thuộc vào coding agent bạn chọn.

Nếu chưa có key, README khuyến nghị lấy API key miễn phí từ dashboard Context7 để có hạn mức cao hơn. Không dán key vào prompt công khai, mã nguồn hoặc ảnh chụp màn hình.

### Thêm quy tắc gọi Context7

Khi cài qua `ctx7 setup`, skill được cấu hình tự động để kích hoạt cho câu hỏi liên quan đến thư viện. Nếu muốn thiết lập quy tắc thủ công, README gợi ý thêm quy tắc vào Cursor Settings > Rules, `CLAUDE.md` hoặc cấu hình tương đương.

Nội dung quy tắc mẫu là:

```txt
Always use Context7 when I need library/API documentation, code generation, setup or configuration steps without me having to explicitly ask.
```

Quy tắc này giúp agent chủ động dùng Context7 khi bạn cần tài liệu API, sinh mã, thiết lập hoặc cấu hình. Nếu bạn chỉ muốn gọi Context7 trong những lúc cần, hãy giữ cách dùng rõ ràng bằng cách thêm `use context7` vào prompt.

### Gỡ phần thiết lập nếu không dùng nữa

README cung cấp lệnh gỡ cấu hình do setup tạo ra:

```bash
npx ctx7 remove
```

Lệnh này gỡ phần setup được tạo bởi Context7. Nếu trước đó bạn cài CLI toàn cục bằng lệnh dưới đây, README nói cần gỡ riêng gói toàn cục:

```bash
npm install -g ctx7
npm uninstall -g ctx7
```

Chỉ chạy `npm uninstall -g ctx7` nếu bạn thực sự đã cài `ctx7` bằng `npm install -g ctx7`. Lệnh `npx ctx7 remove` và việc gỡ gói toàn cục là hai việc khác nhau.

## Kiểm tra đã chạy được chưa

Cách kiểm tra đơn giản là mở coding agent đã cấu hình và gửi một yêu cầu tài liệu có thêm `use context7`, chẳng hạn:

```txt
Create a Next.js proxy that checks for a valid JWT in cookies
and redirects unauthenticated users to `/login`. use context7
```

Một ví dụ khác:

```txt
Configure a Cloudflare Worker script to cache
JSON API responses for five minutes. use context7
```

Hoặc:

```txt
Show me the Supabase auth API for email/password sign-up.
```

Kết quả mong đợi là agent đưa tài liệu và ví dụ mã cập nhật vào ngữ cảnh trả lời, thay vì chỉ trả lời bằng kiến thức chung. Khi đã biết thư viện, hãy thử chỉ rõ ID:

```txt
Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.
```

Nếu agent nhận được tài liệu phù hợp hoặc các công cụ MCP `resolve-library-id` và `query-docs` xuất hiện trong client, cấu hình cơ bản đã hoạt động. README không đưa ra màn hình kiểm tra riêng hay một output cố định, nên không nên kỳ vọng một thông báo thành công duy nhất.

## Dùng vào việc thật

### Chủ shop cần làm trang đăng nhập

Một chủ shop thuê dev dựng trang quản trị bằng Next.js thường cần proxy kiểm tra JWT trong cookie. Nếu dev hỏi AI chung chung, câu trả lời có thể dùng API cũ hoặc bỏ sót cách chuyển hướng người chưa đăng nhập.

Hãy gửi prompt:

```txt
Create a Next.js proxy that checks for a valid JWT in cookies
and redirects unauthenticated users to `/login`. use context7
```

Context7 đưa tài liệu liên quan vào ngữ cảnh để agent sinh mã sát hơn với tài liệu hiện có. Kết quả mong muốn là đoạn mã proxy, điều kiện kiểm tra JWT và chuyển hướng về `/login` được giải thích cùng cách tích hợp vào dự án.

### Nhân viên văn phòng cần kiểm tra API đăng ký tài khoản

Một nhân viên phụ trách sản phẩm có thể cần mô tả chính xác quy trình đăng ký email và mật khẩu bằng Supabase để viết tài liệu nội bộ hoặc trao đổi với dev. Thay vì tự đoán tên hàm, hãy hỏi:

```txt
Show me the Supabase auth API for email/password sign-up. use context7
```

Nếu biết ID thư viện, có thể dùng:

```txt
Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.
```

Kết quả nhận được là tài liệu và ví dụ liên quan đến API Supabase. Việc chỉ rõ ID giúp Context7 bỏ qua bước ghép tên thư viện và truy xuất trực tiếp nguồn phù hợp.

### Dev cần cấu hình bộ nhớ đệm cho Cloudflare Worker

Một dev mới làm backend muốn lưu phản hồi JSON trong năm phút có thể yêu cầu agent viết cấu hình theo tài liệu Cloudflare Worker:

```txt
Configure a Cloudflare Worker script to cache
JSON API responses for five minutes. use context7
```

Agent sẽ dùng Context7 để lấy thông tin tài liệu và ví dụ mã liên quan. Kết quả thực tế là hướng dẫn cấu hình cache cho JSON API, giúp dev bắt đầu từ API đúng thay vì sao chép một ví dụ cũ không còn phù hợp.

### Dev muốn giữ đúng phiên bản thư viện

Khi dự án đã khóa phiên bản, hãy ghi rõ phiên bản trong prompt:

```txt
How do I set up a Next.js 16 proxy? use context7
```

Context7 sẽ tự khớp phiên bản phù hợp theo mô tả trong README. Cách này hữu ích khi API giữa các phiên bản thay đổi và bạn muốn agent trả lời trong phạm vi phiên bản dự án đang dùng.

> Khi AI viết mã dựa trên đúng tài liệu và phiên bản, bạn giảm được nhiều vòng sửa lỗi do API cũ hoặc không tồn tại.
>
> — Ông T

```note
API key giúp có hạn mức cao hơn nhưng vẫn cần bảo vệ như một thông tin bí mật.
Tài liệu do các dự án trong Context7 cung cấp có thể không hoàn toàn chính xác hoặc an toàn.
Hãy kiểm tra mã sinh ra trước khi đưa vào môi trường thật.
```

## Lỗi hay gặp và cách xử lý

### Node.js không đủ phiên bản

Nếu `npx ctx7 setup` không chạy đúng hoặc CLI báo vấn đề tương thích, hãy kiểm tra bằng `node --version`. CLI yêu cầu Node.js 22.13 hoặc mới hơn. Tư liệu được cung cấp không ghi lệnh cài Node.js cụ thể, nên hãy nâng Node.js theo cách phù hợp với máy của bạn rồi thử lại.

### Chạy sai tùy chọn agent

Các tùy chọn `--cursor`, `--claude` và `--opencode` nhắm tới những agent khác nhau. Nếu chọn sai, cấu hình có thể được tạo ở nơi bạn không sử dụng. Hãy chạy lại setup cho đúng agent hoặc dùng chế độ tương tác không thêm tùy chọn để chọn trong trình thiết lập.

### MCP không xác thực được

Khi cài thủ công, kiểm tra server URL có đúng là `https://mcp.context7.com/mcp` không và header có dạng `Authorization: Bearer YOUR_API_KEY` không. Lỗi thường đến từ việc quên chữ `Bearer`, để nguyên chữ `YOUR_API_KEY` hoặc dán thừa khoảng trắng vào key.

### Agent không tự gọi Context7

Hãy thêm `use context7` vào prompt để kiểm tra rõ ràng. Nếu muốn gọi tự động, kiểm tra skill đã được cài bởi `npx ctx7 setup` hoặc thêm quy tắc mẫu vào Cursor Settings > Rules, `CLAUDE.md` hay vị trí tương đương.

### Kết quả vẫn dùng API cũ hoặc không đúng thư viện

Hãy ghi rõ phiên bản và Context7 ID trong prompt. Ví dụ, thêm `use library /supabase/supabase` khi làm việc với Supabase. Nếu vẫn chưa chắc, dùng `ctx7 library <name> <query>` để tìm ID rồi dùng `ctx7 docs <libraryId> <query>` để lấy tài liệu cụ thể.

### Lo ngại về tài liệu hoặc mã không an toàn

README cảnh báo Context7 không bảo đảm mọi tài liệu của thư viện đều chính xác, đầy đủ hoặc an toàn. Các dự án được liệt kê do chủ dự án tương ứng phát triển và duy trì. Hãy xem xét mã, kiểm tra quyền truy cập và thử trong môi trường an toàn trước khi dùng cho dữ liệu thật.

## Có nên dùng không

Context7 đáng dùng nếu bạn thường nhờ AI viết mã dựa trên thư viện thay đổi nhanh. Cách cài qua `npx ctx7 setup` ngắn, hỗ trợ cả CLI + Skills và MCP, có thể dùng ID thư viện và phiên bản để làm câu trả lời sát với dự án hơn. Giấy phép của repo là MIT.

Giới hạn quan trọng là repo chỉ chứa mã nguồn MCP server. Backend API, bộ phân tích và bộ crawl là thành phần riêng, không nằm trong repo. Vì vậy, việc đọc mã repo này không đồng nghĩa bạn có toàn bộ hệ thống Context7 để tự vận hành độc lập.

Bạn cũng không nên xem Context7 như lớp bảo đảm mã sinh ra luôn đúng. README thừa nhận tài liệu có thể thiếu hoặc sai, và nội dung của các dự án bên ngoài có thể có rủi ro. Với mã liên quan đến thanh toán, xác thực, dữ liệu khách hàng hoặc quyền quản trị, vẫn cần dev kiểm tra và chạy test.

Nếu coding agent của bạn không hỗ trợ CLI, Skills hoặc MCP, Context7 có thể không phù hợp ngay. Khi đó, bạn có thể dùng tài liệu chính thức của thư viện theo cách thủ công. Còn nếu bạn đang dùng Cursor, Claude Code, OpenCode hoặc MCP client tương thích và thường gặp lỗi API cũ, Context7 là một lớp bổ sung đáng thử.

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

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

README nói bạn có thể lấy API key miễn phí từ dashboard Context7 để có hạn mức cao hơn. Tư liệu được cung cấp chưa mô tả chi tiết các gói trả phí hoặc giới hạn cụ thể.

### Có cần GPU để chạy Context7 không?

Không có yêu cầu GPU trong README. Tư liệu cũng không nêu cấu hình phần cứng tối thiểu.

### Context7 cần Node.js phiên bản nào?

CLI `ctx7` yêu cầu Node.js 22.13 hoặc mới hơn. README không nêu yêu cầu phiên bản Node.js riêng cho mọi thành phần khác trong repo.

### Có chạy được trên Windows không?

README không nêu danh sách hệ điều hành được hỗ trợ hoặc hướng dẫn riêng cho Windows. Vì vậy, tư liệu được cung cấp chưa xác nhận chi tiết khả năng chạy trên Windows.

### Context7 có thay thế tài liệu chính thức không?

Context7 đưa tài liệu và ví dụ cập nhật vào ngữ cảnh của coding agent, nhưng README cảnh báo không bảo đảm mọi tài liệu chính xác, đầy đủ hoặc an toàn. Bạn vẫn nên kiểm tra tài liệu và mã trước khi dùng.

### Dữ liệu và API key có an toàn không?

README yêu cầu truyền API key qua header `Authorization: Bearer YOUR_API_KEY` khi cấu hình MCP, nhưng không mô tả đầy đủ chính sách lưu trữ hay xử lý dữ liệu. Hãy giữ key bí mật và kiểm tra quyền truy cập trước khi dùng.

### Context7 khác gì so với việc tự tìm tài liệu trên web?

Context7 đưa tài liệu và ví dụ theo thư viện, ID và phiên bản trực tiếp vào ngữ cảnh của coding agent, giúp giảm việc chuyển qua nhiều tab. README không cung cấp so sánh chi tiết với một công cụ cụ thể khác.
