Когда MCP-сервер опубликованной документации включён, всё нужное для подключения уже есть на портале: блок Подключиться к MCP на каждой странице даёт адрес эндпоинта и готовые команды. Не хватает только повода туда заглянуть — большинство читателей просто не знает, что такая возможность существует.
Закрыть этот пробел поможет короткая страница в вашей собственной документации. Ниже — шаблон, который можно взять за основу.
Шаблон
Скопируйте текст ниже на страницу своей документации и подставьте название продукта, подправив тон под ваш стиль:
Работа с нашей документацией через ИИ-агента
Наша документация доступна ИИ-агентам по протоколу Model Context Protocol (MCP). Подключите агента один раз — и сможете задавать ему вопросы о продукте, не выходя из привычных инструментов: он будет отвечать по этой документации, а не по тому, что запомнил.
Чтобы подключиться, откройте любую страницу нашей документации, нажмите Копировать страницу и воспользуйтесь блоком Подключиться к MCP. Там можно скопировать данные для подключения поддерживаемого агента или адрес сервера, чтобы настроить агента самостоятельно.
У ИИ-агента будет доступ только на чтение. Неавторизованные читатели получают доступ к открытой документации, а авторизованные читатели могут читать закрытые публикации, к которым у них есть доступ.
Чего не стоит добавлять
Мы советуем сделать страницу короткой и отсылать читателей к блоку Подключиться к MCP, а не пересказывать его содержимое. В частности, не стоит перечислять поддерживаемых агентов и команды подключения в своём тексте. Блок формируется порталом, и он остаётся актуальным по мере того, как список поддерживаемых агентов растёт; копия в вашей статье — нет, а читатель, выполнивший устаревшую команду, решит, что функция сломана.
По той же причине не описывайте настройку конкретных агентов. Настройка Claude, Cursor и любого другого агента — область ответственности их разработчика: она может со временем меняться, а читатели, которые уже пользуются агентом, и так знают свой инструмент.
Где разместить
Читатели ищут такие вещи там же, где и другие способы работы с документацией, поэтому раздел о начале работы или страница о том, как пользоваться самой документацией, обычно подходят лучше, чем отдельный раздел. Если вы публикуете историю обновлений, достаточно один раз упомянуть эту возможность при включении — так вы доведёте обновление до читателей, которые и так следят за вашими обновлениями.