# Context7 — актуальная документация

> Подключите агента — и он будет сверяться с актуальной документацией нужной версии библиотек, с которыми работает, а не полагаться на то, что помнит с обучения.

Source: https://docs.neurosquad.ai/ru/plugins/context7-docs

Модель знает библиотеку такой, какой та была на момент обучения. А API меняются: у хука новая
сигнатура, опцию конфига переименовали, фреймворк перешёл на новый роутер. Плагин **Context7** даёт
подключённому агенту два инструмента из [Context7](https://github.com/upstash/context7) — открытого
проекта Upstash: найти библиотеку и прочитать её текущую документацию и примеры кода — для той
версии, которая стоит в проекте.

## Как пользоваться

1. В меню добавления карточки выберите **Плагины**, откройте **Context7 — актуальная документация**
на вкладке **Плагины** и нажмите **Добавить на канвас**.
2. Проведите [стрелку](https://docs.neurosquad.ai/ru/canvas/arrows) от агента к карточке.

Теперь у агента два инструмента:

- `context7_resolve_library_id` — находит библиотеку по названию («React», «Next.js», «Django») и
перечисляет совпадения с их id в Context7 (`/reactjs/react.dev`), числом примеров кода,
надёжностью источника и проиндексированными версиями.
- `context7_query_docs` — возвращает документацию и примеры одной библиотеки по одному конкретному
вопросу («useEffect cleanup function»).

Большинство агентов сами обращаются к ним, когда задача касается API библиотеки. Можно и попросить:
«сначала сверься с документацией Next.js» — или дописать в промпт **use context7**. Уберите стрелку —
инструменты пропадут. Для большинства CLI без перезапуска, в сам CLI ничего не устанавливается.

## Работает без аккаунта

Индекс документации Context7 — облачный сервис, бесплатный. Без ключа у него лимит запросов ниже;
бесплатный API-ключ из [панели Context7](https://context7.com/dashboard) его поднимает. Вставьте ключ
в панели **Ключ и кеш** на карточке — он хранится зашифрованным на вашем компьютере, больше не
показывается и никогда не попадает в файлы или командную строку. Один ключ на все карточки Context7.

Карточка показывает, сколько запросов осталось и когда лимит сбросится. Когда лимит исчерпан,
карточка пишет **Лимит исчерпан**, агенты получают понятное сообщение вместо ошибки, а новые запросы
не отправляются до сброса — ответы из кеша при этом работают.

## Кеш

Каждый ответ хранится на компьютере 24 часа. Если два агента спросили одно и то же или агент
повторил вопрос, ответ берётся из кеша и не тратит запрос. Панель **Ключ и кеш** показывает, сколько
ответов в кеше и сколько запросов он обслужил, и умеет его очищать.

## Автодокументация

Включите **Автодокументацию** на карточке — и агент будет получать подсказку перед каждым вашим
промптом:

- Если промпт упоминает зависимость проекта (из `package.json`, `requirements.txt`,
`pyproject.toml`, `Cargo.toml` или `go.mod`), агент получает короткую заметку, что для неё есть
актуальная документация, — с версией из вашего проекта. Запрос при этом не отправляется, так что
ход начинается так же быстро. Заметка — не чаще раза в полчаса на библиотеку.
- Если в промпте есть слово **context7** («use context7») и названа зависимость или id библиотеки
(`/vercel/next.js`), в ход сразу добавляется сама документация. NeuroSquad ждёт её около полутора
секунд; если Context7 отвечает медленнее, агент получает заметку, а ответ сохраняется в кеш на
следующий раз.

Автодокументация работает в **Claude Code**, **Codex**, **Qwen Code**, **OpenCode**, **Kilo Code**,
**MiMo Code**, **pi**, **omp**, **Antigravity CLI** и **ZCode**. Любой другой агент, подключённый стрелкой, получает оба инструмента.

## Воркспейсы в WSL и по SSH

Агенты в воркспейсе внутри WSL или на SSH-хосте получают оба инструмента по стрелке как обычно —
запросы делает NeuroSquad на этом компьютере. Автодокументация читает `package.json` и другие
манифесты проекта из WSL или через SSH-соединение.

## Что показывает карточка

- Состояние сервиса — **Готово**, **Лимит исчерпан**, **Нет связи** или **Ошибка** — с остатком
запросов и датой сброса.
- **Проверить запрос**: введите библиотеку и вопрос и посмотрите, что получил бы агент.
- **Последние запросы**: какая библиотека и вопрос, какой агент спросил, когда и взят ли ответ из
кеша.

> Названия библиотек и вопросы отправляются на серверы Context7 (их держит Upstash). Не пишите в
> вопросах секреты, пароли и закрытый код — описания инструментов говорят агентам то же самое.
> Остальной проект остаётся на компьютере: автодокументация читает список зависимостей локально и
> отправляет только название библиотеки и вопрос.

## Откуда это

Оба инструмента — инструменты официального MCP-сервера Context7 (`@upstash/context7-mcp`, лицензия
MIT) с его описаниями; NeuroSquad обращается к тому же API Context7 напрямую, поэтому ничего
дополнительно не устанавливается и не запускается. Сам индекс документации — облачный сервис
Context7. Если нужен поиск по документации, который никогда не покидает компьютер, вместо него можно
добавить самостоятельно размещаемый MCP-сервер документации со вкладки **MCP** каталога.
