Один аккаунт. 300+ MCP инструментов. Прямо в чат-инструменте.

Ошибка

Ошибка инструмента возвращается как результат инструмента MCP с isError: true. Тот же объект JSON доступен в structuredContent и в первом текстовом блоке контента:

{
  "error_code": "WORKSPACE_ACCESS_DENIED",
  "code": "WORKSPACE_ACCESS_DENIED",
  "message": "This connection has no access to this workspace.",
  "details": {
    "error_code": "WORKSPACE_ACCESS_DENIED",
    "workspace_id": 12345
  },
  "hint": "Use po_workspaces_list to see the workspaces this connection can access. Retrying will not change the result."
}

error_code

Стабильный, машиночитаемый код. Он дублируется в полях code и details.error_code, поскольку некоторые клиенты могут переименовывать поле error_code.

message

Объяснение для человека.

details

Контекстная информация, такая как http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors или отправленные идентификаторы.

hint

Следующий шаг, сформулированный для модели.

retryablehttp_status

Необязательные поля верхнего уровня, объявленные в выходных схемах.

Не ошибка: если отсутствует входной файл, инструменты, работающие с файлами (извлечение, PDF), возвращают обычный текстовый результат, начинающийся с FILE_UPLOAD_REQUIRED и указывающий принимаемые входные данные или страницу загрузки через браузер.

На транспортном уровне при отсутствии, недействительности, истечении срока действия или отзыве токена возвращается HTTP 401 с заголовком WWW-Authenticate (повторное выполнение OAuth). Пока авторизация или каталог инструментов временно недоступны, сервер отвечает HTTP 503 с Retry-After (2–5 с).

Лимиты частоты запросов и квоты

• На одну MCP-сессию (Mcp-Session-Id): не более 8 одновременных вызовов инструментов. Инструменты со значением 1 в последнем столбце выполняются последовательно: второй одновременный вызов немедленно возвращает SESSION_BUSY (повторить через ~300 мс, для po_knowledge_graph_ask — через 500 мс). Остальные инструменты выполняются с до 4 параллельных вызовов и ждут освобождения места до 15 с.
• На один токен доступа во всех сессиях: не более 24 вызовов инструментов одновременно (ACCOUNT_BUSY).
• Для каждого вызова инструмента действуют лимиты запросов PaperOffice API: бесплатные токены и токены для посетителей получают не менее 5 запросов в секунду, 30 в минуту, 100 в час и 500 в день; значения по тарифным планам могут быть выше. Платные планы с оставшимися Credits ограничивают баланс, а не частоту запросов. Вызовы, превышающие лимит скорости, не оплачиваются; они возвращают ошибку TRANSIENT_TRANSPORT_ERROR с details.http_status 429 и временем ожидания в сообщении.
• Временные ограничения: вызов бэкенда прерывается через 90 секунд (операции записи в базу знаний возвращают WRITE_OUTCOME_UNKNOWN или TRANSLATION_IN_PROGRESS вместо слепого повторения); po_knowledge_graph_ask останавливается через 120 секунд.
• Лимиты, указанные в описаниях инструментов: до 10 файлов за один вызов po_documents_upload_files (только /chatgpt), 2 или более PDF-файлов при объединении, до 500 результатов поиска на странице, до 200 Workspaces на странице и от 10 до 200 записей в корзине на страницу. Ссылки для скачивания истекают примерно через 10 минут, а принятая задача блокируется на 15 минут.
• Биллинг: вызовы MCP тарифицируются как вызовы REST API в Credits. Инструменты, в описании которых указано «costs credits» или «uses credits», запускают обработку ИИ и потребляют больше Credits.