Ein Konto. 300+ MCP-Tools. Direkt im Chat-Tool.

Fehler

Ein Tool-Fehler kommt als MCP-Tool-Ergebnis mit isError: true zurück. Dasselbe JSON-Objekt steht in structuredContent und im ersten Text-Content-Block:

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

Stabiler, maschinenlesbarer Code. Er wird in code und details.error_code gespiegelt, weil manche Clients error_code umschreiben.

message

Erklärung für Menschen.

details

Kontext wie http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors oder die gesendeten IDs.

hint

Nächster Schritt, formuliert für das Modell.

retryablehttp_status

Optionale Felder auf oberster Ebene, die in den Ausgabeschemata deklariert sind.

Kein Fehler: Fehlt eine Datei-Eingabe, geben die dateibasierten Tools (Extraktion, PDF) ein normales Text-Ergebnis zurück, das mit FILE_UPLOAD_REQUIRED beginnt und die akzeptierten Eingaben oder eine Browser-Upload-Seite nennt.

Auf Transportebene erhält ein fehlendes, ungültiges, abgelaufenes oder widerrufenes Token HTTP 401 mit einem WWW-Authenticate-Header (OAuth erneut durchführen). Solange die Anmeldung oder der Tool-Katalog kurz nicht verfügbar ist, antwortet der Server mit HTTP 503 und Retry-After (2–5 s).

Rate Limits und Kontingente

• Je MCP-Sitzung (Mcp-Session-Id): höchstens 8 Tool-Aufrufe gleichzeitig. Tools mit 1 in der letzten Spalte laufen nacheinander: Ein zweiter gleichzeitiger Aufruf liefert sofort SESSION_BUSY (erneut nach etwa 300 ms, bei po_knowledge_graph_ask nach 500 ms). Die übrigen Tools laufen mit bis zu 4 parallelen Aufrufen und warten bis zu 15 s auf einen freien Platz.
• Je Zugriffstoken über alle Sitzungen: höchstens 24 Tool-Aufrufe gleichzeitig (ACCOUNT_BUSY).
• Für jeden Tool-Aufruf gelten die Anfragegrenzen der PaperOffice API: Kostenlose und Besucher-Tokens erhalten mindestens 5 Anfragen pro Sekunde, 30 pro Minute, 100 pro Stunde und 500 pro Tag; Planwerte können höher liegen. Bezahlte Pläne mit verbleibenden Credits begrenzt das Guthaben, nicht eine Anfragerate. Ratenbegrenzte Aufrufe werden nicht berechnet; sie liefern TRANSIENT_TRANSPORT_ERROR mit details.http_status 429 und der Wartezeit in der Meldung.
• Zeitgrenzen: Ein Backend-Aufruf wird nach 90 s abgebrochen (Schreibvorgänge in der Wissensdatenbank liefern dann WRITE_OUTCOME_UNKNOWN oder TRANSLATION_IN_PROGRESS, statt blind zu wiederholen); po_knowledge_graph_ask stoppt nach 120 s.
• In den Tool-Beschreibungen genannte Grenzen: bis zu 10 Dateien je Aufruf von po_documents_upload_files (nur /chatgpt), 2 oder mehr PDFs je Zusammenführung, bis zu 500 Suchtreffer je Seite, bis zu 200 Workspaces je Seite und 10–200 Papierkorb-Einträge je Seite. Download-Links laufen nach etwa 10 Minuten ab, und eine übernommene Aufgabe bleibt 15 Minuten gesperrt.
• Abrechnung: MCP-Aufrufe werden wie Aufrufe der REST API in Credits abgerechnet. Tools, deren Beschreibung „costs credits“ oder „uses credits“ sagt, starten eine KI-Verarbeitung und verbrauchen mehr Credits.