Loading ToolBench
Conector Sienge para Claude: servidor MCP que põe o ERP Sienge dentro do Claude Code e do Claude Desktop — compras, contratos de suprimentos e medições. Não oficial.
31 tools with significant structural gaps. All tools have descriptions (good), but naming violates verb-first convention (buscarX, carregar_X are Portuguese infinitives, not action verbs in English). Input schemas present but sparse: most parameters lack type definitions (e.g., buscarPlanilhas has buildingId, limit, offset with no 'type' field visible in schema). No output schemas documented. Error handling absent, tools return raw JSON with no recovery guidance. Parameters lack enums for constrained values (status, authorization fields). No pagination metadata (total count, next_cursor). Tool composition is poor: 4 module-loader tools (carregar_compras, carregar_financeiro, etc.) add cognitive overhead and violate single-responsibility principle.
GET .../items/{itemNumber}/buildings-appropriations — apropriações de obra do item.
GET .../items/{n}/buildings-appropriations — apropriações de obra do item.
GET /cost-centers/{costCenterId} — dados de um centro de custo.
GET /cost-centers — lista os centros de custo, em ordem de código.
GET /creditors/{creditorId}/pix-informations — chaves Pix cadastradas do credor.
GET /cost-centers/immediate-register-settings — parâmetros de cadastro imediato.
GET /creditors/{creditorId} — dados completos de um credor.
Tool names violate verb-first convention. All 27 query tools use Portuguese infinitives (buscarX, verificarX) instead of English action verbs (get_, list_, search_). LLMs rely on verb-first naming to infer intent before reading descriptions.
Input schemas lack type definitions. Parameters like buildingId, limit, offset are listed but have no 'type' field visible (e.g., buscarPlanilhas schema shows properties but no type:string). This violates JSON Schema and prevents LLM validation.
No output schemas documented. Tools return raw API responses with no declared structure. LLMs cannot plan downstream calls or extract required fields (e.g., does buscarPedidos return purchase_order_id or purchaseOrderId?).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | 2026-07-28+ | v2 |
GET /creditors — lista credores com filtros opcionais por nome, CPF ou CNPJ.
GET /creditors/{creditorId}/bank-informations — contas bancárias do credor.
GET .../items/{n}/delivery-requirements — necessidades de entrega do item.
GET /purchase-orders/{purchaseOrderId}/direct-billing — faturamento direto simples.
GET /building-cost-estimations/{buildingId}/resources — insumos do orçamento. Escopo é a obra: devolve o que aquele orçamento prevê.
GET /purchase-orders/{purchaseOrderId}/items/{itemNumber} — item específico.
GET /purchase-orders/{purchaseOrderId}/items — itens do pedido.
GET /building-cost-estimations/{buildingId}/sheets/{buildingUnitId}/items — itens da planilha orçamentária de uma unidade construtiva.
GET /purchase-requests/all/items — consulta itens de solicitações com filtros. Este é o ÚNICO endpoint de busca ampla da API.
GET /supply-contracts/measurements — consulta UMA medição.
GET /supply-contracts/measurements/all — lista medições com filtros. Uma chamada sem filtro nenhum varre todas as medições do tenant.
GET /purchase-orders/{purchaseOrderId} — consulta um pedido específico.
GET /purchase-orders — consulta pedidos de compra com filtros combináveis.
GET /building-cost-estimations/{buildingId}/sheets — planilhas do orçamento. Uma planilha por unidade construtiva.
GET .../items/{itemNumber}/delivery-schedules — previsões de entrega do item.
GET /purchase-requests/{purchaseRequestId} — consulta uma solicitação.
GET .../items/{itemNumber}/purchase-requests — solicitações atendidas pelo item.
GET /purchase-orders/{purchaseOrderId}/totalization — totalização do pedido.
Carrega as ferramentas de compras: cotações, pedidos de compra, fornecedores.
Carrega as ferramentas de contratos: contratos de suprimentos, medições e suas aprovações
Carrega as ferramentas de financeiro: contas a pagar e a receber, boletos, fluxo de caixa
Libera do contexto as ferramentas dos módulos carregados.
Confere a empresa de um pedido antes de usá-lo numa nota fiscal. Devolve a empresa e a obra do pedido e, quando companyId é informado, diz se os dois combinam.
GET /cost-centers/{costCenterId}/available — se o centro de custo está disponível.
Module loader tools (carregar_compras, carregar_financeiro, descarregar_modulos) violate single-responsibility principle. They add cognitive overhead and force agents to manage tool lifecycle instead of focusing on domain tasks. Consider pre-loading all tools or exposing them via resources.
Constrained parameters lack enums. Fields like status (PENDING, PARTIALLY_DELIVERED, etc.), authorization (T, S, A, N), and consistency (T, S, N, I) are documented as free-form strings. LLMs hallucinate invalid values without enum constraints.