Авторский MCP-сервер

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

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


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

Авторский MCP-сервер — часть аддона REST API + MCP.

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

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

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

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

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

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

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

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