Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi Context7 lấy docs và ví dụ code đúng phiên bản thư viện, đưa thẳng vào prompt, để agent bớt viết theo API cũ hoặc API không có thật. Gõ thêm "use context7" hoặc ID thư viện như /supabase/supabase là được. | README, Important Tips |
|---|---|---|
| Ưu | Bài review của Elite AI Advantage (25/04/2026) viết rằng cài mất khoảng năm phút, và Claude tự gọi tool khi câu hỏi dính tới thư viện, bạn không phải viết prompt riêng. | Elite AI Advantage, review |
| Ưu | Có gói miễn phí 1.000 lượt gọi mỗi tháng, đủ để thử trên một dự án cá nhân trước khi quyết định trả 10 USD mỗi tháng cho gói Pro. | Trang giá Context7 (đọc 2026-10-29) |
| Nhược | Câu hỏi bạn gõ và tên thư viện được gửi lên máy chủ của Context7. README ghi phần backend, bộ đọc docs và bộ crawl là code đóng, không nằm trong repo này. | README, Disclaimer |
| Nhược | Tháng 2/2026, nhóm Noma Security tìm ra lỗi ContextCrush: ai có tài khoản GitHub cũng đăng ký được một thư viện và gắn "Custom Rules", và MCP server chuyển nguyên văn các rule đó cho agent. VulnCheck ghi kẻ xấu có thể dùng cách này để lấy khóa trong file .env hoặc xóa file. Context7 ghi đã sửa phía server ngày 23/02/2026; mã CVE-2026-75130 được công bố tháng 8/2026. | VulnCheck advisory |
| Nhược | Lệnh ctx7 gửi sự kiện sử dụng (tên lệnh, agent nào, cài cho máy hay cho dự án) về context7.com. Việc này bật sẵn; muốn tắt thì đặt biến môi trường CTX7_TELEMETRY_DISABLED. | packages/cli/src/utils/tracking.ts |
| Nhược | Kho thư viện do cộng đồng gửi lên nên có bản trùng và bản cũ. Issue #339 được ghim từ 06/2025 và vẫn mở, người dùng còn báo bản trùng của uv, Nuxt 4 và docs Velocity đã cũ đến tháng 9/2026. | Issue #339 |
| Chưa rõ | `ctx7 setup` tải nội dung skill và rule từ nhánh master trên GitHub lúc bạn chạy. Ghim `[email protected]` chỉ ghim được CLI; nội dung skill ghi vào máy có thể khác với bản mình đọc. | packages/cli/src/setup/templates.ts |
| Chưa rõ | Bản từ xa mcp.context7.com do Upstash vận hành. Mình chỉ đọc được code trong repo, nên không kiểm tra được máy chủ đang chạy đúng code đó hay không. | README, Disclaimer |
Khi nên dùng
- Agent hay viết code theo API cũ của thư viện phổ biến như Next.js hay Supabase, và bạn chấp nhận gửi câu hỏi lên máy chủ Context7.
Khi không nên dùng
- Dự án dùng thư viện nội bộ hoặc thư viện chưa có trong Context7, máy không ra được mạng, hoặc câu hỏi có thông tin không được gửi ra ngoài.
Cách cài
Claude Code
npx [email protected] setup --claudeClaude Code
claude mcp add --scope user --header "Authorization: Bearer YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcpCodex
codex mcp add context7 -- npx -y @upstash/[email protected] --api-key YOUR_API_KEYNó chạm vào những gì
- File đọc và ghi
- `ctx7 setup` mặc định ghi cho cả máy: thêm mục context7 vào ~/.claude.json, ghi ~/.claude/rules/context7.md và một skill trong ~/.claude/skills/. Thêm `--project` thì ghi vào .mcp.json, .claude/rules và .claude/skills của dự án. Khóa đăng nhập lưu ở ~/.config/context7/credentials.json (quyền 0600). Bản MCP server không ghi file nào.
- Gọi mạng
- Mỗi lần tra docs, câu hỏi của bạn và tên thư viện được gửi lên context7.com/api (v2/libs/search, v2/context). Bản từ xa nối tới mcp.context7.com; đăng nhập qua clerk.context7.com. Lúc setup, CLI tải skill và rule từ raw.githubusercontent.com/upstash/context7 (nhánh master) và kiểm tra bản mới trên registry.npmjs.org. CLI gửi sự kiện sử dụng về context7.com/api/v2/cli/events.
- Script lúc cài
- package.json của ctx7 và @upstash/context7-mcp không có postinstall. npx tải gói từ npm rồi chạy.
- Tiến trình
- Bản local: agent bật một tiến trình Node (stdio). Bản từ xa: không có tiến trình nào trên máy bạn. Đây là MCP server và CLI của bên thứ ba: nó chạy code với quyền của tài khoản bạn.
Đọc từ: agents.ts#L120-L150, setup.ts#L555, storage-paths.ts#L22-L36, api.ts#L143-L210, constants.ts#L10-L25, templates.ts#L1-L75, update-check.ts#L196, tracking.ts, package.json
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin