Uma conta. Mais de 300 ferramentas MCP. Diretamente na ferramenta de chat.

Erro

Um erro de ferramenta retorna como resultado da ferramenta MCP com isError: true. O mesmo objeto JSON está disponível em structuredContent e no primeiro bloco de conteúdo 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 estável e legível por máquina. É refletido em code e details.error_code, pois alguns clientes reescrevem error_code.

message

Explicação para humanos.

details

Contexto como http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors ou os IDs enviados.

hint

Próximo passo, formulado para o modelo.

retryablehttp_status

Campos opcionais de nível superior declarados nos esquemas de saída.

Sem erro: Se faltar uma entrada de arquivo, as ferramentas baseadas em arquivos (extração, PDF) retornam um resultado de texto normal que começa com FILE_UPLOAD_REQUIRED e lista as entradas aceitas ou uma página de upload via navegador.

No nível de transporte, um token ausente, inválido, expirado ou revogado recebe HTTP 401 com um cabeçalho WWW-Authenticate (realizar OAuth novamente). Enquanto o login ou o catálogo da ferramenta estiverem brevemente indisponíveis, o servidor responde com HTTP 503 e Retry-After (2–5 s).

Limites de taxa e cotas

• Por sessão MCP (Mcp-Session-Id): no máximo 8 chamadas de ferramenta simultâneas. Ferramentas com 1 na última coluna executam-se sequencialmente: um segundo chamado simultâneo retorna imediatamente SESSION_BUSY (tentar novamente após cerca de 300 ms, para po_knowledge_graph_ask após 500 ms). As demais ferramentas executam-se com até 4 chamadas paralelas e aguardam até 15 s por uma vaga disponível.
• Acesso ao token em todas as sessões: no máximo 24 chamadas de ferramenta simultâneas (ACCOUNT_BUSY).
• Para cada chamada de ferramenta, aplicam-se os limites de solicitação da PaperOffice API: Tokens gratuitos e de visitante recebem pelo menos 5 solicitações por segundo, 30 por minuto, 100 por hora e 500 por dia; os valores do plano podem ser superiores. Planos pagos com saldo restante Credits limitam o crédito, não uma taxa de solicitação. Chamadas sujeitas a limitação de taxa não são cobradas; elas retornam TRANSIENT_TRANSPORT_ERROR com details.http_status 429 e o tempo de espera na mensagem.
• Limites de tempo: Uma chamada ao backend é interrompida após 90 s (operações de gravação na base de conhecimento retornam então WRITE_OUTCOME_UNKNOWN ou TRANSLATION_IN_PROGRESS, em vez de repetir cegamente); po_knowledge_graph_ask para após 120 s.
• Limites mencionados nas descrições das ferramentas: até 10 arquivos por chamada de po_documents_upload_files (apenas /chatgpt), 2 ou mais PDFs por fusão, até 500 resultados de pesquisa por página, até 200 Workspaces por página e 10–200 entradas da lixeira por página. Os links de download expiram após aproximadamente 10 minutos, e uma tarefa assumida permanece bloqueada por 15 minutos.
• Faturamento: Chamadas MCP são faturadas como chamadas da REST API em Credits. Ferramentas cuja descrição diz "custa créditos" ou "usa créditos" iniciam um processamento de IA e consomem mais Credits.