Context7 是什麼？讓 AI 寫程式前先查最新文件，Claude Code 怎麼接，實測對照

用 AI 寫程式，常遇到這種事：它很有把握地給你一段程式，結果那個函式早就改名了，或某個設定要新版才有，它給的是兩年前的寫法。原因很單純，模型知道的東西停在訓練的那一天，之後的改版它不知道。

Context7 就是處理這件事的。它是一個 MCP 伺服器，讓 Claude Code、Cursor 這類 AI 工具在回答之前，先去查那個函式庫最新的官方文件，把查到的段落放進對話裡再回答。

這篇講它是什麼、怎麼接、要不要金鑰，然後用一個我能自己驗證答案的問題，讓 Claude Code 分別在接與不接的情況下回答一次。MCP 本身是什麼，在 MCP 是什麼。

Context7 是什麼

Context7 是 Upstash 這家公司做的。官方 README 的說法是：它把最新的、對應版本的文件和程式範例，直接拉進你的提示裡，避免過時的範例和根本不存在的 API。

它有兩種用法：

• MCP：當成 MCP 伺服器接到 AI 工具上，讓 AI 自己呼叫查文件的工具。這篇主要講這種。
• CLI 加 Skills：裝一個叫 ctx7 的指令，再裝一個技能教 AI 用這個指令查文件，不用 MCP。

它的 MCP 伺服器只提供兩個工具，兩個都只讀不寫：

• resolve-library-id：用名字找函式庫，回一份清單和每個函式庫的 ID。要給函式庫名稱（libraryName）和你想問的事（query）。
• query-docs：拿 ID 去查文件，回相關的段落和程式範例。要給 ID（libraryId）和問題（query），也可以指定程式語言。

順序是固定的：先找 ID，再查文件。

怎麼接

官方最省事的做法是一行指令，它會帶你登入、產生 API 金鑰、裝好設定（需要 Node.js 22.13 以上）：

npx ctx7 setup

也可以手動接。它是放在網路上的伺服器，網址是 https://mcp.context7.com/mcp。在 Claude Code 裡：

claude mcp add --transport http context7 \
  https://mcp.context7.com/mcp

有金鑰的話，再加上 --header "Authorization: Bearer 你的金鑰"。我實測時不想改到自己的設定，用的是只在那一次有效的設定檔，連的是同一個網址。

要不要金鑰？官方 README 寫的是「建議」：到 context7.com 的後台拿一組免費的，額度比較高。我這次全程沒有帶金鑰，查了好幾次都正常。不帶金鑰的上限是多少，README 沒有寫數字，我也沒有測到上限。

官方還提到兩個用法上的小技巧。一是直接在問題裡寫函式庫的 ID，例如 use library /supabase/supabase，可以跳過找 ID 那一步。二是在問題裡提到版本，它會對到那一版的文件。

實測一：直接呼叫，看它回什麼

我先不經過 AI，用 curl 照 MCP 的規格直接呼叫它，看每一步回什麼。

伺服器報的版本是 4.4.1，每次請求各自獨立（沒有連線編號）。兩個工具都標成唯讀。

找函式庫：我用「n8n」去找，2 秒回來，清單裡有 5 個都叫 n8n 的函式庫。排第一的是 n8n 官方的文件（/n8n-io/n8n-docs），有將近一萬段程式碼；另外還有 n8n 官網、n8n 的程式碼倉庫，以及一個第三方在 GitHub 上整理的版本。每一個都標了 Source Reputation（來源的可信度）和一個分數。

這點要注意：同一個名字會找到好幾個來源，不一定都是官方的。

查文件：我拿官方文件的 ID 去問「自架的 n8n 要哪一版才有 Agents 功能」，2 秒回來 5 段文件，每一段都附上它在 n8n 文件 GitHub 上的原始檔網址。其中一段寫的就是：

Agents are available on all self-hosted plans from n8n 2.32.3.

這句跟我同一天在 n8n 官網讀到的文件一致（我在 n8n AI Agent 教學裡用過這個資訊）。

實測二：同一題，Claude Code 接與不接

接著我用 Claude Code 問同一題，關掉所有其他工具，只看它在有沒有 Context7 的情況下怎麼答：

自架的 n8n 要哪一版以上，才有 Agents（Agent Builder）這個功能？請簡短回答版本號，並說你的根據是什麼。

不接 Context7，它回的第一句是：

我無法給你可靠的版本號。

它說這個 session 查不了網路，訓練資料裡也沒有能確定的資訊，硬給一個數字就是在猜；然後提醒我別跟 n8n 的 AI Agent 節點搞混，建議去查 release notes。花了 18 秒。

老實說，這個回答比我預期的好：它沒有亂編一個版本號。但也就到這裡為止了，你還是得自己去查。

接上 Context7（問題後面加上 use context7），它做了三件事：先找 n8n 的函式庫 ID，再查兩次官方文件，然後回答：

n8n 2.32.3 以上。

並引用文件裡「Self-hosted: All plans from n8n 2.32.3」那一句，再補了幾個自架要注意的地方：功能還在預覽階段、可以在 Settings > Agents 開關、還不支援 queue mode。答案正確，花了 18 秒，跟不接的時候差不多。

用之前要知道的

查到的不一定都對。官方 README 的免責聲明寫，Context7 裡的專案是社群貢獻的，不保證正確、完整或安全；而且開源的只有 MCP 伺服器這一層，後面整理文件的系統是私有的。像上面查 n8n 會找到第三方整理的版本，挑的時候優先用官方的那一個。

AI 不一定會主動用。官方建議在問題後面加 use context7，或在 CLAUDE.md 這類專案說明裡加一條規則，例如「需要函式庫文件或設定步驟時，一律先用 Context7 查」。CLAUDE.md 是什麼，在 Claude Code 教學。

查到的文件會進到對話裡。這次每查一次，回來一千到五千多個字元，都算在 AI 的用量裡。

它查的是公開文件。你自己公司內部的程式庫，它不會知道。

這篇沒有測的

npx ctx7 setup，以及 CLI 加 Skills 的用法。setup 要登入帳號，我沒有做。

帶 API 金鑰之後的額度差異，以及不帶金鑰會在什麼時候被擋。

Cursor、VS Code 等其他編輯器的設定。官方有一頁列了三十幾種用戶端的設定方法。

同類的熱門 MCP 伺服器，還有讓 AI 操作瀏覽器的 Playwright MCP，我實際跑過，在 Playwright MCP 教學；量網頁速度和跑 Lighthouse 的在 Chrome DevTools MCP 教學；讓 AI 讀 Figma 設計稿寫程式的在 Figma MCP 教學；Claude Code 加 MCP 伺服器的基本做法，在 Claude Code MCP。