Context7 — это сервис от Upstash, который подтягивает свежую, версионную документацию библиотек и реальные примеры кода прямо в контекст вашего coding-агента. Решает базовую боль: модель помнит API годовой давности, придумывает несуществующие методы и выдаёт код под старые версии пакетов.
Когда вы просите агента «сделай middleware на Next.js», он опирается на то, что запомнил при обучении. Между обучением и сегодняшним днём библиотека успела обновиться — отсюда устаревший код и галлюцинации API.
Context7 встаёт между агентом и документацией: по ходу запроса он находит нужную библиотеку, забирает из неё актуальные доки и примеры под конкретную версию и кладёт их в промпт. Никаких переключений на вкладку с документацией.
Работает в двух режимах — выбираете при установке:
ctx7. MCP при этом не нужен.Самый короткий путь — общий установщик ctx7. Он спрашивает целевого агента, проходит OAuth, генерирует API-ключ и ставит нужный скилл или MCP-режим. Нужен Node.js 18 или новее.
# Универсальная установка с выбором агента и режима
npx ctx7 setup
# Сразу под конкретного агента
npx ctx7 setup --claude
npx ctx7 setup --codexЛогин идёт через OAuth device flow: показывают ссылку и короткий код, который вы открываете на любом устройстве. Поэтому установка одинаково работает локально и на удалённом / headless / SSH-сервере.
Удалить настройку позже:
npx ctx7 removeВ Codex Context7 живёт как MCP-сервер. CLI, Desktop-приложение (macOS и Windows) и IDE-расширение читают одну и ту же конфигурацию из ~/.codex/config.toml.
Самый быстрый способ — одна команда npx ctx7 setup --codex: она проходит OAuth, генерирует ключ и прописывает Context7 в ~/.codex/config.toml и AGENTS.md. Ниже — ручные варианты, если нужен контроль над конфигом.
Вариант 1. Через терминал — самый простой:
codex mcp add context7 -- npx -y @upstash/context7-mcp --api-key ВАШ_API_КЛЮЧВариант 2. Локальный npx-сервер в конфиге. Откройте ~/.codex/config.toml (для доверенного проекта можно положить рядом .codex/config.toml) и добавьте:
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp", "--api-key", "ВАШ_API_КЛЮЧ"]
startup_timeout_ms = 20_000 # запас на первый запуск npx, иначе бывает таймаутВариант 3. Хостинговый сервер Upstash — если не хотите поднимать npx-процесс локально:
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "CONTEXT7_API_KEY" = "ВАШ_API_КЛЮЧ" }В Codex Desktop то же самое включается из настроек MCP в самом приложении. Конфиг общий с CLI, так что добавленный сервер подхватывается автоматически.
npx иногда падает с ошибкой «request timed out» или «not found program». Поднимите startup_timeout_ms до 40_000 и повторите. На Windows дополнительно укажите в command абсолютный путь к npx.cmd и явно задайте переменные SystemRoot и APPDATA — npx их требует, но некоторые MCP-клиенты Codex не передают их по умолчанию.Плагин для Codex. Context7 ставится и как плагин — он подключается к хостинговому MCP-серверу и добавляет скилл, который сам ищет документацию:
codex plugin marketplace add upstash/context7
codex plugin add context7@context7-marketplaceПосле установки откроется браузер для входа через OAuth, запросы считаются по вашему тарифу. Запустите новый тред Codex, чтобы он подхватил скилл и инструменты плагина.
Чтобы Codex сам обращался к Context7 на вопросах про библиотеки, добавьте правило в AGENTS.md проекта:
Когда мне нужна документация библиотеки или API, генерация кода, шаги
настройки или конфигурации — всегда используй Context7, не дожидаясь
отдельной просьбы.У Claude Code два пути: лёгкий MCP-сервер и полноценный плагин со скиллами, агентами и командами.
Быстрая установка ставит скилл, который срабатывает автоматически:
npx ctx7 setup --claudeТолько MCP-сервер вручную — если плагин не нужен:
# --scope user ставит для всех проектов; уберите его для текущего проекта
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key ВАШ_API_КЛЮЧПолный плагин Context7 добавляет поверх MCP-сервера скилл, агента docs-researcher и команду /context7:docs:
/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplaceЧтобы запросы плагина считались по вашему тарифу, а не по анонимному, пропишите ключ в окружение перед запуском Claude Code:
# например, в ~/.zshrc или ~/.bashrc
export CONTEXT7_API_KEY="ваш-api-ключ"Плагин читает CONTEXT7_API_KEY сам. После установки ключа перезапустите Claude Code.
| Компонент | Зачем нужен |
| MCP Server | Сами инструменты: resolve-library-id и query-docs |
| Skill | Сам срабатывает на вопросах про библиотеки — «use context7» писать не нужно |
Agent docs-researcher | Ищет доки в отдельном контексте и возвращает только ответ, не засоряя основной диалог |
Команда /context7:docs | Ручной запрос документации, когда вы точно знаете библиотеку и тему |
Если ставили вручную без скилла, добавьте то же правило в CLAUDE.md:
Всегда используй Context7, когда мне нужна документация библиотеки/API,
генерация кода или шаги настройки — без отдельной просьбы.Достаточно дописать use context7 — агент сам найдёт библиотеку и подтянет доки:
Создай middleware для Next.js, который проверяет валидный JWT в куках
и редиректит неавторизованных на /login. use context7Настрой Cloudflare Worker, который кэширует JSON-ответы API на пять минут. use context7Покажи актуальный синтаксис Supabase для row-level security. use context7Достаточно упомянуть версию в запросе — Context7 подберёт доки именно под неё:
Как настроить middleware в Next.js 15? use context7Если точно знаете библиотеку, передайте её Context7-ID в формате /org/project — агент пропустит шаг поиска и сразу заберёт доки:
Реализуй базовую аутентификацию в Supabase. use library /supabase/supabase for API and docs.use context7 with /vercel/next.js for app router setupРучной запрос документации через команду плагина:
/context7:docs react hooks
/context7:docs /supabase/supabase row level securityКогда диалог длинный и не хочется засорять контекст вызовами инструментов — отправьте поиск в отдельного агента:
spawn docs-researcher: как настроить Prisma с PostgreSQL?
spawn docs-researcher to find Tailwind CSS grid utilitiesdocs-researcher работает в своём контексте на более лёгкой модели (Sonnet) и возвращает в основной диалог только готовый ответ.
Если вы выбрали режим CLI + Skills, агент забирает доки через ctx7:
# Найти библиотеку и её Context7-ID по имени
ctx7 library next.js "app router middleware"
# Забрать документацию по известному ID
ctx7 docs /vercel/next.js "app router middleware"В Claude Code есть выбор: тянуть доки прямо в диалог или через отдельного агента. Ориентир простой:
| Ситуация | Что использовать |
| Глубоко в задаче, контекст уже длинный | Агент docs-researcher |
| Хочется не раздувать контекст | Агент docs-researcher |
| Контекст короткий | Инлайн-инструменты |
| Хочется видеть доки прямо в переписке | Инлайн-инструменты |
Независимо от клиента Context7 предоставляет два MCP-инструмента:
resolve-library-id — превращает обычное имя библиотеки в Context7-совместимый ID. Принимает libraryName (что искать) и query (ваш вопрос — нужен для ранжирования результатов по релевантности).query-docs — забирает документацию по точному ID. Принимает libraryId (например, /mongodb/docs или /vercel/next.js) и query (конкретный вопрос).В режиме CLI те же шаги делают команды ctx7 library (поиск ID) и ctx7 docs (получение доков).
--api-key или переменную CONTEXT7_API_KEY.ctx7 и npx-режима MCP-сервера.startup_timeout_ms или глобальной установкой пакета.Если вы настраиваете Codex или Claude Code под свои проекты и хотите, чтобы агент работал с актуальной документацией, а не с памятью годовой давности, это как раз тот случай, где имеет смысл собрать конфигурацию под вашу команду.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov.
Можно прийти с идеей, черновым контекстом или уже живой задачей. Помогу быстро понять, где реальный следующий шаг, а где лишний шум.
Обычно хватает 2–3 сообщений, чтобы понять, могу ли я здесь реально помочь и в каком формате лучше двигаться дальше.
Практический кейс миграции из «наследной» amoCRM в open-source Twenty CRM: аудит процессов, перенос 50 активных сделок с помощью OpenClaw-агента, нормализация данных и сборка дашбо…
Linear — быстрый issue tracker и project-инструмент для команд разработки. Разбираем возможности, тарифы и интеграцию с OpenAI Codex: cloud-агент прямо в issues и MCP-сервер для Co…
SpaceX отдаёт Anthropic всю мощность Colossus 1, лимиты Claude растут, а на фоне суда Маска с OpenAI это выглядит как публичный жест в сторону Альтмана.
Мы используем cookie и аналитические сервисы Яндекс.Метрика, Top.Mail.Ru и Umami для анализа посещаемости и улучшения сайта. Продолжая пользоваться сайтом, вы соглашаетесь с Политикой обработки персональных данных.