Context7 — свежая документация для агента

Context7 — сервис от Upstash, который подаёт ИИ-агенту свежую документацию библиотек прямо в промпт: агент перестаёт писать код по устаревшему API и выдумывать методы. Подключается одной командой npx ctx7 setup — как MCP-сервер по адресу https://mcp.context7.com/mcp либо как скил с обращениями через CLI. Бесплатный план даёт тысячу вызовов в месяц, Pro стоит 10 долларов за место. Проверено по документации 20 августа 2026 года.

Часть 1 · Знакомство

Что такое Context7 и какую боль он лечит

Знакомая картина: агент уверенно пишет вызов метода, которого в библиотеке нет, или предлагает конфиг от давно устаревшей версии. Причина простая: дата среза обучающих данных. Что вышло после неё, для модели попросту не существует. Про механику этих ошибок подробно разобрано в гайде о том, почему нейросети выдумывают факты. Context7 закрывает этот разрыв данными вместо уговоров: он держит индекс документации и по запросу отдаёт кусок, относящийся к делу.

В описании платформы перечислены источники индексации: репозитории GitHub, GitLab и Bitbucket, сайты документации, файлы llms.txt, спецификации OpenAPI и пространства Confluence. Библиотека адресуется парой /организация/проект — например /vercel/next.js — и по желанию версией: /vercel/next.js@14.0.0. Открытый код у проекта только на MCP-сервер: бэкенд, парсер и краулер в репозиторий не входят, о чём в README сказано прямо.

Часть 2 · Подключение

Как подключить Context7

Установщик ctx7 требует Node.js 18 или новее. Без флагов он сам определяет окружение, с флагом целится в конкретного клиента.

# автоопределение клиента
npx ctx7 setup

# под конкретного агента
npx ctx7 setup --claude
npx ctx7 setup --cursor
npx ctx7 setup --codex
npx ctx7 setup --opencode
npx ctx7 setup --antigravity

# снести настройку
npx ctx7 remove

Внутри команды происходит три вещи: вход через OAuth, выпуск ключа API и установка скила. По ходу спрашивают, какой режим нужен — CLI со скилами или MCP. Если ctx7 ставился глобально через npm install -g ctx7, пакет сносится отдельно командой npm uninstall -g ctx7 — ctx7 remove убирает только сгенерированную настройку.

Часть 3 · Работа

Как пользоваться: id библиотеки и версии

После установки через ctx7 setup скил срабатывает сам, когда речь заходит про библиотеки, — фразу «use context7» дописывать не обязательно. Явное обращение остаётся полезным, когда хочется гарантированно попасть в нужный источник или в конкретную версию.

# просто вопрос — скил сработает сам
Покажи, как настроить middleware в Next.js 15

# явное обращение
use context7 to show me how to set up middleware in Next.js 15

# сразу с идентификатором библиотеки, без шага поиска
use context7 with /supabase/supabase for authentication docs

# конкретная версия
How do I set up Next.js 14 middleware? use context7

Инструментов у сервера всего два, и это делает поведение предсказуемым. resolve-library-id превращает человеческое имя библиотеки в идентификатор Context7, query-docs забирает по этому идентификатору документацию под конкретный вопрос. В режиме CLI те же два шага делаются командами ctx7 library и ctx7 docs.

Часть 4 · Плагин

Плагин Context7 для Claude Code

/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace

• MCP-сервер. Те же два инструмента — resolve-library-id и query-docs.
• Скил. Срабатывает сам на вопросы про библиотеки, фреймворки и примеры кода.
• Субагент docs-researcher. Работает в отдельном контексте и возвращает только ответ, поэтому вызовы инструментов не засоряют основную сессию. По документации он идёт на более лёгкой модели Sonnet.
• Команда /context7:docs. Ручной запрос документации, когда нужно точечно.

Субагент здесь не украшение: длинная сессия быстро зарастает выводом инструментов, а вместе с ней растёт счёт за токены. Вынести справочные походы в отдельный контекст — ровно тот приём, который разбирается в гайде про экономию токенов. Если нужен не готовый сервер, а свой, механика описана в инструкции по сборке MCP-сервера.

Часть 5 · Деньги

Тарифы Context7 и лимиты вызовов

Цены и лимиты сверены по странице тарифов 20 августа 2026 года.

Поведение на пределе описано отдельно и отличается по планам. На бесплатном доступ блокируется до конца месяца, но каждый день выдают 20 бонусных вызовов, чтобы работа не встала совсем. На Pro блокировки нет — избыток просто тарифицируется. Важная деталь для команд: лимит привязан к месту, а не к общему счётчику, и неизрасходованные вызовы одного участника не переходят другому.

Вопросы

Частые вопросы

Читать дальше

Соседние гайды