MCP-сервер

MCP-сервер Документерры — это сервис, который позволяет ИИ-агентам и инструментам на базе LLM (таким как Claude, Gemini, ChatGPT и другим) программно взаимодействовать с вашим порталом документации. Он реализует Model Context Protocol (MCP) — открытый стандарт для подключения ИИ-ассистентов к внешним источникам данных и инструментам.

Представьте себе это как уровень API, разработанный специально для ИИ-агентов: вместо того чтобы анализировать HTML или угадывать структуру вашего портала, агент может обращаться напрямую к MCP-серверу для чтения страниц справки, поиска контента и даже внесения изменений.

Как это работает

MCP-сервер выступает в роли моста между ИИ-агентом и вашим порталом Документерры. Когда агенту необходимо получить или обновить контент, он отправляет запросы на MCP-сервер, который связывается с порталом через REST API и возвращает результат агенту.

Типичное взаимодействие выглядит следующим образом:

  1. Администратор настраивает ИИ-агента для использования MCP-сервера.
  2. Пользователь отправляет запрос агенту на естественном языке — никаких специальных команд не требуется.
  3. Агент решает, использовать ли MCP-сервер для выполнения запроса и какие инструменты задействовать.
  4. Если агент обращается к серверу впервые, открывается вкладка браузера со стандартной страницей входа на портал. Пользователь проходит аутентификацию с использованием своих обычных учетных данных — полностью поддерживаются SSO и двухфакторная аутентификация (2FA). API-ключи не требуются.
  5. После входа в систему агент сохраняет токен аутентификации и использует его для последующих запросов. Пользователям необходимо проходить повторную аутентификацию каждые 30 дней.
  6. Агент действует от имени авторизованного пользователя с точным соблюдением его прав доступа.
    Мы рекомендуем создать отдельную учетную запись Автора или Авторизованного читателя для вашего ИИ-агента, чтобы вы могли отслеживать внесенные ИИ изменения и настраивать определенные права доступа. См. раздел Настройка отдельной учетной записи для ИИ.

Эндпоинт (endpoint) MCP-сервера для портала выглядит примерно так: https://ru.mcp.documenterra.com/portals/yourportal.documenterra.net
и может быть найден в настройках портала, ИИ интеграции → MCP-сервер.

Чтобы узнать, чего можно достичь с помощью ИИ-агента и MCP-сервера, читайте статью Варианты использования MCP-сервера.

Настройка отдельной учетной записи для ИИ

Чтобы использовать отдельную учетную запись для ИИ-агента (что рекомендуется для аудита и управления правами доступа), выполните следующие действия:

  1. Создайте отдельную учетную запись Автора или Авторизованного читателя для ИИ-агента.
  2. Выйдите из портала в текущем браузере и войдите снова с использованием отдельной учетной записи ИИ — или откройте отдельный профиль браузера/сессию в режиме Инкогнито и войдите там.
  3. Подключите MCP-сервер к вашему ИИ-инструменту и сделайте первый запрос для получения доступа к порталу Документерры.
  4. После установки соединения агент сохраняет токен для этой учетной записи и использует его в течение следующих 30 дней.
Сессия портала используется только один раз — в момент первоначального подключения. После этого агент работает с сохраненным токеном и не зависит от того, какая учетная запись в данный момент авторизована на портале в вашем браузере.

Безопасность

Доступ через MCP-сервер регулируется той же системой прав доступа, что и прямой доступ к порталу. Агент может выполнять только те действия, которые разрешены авторизованному пользователю. Это означает, что вы можете создать отдельную учетную запись на портале с ограниченными правами доступа для автоматизированных рабочих процессов, ограничив то, что агент может читать или изменять

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

Доступные инструменты

MCP-сервер предоставляет две категории инструментов.

Инструменты только для чтения позволяют агентам:

  • Просматривать список проектов, публикаций и проектов перевода на портале.
  • Просматривать список страниц в рамках проекта или публикации, включая страницы API-документации.
  • Получать контент страниц.
  • Получать структуру Дерева страниц.
  • Осуществлять поиск контента по порталу.
  • Выполнять запросы к ИИ Помощнику.
  • Получать статусы страниц и доступные переходы в рамках рабочего процесса.

Инструменты для записи позволяют агентам:

  • Создавать проекты.
  • Создавать и редактировать страницы, включая поля рабочего процесса (статус, исполнитель, владелец).
  • Изменять структуру Дерева страниц.

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

Несмотря на то, что встроенный функционал импорта недоступен через MCP-сервер, вы можете попросить агента обработать контент в любом формате, который он может распознать — включая файлы PDF, Excel или PowerPoint, — и создавать страницы из этого контента напрямую.

Страницы в проектах API-документации нельзя создавать или редактировать; в проектах перевода можно изменять только поля рабочего процесса.

Лицензирование

MCP-сервер — часть аддона REST API и расходует ИИ токены. Расход токенов MCP-сервера отображается на странице подписки.