Construindo Aplicações Controladas por Agents de IA — Implementando MCP

Destaques

• MCP explicado como um "USB" entre agente e aplicação: um contrato descritivo (nome, descrição, esquema de entrada e saída) em vez de tela, protocolo criado pela Anthropic e hoje suportado por Claude, ChatGPT, Cursor, Gemini e Claude Code, com transporte via HTTP streamable (SSE já depreciado).
• Três blocos do protocolo demonstrados: tools (ações executáveis, como criar post), resources (dados de leitura estática, como documentação de onboarding) e prompts (empacotados e entregues ao agente conforme a necessidade).
• Implementação real no blog do Beer and Code com o pacote oficial Laravel MCP: instalação simples, rota /ai/mcp/blog como rota Laravel padrão (com autenticação, middlewares etc.), e uma única classe BlogServer definindo instruções de handshake e as tools.
• Doze tools expostas no servidor do blog: listar categorias, tags e autores, listar e buscar posts, upload de imagem, criar categoria, criar tag, criar post, atualizar post, publicar post e enriquecer post (SEO).
• Autenticação via Sanctum com bearer token vinculado ao usuário que o gerou (rastreabilidade de quem agiu); ChatGPT como cliente exige fluxo OAuth via Passport, diferente de Claude Code e Claude Desktop, que aceitam bearer token direto.
• Demonstração ao vivo: geração de token, conexão do Claude Code e do Claude Desktop ao blog, listagem de categorias em linguagem natural, criação de um post de teste e revogação do token com falha 403 subsequente.
• Workflow pessoal de produção de conteúdo: 21 temas semanais processados em um loop (estilo ralph loop) escrito em Python, usando uma skill do Claude Code com fontes de referência, tom de voz e template de post; geração de imagem via Gemini e upload para bucket Oracle através da própria tool de upload do MCP, a um custo de cerca de R$4 em API para 21 posts com imagem.
• Resultado mensurado: o blog saiu de cerca de 12 visualizações para 70-80 na semana em que os 21 posts foram publicados via esse fluxo.

Profundidade técnica

A arquitetura discutida trata o MCP como camada de interface adicional sobre uma aplicação Laravel já existente: o servidor MCP roda sobre rotas HTTP streamable comuns, sem processo separado (nada de php artisan serve dedicado), o que significa que em produção basta apontar o Nginx para a pasta public como em qualquer aplicação Laravel. O ponto central de design levantado foi o controle explícito do que é exposto ao agente — por exemplo, remover campos como slug do payload de uma tool quando não há necessidade de o agente enxergá-los — já que qualquer dado que chega a uma LLM pode ser usado para treinamento fora de contas Enterprise, o que levanta questões jurídicas em domínios sensíveis (dados médicos foi o exemplo discutido). Outro trade-off comentado foi quando vale a pena manter a camada MCP versus removê-la: em fluxos totalmente automatizados (curadoria de conteúdo sem intervenção humana, por exemplo), o MCP pode ser cortado em favor de um pipeline direto; já em fluxos onde um humano precisa interagir de forma exploratória com os dados (perguntar, redirecionar, curar), a interface de agente via MCP compensa o esforço de exposição. A comparação com a alternativa de texto-para-SQL usando dicionário de dados e modelo local (Ollama) — relatada por um participante como solução anterior ao MCP — reforça que o ganho do protocolo está em padronizar essa exposição de forma reutilizável entre múltiplos clientes de agente, em vez de construir harness e re-ranqueamento próprios a cada novo caso de uso.

Faça parte do Clã

Esse é só um recorte do que rolou ao vivo. Participe dos próximos encontros técnicos do Clã e leve suas próprias dúvidas para a mentoria: Beer and Code Clã Nível 1.