Една сметка. 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 s).

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

• За всяка MCP сесия (Mcp-Session-Id): най-много 8 едновременни извиквания на инструменти. Инструментите със стойност 1 в последната колона се изпълняват последователно: второ едновременно извикване веднага връща SESSION_BUSY (опитайте отново след около 300 ms, при po_knowledge_graph_ask след 500 ms). Останалите инструменти се изпълняват с до 4 паралелни извиквания и чакат до 15 s за свободно място.
• Достъп до токен за всички сесии: най-много 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.