В этой статье вы узнаете о доступных инструментах Авторского MCP-сервера и ограничениях скорости запросов.
Доступные инструменты
Авторский 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: Высокая нагрузка. Подробнее смотрите в тарифах.