Una cuenta. 300+ herramientas MCP. Directamente en la herramienta de chat.

Error

Un error de herramienta se devuelve como un resultado de la herramienta MCP con isError: true. El mismo objeto JSON está disponible en structuredContent y en el primer bloque de contenido de texto:

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

Código estable y legible por máquinas. Se refleja en code y details.error_code porque algunos clientes pueden reescribir error_code.

message

Explicación para personas.

details

Contexto como http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors o los IDs enviados.

hint

Siguiente paso, formulado para el modelo.

retryablehttp_status

Campos opcionales de nivel superior declarados en los esquemas de salida.

Sin error: Si falta una entrada de archivo, las herramientas basadas en archivos (extracción, PDF) devuelven un resultado de texto normal que comienza con FILE_UPLOAD_REQUIRED y menciona las entradas aceptadas o una página de carga por navegador.

A nivel de transporte, un token faltante, inválido, expirado o revocado recibe HTTP 401 con un encabezado WWW-Authenticate (realice OAuth nuevamente). Mientras el inicio de sesión o el catálogo de herramientas no estén brevemente disponibles, el servidor responde con HTTP 503 y Retry-After (2–5 s).

Límites de tasa y cuotas

• Por sesión MCP (Mcp-Session-Id): máximo 8 llamadas a herramientas simultáneas. Las herramientas con 1 en la última columna se ejecutan secuencialmente: una segunda llamada simultánea devuelve inmediatamente SESSION_BUSY (reintente después de aproximadamente 300 ms, después de po_knowledge_graph_ask después de 500 ms). Las demás herramientas se ejecutan con hasta 4 llamadas paralelas y esperan hasta 15 s por un espacio disponible.
• Por token de acceso en todas las sesiones: como máximo 24 llamadas a herramientas simultáneas (ACCOUNT_BUSY).
• Para cada llamada a la herramienta se aplican los límites de solicitud de PaperOffice API: Los tokens gratuitos y de visitante reciben al menos 5 solicitudes por segundo, 30 por minuto, 100 por hora y 500 por día; los valores del plan pueden ser más altos. Los planes de pago con Credits restante limitan el saldo, no una tasa de solicitud. Las llamadas limitadas por velocidad no se facturan; devuelven TRANSIENT_TRANSPORT_ERROR con details.http_status 429 y el tiempo de espera en el mensaje.
• Límites temporales: Una llamada al backend se cancela después de 90 s (las operaciones de escritura en la base de conocimientos devuelven entonces WRITE_OUTCOME_UNKNOWN o TRANSLATION_IN_PROGRESS, en lugar de repetir ciegamente); po_knowledge_graph_ask se detiene después de 120 s.
• Límites mencionados en las descripciones de las herramientas: hasta 10 archivos por llamada de po_documents_upload_files (solo /chatgpt), 2 o más PDFs por fusión, hasta 500 resultados de búsqueda por página, hasta 200 Workspaces por página y 10–200 entradas de papelera por página. Los enlaces de descarga caducan después de aproximadamente 10 minutos, y una tarea asumida permanece bloqueada durante 15 minutos.
• Facturación: Las llamadas MCP se facturan como llamadas de REST API en Credits. Las herramientas cuya descripción dice "costs credits" o "uses credits" inician un procesamiento de IA y consumen más Credits.