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

Когда звать

• Когда агент пишет код под библиотеку, которая недавно обновилась, и выдаёт устаревшие или несуществующие методы.
• Перед настройкой нового сервиса, SDK или фреймворка, когда нужна точная инструкция под конкретную версию.

Что это

Context7 - сервис от компании Upstash, который подкладывает агенту свежую документацию библиотек и примеры кода прямо в разговор. Проблема, которую он решает, знакома каждому, кто собирал что-то с агентом: модель знает библиотеку по состоянию на момент своего обучения. Библиотека за это время могла обновиться, и агент уверенно пишет код по старой версии или придумывает метод, которого нет.

С Context7 агент перед ответом сам ищет нужную библиотеку в базе сервиса и берёт оттуда куски документации под твой вопрос. Если ты назвал версию, например «Next.js 14», он возьмёт документацию этой версии.

Важно: это не скилл в привычном смысле. Основа Context7 - MCP-сервер, то есть подключение, через которое агент получает два новых инструмента. Для Claude Code и Codex он упакован в плагин: внутри подключение к серверу плюс скилл, который подсказывает агенту, когда туда ходить. Поэтому ставится он командой установки плагина, а не копированием папки в skills.

Сам сервер открытый, лицензия MIT. По README, открыт только код MCP-сервера: база документации, разбор и обход сайтов у Upstash закрытые и работают у них на серверах.

Как поставить

Команды сверены с README репозитория upstash/context7, страницей установки для разных программ на context7.com и официальным каталогом плагинов Claude Code на 28 сентября 2026 года.

Claude Code, из официального каталога Anthropic. Плагин context7 есть в каталоге claude-plugins-official, автор в карточке - Upstash:

/plugin install context7@claude-plugins-official

Эта версия подключается к серверу Context7 в интернете, ставить Node.js не нужно. Работает и без ключа, но тогда ты делишь общие лимиты для анонимных запросов. Чтобы были свои лимиты, заведи бесплатный ключ в кабинете context7.com/dashboard, пропиши его в переменной CONTEXT7_API_KEY (например, в ~/.zshrc) и перезапусти Claude Code.

Claude Code, из каталога самих Upstash. Здесь плагин полнее: кроме подключения к серверу в нём скилл, отдельный агент docs-researcher и команда /context7:docs:

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

После установки перезапусти Claude Code, набери /mcp, выбери Context7 и войди через браузер. Ключ в этом случае не обязателен.

Codex. У Context7 есть плагин и для Codex. Он подключается к серверу и добавляет скилл для поиска документации:

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

После установки откроется браузер для входа. Потом начни в Codex новый разговор, чтобы он подхватил плагин.

Одной командой для любых агентов. README предлагает ещё мастер настройки (нужен Node.js 18 или новее):

npx ctx7 setup

Он входит в твой аккаунт через браузер, заводит ключ и ставит скилл. Можно выбрать режим: через MCP-сервер или без него, через командную строку ctx7. Флаг --claude настраивает сразу Claude Code. Убрать всё обратно - npx ctx7 remove.

Вручную, как обычный MCP-сервер. Если плагины не подходят, на странице установки есть команды для 30 с лишним программ. Для Claude Code, например:

claude mcp add --scope user --header "Authorization: Bearer ТВОЙ_КЛЮЧ" --transport http context7 https://mcp.context7.com/mcp

Для Codex то же самое делается строками в ~/.codex/config.toml, образец - на странице установки в разделе OpenAI Codex.

Как проверить, что встало. В Claude Code набери /mcp: в списке должен быть context7 без ошибки. Потом спроси агента про любую библиотеку, например «как в Supabase сделать вход по почте и паролю», и посмотри, что он вызывает инструменты Context7, а не отвечает сразу.

Что умеет и как звать

У MCP-сервера два инструмента, агент зовёт их сам по порядку:

1. resolve-library-id - находит библиотеку по названию и возвращает её адрес в базе Context7, например /vercel/next.js.
2. query-docs - по этому адресу и твоему вопросу достаёт подходящие куски документации с примерами кода.

С плагином агент ходит туда сам, когда вопрос про библиотеку. Если нужно подтолкнуть, README советует дописать в запрос use context7:

Сделай middleware для Next.js, которое проверяет JWT в cookies
и отправляет неавторизованных на /login. use context7

Два приёма из README, которые экономят время:

• Назови версию прямо в запросе: «как настроить middleware в Next.js 14». Context7 подберёт документацию этой версии.
• Назови библиотеку адресом, если знаешь его: use library /supabase/supabase. Тогда агент пропустит шаг поиска и сразу возьмёт документацию.

В плагине из каталога Upstash есть ещё ручная команда /context7:docs next.js app router и агент docs-researcher: он ищет документацию отдельно и не засоряет твой основной разговор.

Правило, чтобы агент ходил туда без напоминаний

Если не хочешь каждый раз писать use context7, добавь правило в CLAUDE.md проекта или в общий ~/.claude/CLAUDE.md. Образец из README:

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

Можно по-русски: «Когда вопрос про библиотеку, фреймворк, SDK или API - сначала бери документацию через Context7, а не отвечай по памяти». У меня такое правило стоит в общих настройках агента для всех проектов: вопрос про любую библиотеку, даже самую известную, агент сначала сверяет с Context7. Как устроены такие правила - в статье про CLAUDE.md.

Чего Context7 не делает

• Не гарантирует точность каждой страницы. По README, библиотеки в базу добавляет сообщество, и Upstash прямо пишет, что не ручается за точность, полноту и безопасность всей документации. Для важных вещей сверяй с официальным сайтом библиотеки.
• Не заменяет чтение твоего кода. Он знает, как устроена библиотека, но не знает, как устроен твой проект.
• Не помогает с тем, чего нет в базе. Редкой или внутренней библиотеки там может не оказаться. Добавить свою библиотеку можно по инструкции на сайте Context7.
• Не работает без интернета. Документация приходит с серверов Upstash.

Вопросы и ответы

Это скилл или нет? Основа - MCP-сервер. Для Claude Code и Codex он приходит плагином, внутри которого есть и скилл. Поэтому ставится через /plugin install или codex plugin add, а не копированием папки.

Context7 бесплатный? Код сервера открыт под лицензией MIT. Плагин из каталога Anthropic работает и без ключа, бесплатный ключ даёт свои лимиты. Точные лимиты и платные тарифы - на сайте context7.com, мы их не пересказываем: они меняются.

Какой способ установки выбрать в Claude Code? Если нужно просто, чтобы агент брал свежую документацию, - плагин из официального каталога, одна команда. Если хочешь ручную команду /context7:docs и отдельного агента для поиска - плагин из каталога Upstash.

Работает ли в Codex? Да: плагином из каталога Upstash или как обычный MCP-сервер через codex mcp add или ~/.codex/config.toml.

Можно ли без MCP? Да. Мастер npx ctx7 setup умеет режим через командную строку ctx7: агент получает скилл и вызывает команды ctx7 library и ctx7 docs.

Автор и источник

Инструмент открытый, чужой, автор - Upstash, лицензия MIT. Описание и команды сверены с README репозитория upstash/context7, README плагина для Claude Code в том же репозитории, страницей установки для разных программ и карточкой плагина в каталоге claude-plugins-official на 28 сентября 2026 года. Инструмент обновляется, поэтому детали сверяй по первоисточнику. Где он в других наших материалах: статья плагины для Claude Code.