MCP для документации: чтобы агент не выдумывал методы библиотек

Короткий ответ

Модель обучена на данных до определённой даты. Всё, что вышло позже, она не знает — но об этом не говорит, а уверенно предлагает метод, которого в библиотеке нет или который уже переименовали.

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

npx -y @upstash/context7-mcp

В Codex это выглядит как codex mcp add context7 -- npx -y @upstash/context7-mcp, в Cursor — четыре строки в mcp.json.

Почему это лучшее первое подключение

Три причины.

Не требует ваших данных. Серверу не нужен доступ к вашим файлам, базам и аккаунтам. Он читает публичную документацию. Значит, и рисковать нечем — редкое свойство для MCP-сервера.

Эффект виден сразу. Разница между «агент выдумал функцию» и «агент взял из справки» заметна на первой же задаче, её не нужно специально измерять.

Не мешает. Один сервер — небольшой список инструментов, агент не путается, чем пользоваться.

Как понять, что он нужен

Признак простой: агент пишет код, который выглядит правильным, но не запускается, и ошибка вида «нет такого метода» или «неожиданный аргумент». Особенно на библиотеках, которые часто меняются.

Второй признак — вы регулярно поправляете агента фразой «этот способ устарел, теперь делается иначе». Если такое повторяется, вы вручную выполняете работу, которую сделал бы сервер документации.

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

Не заменяет чтение документации вам. Агент получит справку по конкретной библиотеке, но решение, какую библиотеку брать, останется за вами.

Не поможет с вашей внутренней документацией: сервер знает публичные проекты. Для внутренней справки нужен другой подход — файловый сервер, направленный на каталог с документами, или сервер поверх вашей базы знаний.

Не спасёт от ошибок в логике. Он убирает конкретный класс проблем — устаревшие и выдуманные вызовы, — и только его.

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

Общий порядок одинаков для всех агентов: описать сервер в конфиге, перезапустить, проверить, что инструмент появился в списке. По шагам разобрано в инструкции по подключению MCP.

Форма записи отличается: JSON в Cursor, TOML в Codex, массив команд в OpenCode. Сервер при этом один и тот же — в этом и смысл протокола, о котором подробнее в объяснении MCP.

Другие серверы, которые стоит попробовать следом, собраны в списке.