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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ограничения скорости

Авторский MCP-сервер Документерры имеет следующие ограничения скорости (количества запросов):

Ограничение	Значение	Описание
Количество запросов MCP инстументов для портала в день	20 000	Количество запросов MCP инструментов от всех пользователей портала в сутки
Количество запросов MCP инстументов для портала в минуту	180	Количество запросов MCP инструментов от всех пользователей портала в минуту
Количество запросов MCP инструментов с одного IP адреса в минуту	60	Количество запросов MCP инструментов от одного пользователя портала (с одного IP адреса) в минуту
Количество запросов на чтение в секунду	10	Количество запросов MCP инструментов для чтения в секунду
Количество запросов на запись в секунду	10	Количество запросов MCP инструментов для записи в секунду
Количество одновременных долгих операций	3	Долгие операции: действия с проектами и публикациям. На данный момент это может быть только действие создания проекта.

Заметки:

Запрос MCP инструмента - один успешно выполненный запрос от инструмента для чтения или инструмента для записи (например, поиск страницы или создание страницы).
Лимиты на количество запросов MCP инструментов для чтения и инструментов для записи считаются отдельно.

Если лимит исчерпан

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

Если вы всё же столкнулись с ситуацией исчерпания лимита количества запросов, попробуйте следующее:

Подождите около минуты, затем повторите запрос. Ограничения сбрасываются каждую минуту, поэтому короткой паузы будет достаточно.
Проверьте, не работают ли ваши коллеги с Авторским MCP сервером одновременно с вами. Некоторые ограничения применяются ко всему порталу, а не только к вашим запросам. Если несколько человек одновременно активно используют ИИ-агентов на одном портале, их совместная активносить может исчерпать лимиты по порталу.

Если вам регулярно требуется большая нагрузка, вы можете увеличить лимиты покупкой аддона REST API + MCP: Высокая нагрузка. Подробнее смотрите в тарифах.