Jedno konto. Ponad 300 MCP narzędzi. Bezpośrednio w narzędziu czatu.

Błąd

Błąd narzędzia zwracany jest jako wynik narzędzia MCP z isError: true. Ten sam obiekt JSON znajduje się w structuredContent oraz w pierwszym bloku treści tekstowej:

{
  "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

Stabilny, maszynowo czytelny kod. Jest on powielany w polach code i details.error_code, ponieważ niektóre klienty mogą przekształcać pole error_code.

message

Wyjaśnienie przeznaczone dla człowieka.

details

Kontekst taki jak http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors lub wysłane identyfikatory.

hint

Następny krok, sformułowany dla modelu.

retryablehttp_status

Opcjonalne pola najwyższego poziomu zadeklarowane w schemacie wyjściowym.

Brak błędu: Jeśli brakuje wejścia pliku, narzędzia oparte na plikach (ekstrakcja, PDF) zwracają zwykły wynik tekstowy zaczynający się od FILE_UPLOAD_REQUIRED, wskazujący akceptowane wejścia lub stronę przesyłania przez przeglądarkę.

Na poziomie transportu brakujący, nieważny, wygasły lub cofnięty token zwraca HTTP 401 z nagłówkiem WWW-Authenticate (ponowne przeprowadzenie OAuth). Dopóki logowanie lub katalog narzędzi są chwilowo niedostępne, serwer odpowiada HTTP 503 z Retry-After (2–5 s).

Limity częstotliwości i kwoty

• W ramach jednej sesji MCP (Mcp-Session-Id): maksymalnie 8 równoczesnych wywołań narzędzia. Narzędzia z wartością 1 w ostatniej kolumnie działają sekwencyjnie: drugie równoczesne wywołanie natychmiast zwraca SESSION_BUSY (ponowienie po około 300 ms, przy po_knowledge_graph_ask po 500 ms). Pozostałe narzędzia działają z do 4 równoległych wywołań i oczekują do 15 s na wolne miejsce.
• Je dostęp do tokena: maksymalnie 24 wywołań narzędzi jednocześnie (ACCOUNT_BUSY).
• Dla każdego wywołania narzędzia obowiązują limity zapytań określone w dokumencie PaperOffice API: darmowe tokeny i tokeny dla gości otrzymują co najmniej 5 zapytań na sekundę, 30 na minutę, 100 na godzinę i 500 na dzień; wartości planów mogą być wyższe. Płatne plany z pozostałym saldem Credits ograniczają saldo, a nie częstotliwość zapytań. Wywołania objęte limitami nie są rozliczane; zwracają one TRANSIENT_TRANSPORT_ERROR ze statusem HTTP 429 oraz czasem oczekiwania w wiadomości.
• Limity czasowe: wywołanie backendu jest przerywane po 90 sekundach (operacje zapisu w bazie wiedzy zwracają wtedy WRITE_OUTCOME_UNKNOWN lub TRANSLATION_IN_PROGRESS, zamiast ślepego ponawiania); po_knowledge_graph_ask zatrzymuje się po 120 sekundach.
• Limity wymienione w opisach narzędzi: do 10 plików na wywołanie po_documents_upload_files (tylko /chatgpt), 2 lub więcej plików PDF na połączenie, do 500 wyników wyszukiwania na stronę, do 200 Workspaces na stronę oraz od 10 do 200 wpisów w koszu na stronę. Linki do pobrania wygasają po około 10 minutach, a przejęte zadanie pozostaje zablokowane przez 15 minut.
• Rozliczenia: wywołania MCP są rozliczane jak wywołania REST API w Credits. Narzędzia, których opis informuje o „kosztach kredytów” lub „używaniu kredytów”, uruchamiają przetwarzanie AI i zużywają więcej Credits.