Arquitetura de ferramentas
MCP, CLI e API são interfaces; nenhuma vence em todos os cenários
A pergunta correta não é qual tecnologia é “mais moderna”. É onde a ferramenta será executada, quem precisa descobri-la, como seus dados são validados e qual custo operacional você aceita.
Alejandro Sánchez9 min de leitura
CLI: simples de transportar e observar
Uma CLI é natural para terminais, scripts e CI. Ela pode trabalhar diretamente com o filesystem local e ser depurada com ferramentas universais. O custo aparece quando cada consumidor precisa entender saída humana inconsistente.
qzx diagnoseProject . --jsonAPI: uma fronteira de rede explícita
APIs são excelentes quando a capacidade já vive como serviço, precisa de autenticação centralizada ou deve ser consumida por muitos clientes remotos. Em troca, adicionam disponibilidade, rede, credenciais e operação de servidor.
MCP: descoberta e contrato para clientes de IA
MCP oferece uma linguagem comum para expor ferramentas e recursos a clientes compatíveis. Ele é particularmente interessante quando o agente precisa descobrir capacidades e schemas sem integração específica para cada servidor.
Não duplique a lógica
Se a mesma operação precisa estar disponível por CLI e MCP, mantenha o núcleo independente do transporte. Assim testes e semântica podem ser compartilhados enquanto cada adaptador resolve sua própria ergonomia.
Perguntas frequentes
Qual interface é mais simples?
Depende do ambiente. Uma CLI pode ser imediata em um terminal; uma API é natural entre serviços; MCP facilita descoberta e ferramentas estruturadas em clientes compatíveis.
Posso combinar as três?
Sim. Uma arquitetura saudável pode manter uma operação canônica e expô-la por diferentes adaptadores sem duplicar a lógica de negócio.
Por que resultados estruturados importam?
Porque reduzem ambiguidades na interpretação de sucesso, erros, dados e próximos passos para software e agentes.