В этой статье вы узнаете о доступных ИИ-агентам инструментах MCP-сервера опубликованной документации и об ограничениях скорости запросов.
Доступные инструменты
MCP-сервер опубликованной документации предоставляет только инструменты для чтения, которые позволяют агентам:
- Просматривать список открытых и закрытых публикаций на портале.
- Просматривать список страниц в рамках публикации, включая страницы API-документации.
- Получать контент страниц.
- Получать структуру Дерева страниц.
- Осуществлять поиск контента по порталу.
- Выполнять запросы к ИИ Помощнику.
Инструменты для записи недоступны. Агенты не могут создавать и редактировать страницы, создавать проекты, изменять Дерево страниц, менять поля рабочего процесса и настройки портала. Проекты и приватные публикации агенту недоступны. Закрытые публикации доступны авторизованным читателям, у которых есть к ним доступ.
Ограничения скорости
Для запросов инструментов MCP-сервера опубликованной документации действуют следующие ограничения:
|
Ограничение
|
Значение
|
Описание
|
|---|---|---|
|
Количество запросов MCP инструментов для портала в день
|
20 000
|
Количество запросов MCP инструментов от всех пользователей портала в сутки.
|
|
Количество запросов MCP инструментов для портала в минуту
|
180
|
Количество запросов MCP инструментов от всех пользователей портала в минуту.
|
|
Количество запросов MCP инструментов с одного IP адреса в минуту
|
60 |
Количество запросов MCP инструментов от одного пользователя (с одного IP адреса) в минуту.
|
|
Количество запросов на чтение в секунду
|
10 |
Запросы, при которых MCP инструмент только для чтения считывает информацию. |
Примечание:
- Запрос MCP инструмента — один успешно выполненный запрос инструмента для чтения (например, поиск страницы).
Если лимит исчерпан
Когда лимит исчерпан, ИИ-агент читателя получает сообщение о том, что запросов слишком много и следующую попытку нужно отложить. Большинство агентов справляются с этим самостоятельно: делают небольшую паузу и автоматически повторяют запрос, так что читатели редко что-то замечают.
Сами вы ошибку не увидите: лимит исчерпывает агент читателя, а не ваш портал. Признак, на который стоит обратить внимание, — жалобы читателей на то, что агент стал отвечать медленно или перестал отвечать вовсе.
Минутные ограничения сбрасываются каждую минуту, поэтому короткие всплески нагрузки проходят сами. При этом суточный и минутный лимиты портала общие для всех, кто работает с вашей документацией, — так что один читатель, активно нагружающий агента, может помешать остальным.
Если ваш портал регулярно упирается в эти лимиты, увеличить их можно с помощью аддона REST API + MCP: Высокая нагрузка. Подробнее смотрите в тарифах.