Skip to content

v1.6.2 — corrige tools/list rejeitado por clientes estritos (Claude Code)

Choose a tag to compare

@marreiradigital marreiradigital released this 16 Jul 16:40

Instalação: baixe marreira-mcp-builders.zip abaixo e envie em Plugins → Adicionar novo → Enviar plugin. Se você está na 1.6.0+, o próprio painel oferece esta atualização.

Atualize se o seu cliente MCP conecta mas não mostra nenhuma tool.

Correção

Clientes MCP com validação estrita não carregavam nenhuma tool.

As tools sem argumentos declaravam inputSchema.properties como array vazio do PHP, e o json_encode serializa isso como []. O JSON Schema exige que properties seja um objeto ({}), então clientes que validam de verdade — o Claude Code, por exemplo — recusavam o tools/list inteiro, não só a tool problemática.

O sintoma enganava: o servidor conectava normalmente e nenhuma tool ficava disponível.

Status: ! Connected · tools fetch failed
Issue: Invalid input: expected record, received array (at tools.15.inputSchema.properties)

Eram 11 tools nos dois builders, e o /describe sofria do mesmo problema — não só o tools/list.

Documentação

  • Nova seção Problemas comuns no README, com este sintoma e com uma dica para hosts LiteSpeed: o throttle por user-agent pode retornar 429 durante o handshake do Claude Code, antes de a requisição chegar ao plugin. Registrar o MCP com um User-Agent próprio resolve.

Reportado por @HermesMacedo em #1 — com diagnóstico, reprodução e patch. Obrigado.

Changelog completo: CHANGELOG.md