Un compte. 300+ outils MCP. Directement dans l'outil de chat.

Erreur

Une erreur d'outil est renvoyée en tant que résultat de l'outil MCP avec isError : true. Le même objet JSON se trouve dans structuredContent et dans le premier bloc de contenu texte :

{
  "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 stable et lisible par une machine. Il est dupliqué dans code et details.error_code, car certains clients peuvent réécrire error_code.

message

Explication destinée aux humains.

details

Contexte tel que http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors ou les IDs envoyés.

hint

Étape suivante, formulée pour le modèle.

retryablehttp_status

Champs optionnels de niveau supérieur déclarés dans les schémas de sortie.

Pas une erreur : si une entrée de fichier manque, les outils basés sur des fichiers (extraction, PDF) retournent un résultat texte normal commençant par FILE_UPLOAD_REQUIRED et indiquant les entrées acceptées ou une page de téléchargement par navigateur.

Au niveau du transport, un jeton manquant, invalide, expiré ou révoqué reçoit un HTTP 401 avec un en-tête WWW-Authenticate (réexécutez OAuth). Tant que la connexion ou le catalogue d'outils est brièvement indisponible, le serveur répond avec un HTTP 503 et Retry-After (2–5 s).

Limites de débit et quotas

• Par session MCP (Mcp-Session-Id): au maximum 8 appels d'outil simultanés. Les outils avec '1' dans la dernière colonne s'exécutent séquentiellement: un deuxième appel simultané renvoie immédiatement SESSION_BUSY (réessayez après environ 300 ms, après 500 ms pour po_knowledge_graph_ask). Les autres outils s'exécutent avec jusqu'à 4 appels parallèles et attendent jusqu'à 15 s qu'une place se libère.
• Jet d'accès token sur toutes les sessions : au maximum 24 appels d'outils simultanés (ACCOUNT_BUSY).
• Pour chaque appel d'outil, les limites de requête de PaperOffice API s'appliquent : les tokens gratuits et visiteurs reçoivent au moins 5 requêtes par seconde, 30 par minute, 100 par heure et 500 par jour; les valeurs des plans peuvent être plus élevées. Les plans payants avec Credits restant limitent le crédit, pas un taux de requête. Les appels soumis à une limitation de débit ne sont pas facturés; ils retournent TRANSIENT_TRANSPORT_ERROR avec details.http_status 429 et le temps d'attente dans le message.
• Limites temporelles : un appel backend est interrompu après 90 s (les écritures dans la base de connaissances fournissent alors WRITE_OUTCOME_UNKNOWN ou TRANSLATION_IN_PROGRESS, au lieu de répéter aveuglément) ; po_knowledge_graph_ask s'arrête après 120 s.
• Limites mentionnées dans les descriptions des outils : jusqu'à 10 fichiers par appel de po_documents_upload_files (uniquement /chatgpt), 2 ou plus de PDFs par fusion, jusqu'à 500 résultats de recherche par page, jusqu'à 200 Workspaces par page et 10–200 entrées de corbeille par page. Les liens de téléchargement expirent après environ 10 minutes, et une tâche reprise reste verrouillée pendant 15 minutes.
• Facturation : les appels MCP sont facturés comme les appels de REST API dans Credits. Les outils dont la description indique « costs credits » ou « uses credits » lancent un traitement IA et consomment plus de Credits.