Ir para o conteúdo principal

Guia MCP

Model Context Protocol sem misticismo: uma camada de integração, não uma religião

MCP facilita a descoberta e chamada de ferramentas por clientes compatíveis. Isso é valioso, mas não elimina CLIs, APIs ou bibliotecas. A escolha correta depende do ambiente em que a operação precisa viver.

Alejandro Sánchez8 min de leitura

Diagrama conceitual mostrando um agente de IA conectado a ferramentas por MCP e por CLI

O que o MCP resolve

Um cliente MCP pode descobrir ferramentas, conhecer seus schemas e receber conteúdo estruturado por um protocolo comum. Isso reduz integrações ad hoc quando várias ferramentas precisam conversar com vários clientes.

  • Descoberta de ferramentas e recursos.
  • Schemas de entrada e, em versões recentes do protocolo, suporte a saída estruturada.
  • Um canal comum entre clientes e servidores compatíveis.

Por que uma CLI ainda importa

Uma CLI funciona em terminais, scripts, CI, shells remotos e ambientes onde nenhum cliente MCP está presente. Também é fácil de inspecionar: comando, argumentos, código de saída e stdout ficam visíveis.

qzx diagnoseProject . --json

MCP e CLI podem compartilhar o mesmo contrato

A arquitetura mais saudável costuma separar a operação de sua forma de transporte. Uma implementação pode expor o mesmo resultado por CLI e por MCP sem duplicar a lógica central. O QZX Result Contract v1 explora exatamente esse tipo de interoperabilidade verificável.

Como decidir

  • Prefira MCP quando descoberta e integração com clientes compatíveis são centrais.
  • Prefira CLI quando portabilidade de terminal e automação local são mais importantes.
  • Use API quando a fronteira natural é um serviço de rede.
  • Não adicione uma camada apenas porque está na moda.

Perguntas frequentes

O MCP substitui uma CLI?

Não. MCP e CLI resolvem camadas diferentes. MCP oferece descoberta e chamadas estruturadas; uma CLI continua excelente para automação local, scripts, terminais e ambientes onde um servidor MCP não está disponível.

QZX é um servidor MCP?

QZX é principalmente uma CLI multiplataforma. Seu Result Contract também foi desenhado para facilitar interoperabilidade com consumidores estruturados, inclusive fluxos MCP.

Quando devo preferir MCP?

Quando o cliente precisa descobrir ferramentas, schemas e resultados estruturados por um protocolo comum. Para tarefas locais simples e portáveis, uma CLI pode ser a solução mais direta.