Un account. Oltre 300 MCP strumenti. Direttamente nello strumento di chat.

Errore

Un errore dello strumento viene restituito come risultato dello strumento MCP con isError: true. Lo stesso oggetto JSON è disponibile in structuredContent e nel primo blocco di contenuto testuale:

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

Codice stabile e leggibile dalla macchina. Viene riflesso in code e details.error_code poiché alcuni client potrebbero riscrivere error_code.

message

Spiegazione destinata agli esseri umani.

details

Contesto come http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors o gli ID inviati.

hint

Passaggio successivo, formulato per il modello.

retryablehttp_status

Campi facoltativi di livello superiore dichiarati negli schemi di output.

Nessun errore: se manca un input file, gli strumenti basati su file (estrazione, PDF) restituiscono un normale risultato di testo che inizia con FILE_UPLOAD_REQUIRED e indica gli input accettati o una pagina di caricamento browser.

A livello di trasporto, un token mancante, non valido, scaduto o revocato riceve HTTP 401 con un header WWW-Authenticate (effettuare nuovamente l'OAuth). Finché l'accesso o il catalogo degli strumenti non sono temporaneamente disponibili, il server risponde con HTTP 503 e Retry-After (2–5 s).

Limiti di frequenza e quote

• Per ogni sessione MCP (Mcp-Session-Id): al massimo 8 chiamate agli strumenti contemporaneamente. Gli strumenti con '1' nell'ultima colonna vengono eseguiti in sequenza: una seconda chiamata simultanea restituisce immediatamente SESSION_BUSY (riprovare dopo circa 300 ms, per po_knowledge_graph_ask dopo 500 ms). Gli altri strumenti vengono eseguiti con fino a 4 chiamate parallele e attendono fino a 15 s per una posizione disponibile.
• Accesso al token di chiamata per tutte le sessioni: al massimo 24 chiamate a tool simultanee (ACCOUNT_BUSY).
• Per ogni chiamata a tool valgono i limiti di richiesta della PaperOffice API: I token gratuiti e per visitatori ricevono almeno 5 richieste al secondo, 30 al minuto, 100 all'ora e 500 al giorno; i valori del piano possono essere superiori. I piani a pagamento con un saldo residuo di Credits limitano il credito, non la frequenza delle richieste. Le chiamate soggette a rate limiting non vengono addebitate; restituiscono TRANSIENT_TRANSPORT_ERROR con details.http_status 429 e il tempo di attesa nel messaggio.
• Limiti temporali: Una chiamata al backend viene interrotta dopo 90 s (le scritture nel database delle conoscenze restituiscono allora WRITE_OUTCOME_UNKNOWN o TRANSLATION_IN_PROGRESS, invece di ripetere ciecamente); po_knowledge_graph_ask si interrompe dopo 120 s.
• Limiti menzionati nelle descrizioni dei tool: fino a 10 file per chiamata di po_documents_upload_files (solo /chatgpt), 2 o più PDF per ogni fusione, fino a 500 risultati di ricerca per pagina, fino a 200 Workspaces per pagina e da 10 a 200 voci del cestino per pagina. I link di download scadono dopo circa 10 minuti e un'attività assunta rimane bloccata per 15 minuti.
• Fatturazione: Le chiamate MCP vengono fatturate come chiamate della REST API in Credits. I tool la cui descrizione indica "costa crediti" o "utilizza crediti" avviano un'elaborazione AI e consumano più Credits.