Если включить MCP-сервер опубликованной документации, читатели смогут подключать к вашей документации собственные ИИ-агенты. В этой статье описаны нужные настройки портала и способ проверить, что сервер отвечает.
Включение сервера
- Откройте настройки портала, ИИ интеграции → МСР-сервер.
- Найдите блок MCP-сервер опубликованной документации. На странице два независимых блока, и другой отвечает за авторский MCP-сервер — это отдельный функционал со своими правилами доступа.
- Установите галочку, чтобы включить сервер.
После включения адрес эндпоинта становится доступен читателям прямо в читательском интерфейсе — в блоке Подключиться через MCP, вместе с готовыми командами для подключения.
| На портале должна быть хотя бы одна опубликованная открытая или закрытая публикация. MCP-сервер опубликованной документации предоставляет доступ к открытым публикациям анонимным пользователям, а к закрытым — авторизованным читателям, у которых есть доступ к публикации. Неопубликованные проекты недоступны. |
Показ и скрытие блока Подключиться через MCP
По умолчанию читатели видят блок Подключиться к MCP в меню Копировать страницу на каждой странице документации. В блоке есть адрес эндпоинта и кнопки быстрого подключения для самых распространённых агентов.
Чтобы блок отображался:
- Откройте настройки портала, Читательский интерфейс.
- Убедитесь, что выбран шаблон читательского интерфейса Next.
- В разделе Просмотр страницы установите галочку Показывать параметры «Подключиться к MCP».
| Скрытие блока не отключает сервер: агенты, у которых уже есть адрес эндпоинта, продолжат работать. Чтобы перестать отдавать контент через MCP, снимите галочку в разделе ИИ интеграции → MCP-сервер. |
Об остальных настройках на этой странице читайте в статье Настройки читательского интерфейса.
Проверка работы
Подключите агента так же, как это сделал бы читатель, и убедитесь, что он отвечает по вашему контенту.
- Откройте страницу документации как анонимный посетитель открытой публикации или как авторизованный читатель с доступом к закрытой публикации.
- Нажмите Копировать страницу и в блоке Подключиться к MCP скопируйте адрес MCP-сервера или команду подключения для доступного вам агента.
- Добавьте MCP-сервер в ИИ-агента: укажите адрес эндпоинта или выполните команду в командной строке.
- Задайте агенту вопрос, ответ на который есть только в вашей документации, и сверьте ответ с исходной страницей.
Если агент не может подключиться к серверу, проверьте, что галочка в разделе ИИ интеграции установлена, а у вас есть доступ к публикации, которую вы тестируете.
Что дальше
Сервер включён и доступен, но читателям ещё нужно узнать, что он есть. Об этом — в статье Как рассказать читателям о MCP-сервере опубликованной документации.