Regras para Construir um Servidor MCP Eficiente

Artigos

🔍 4 Regras para Construir um Servidor MCP Eficiente

Regras de design concretas para servidores MCP que tratam o servidor como uma interface de usuário para um LLM em vez de um simples proxy de API. Recomenda projetar ferramentas em torno das intenções do usuário em vez de pontos finais de API brutos, limitando a exposição a aproximadamente 15 a 20 ferramentas por servidor para limitar o consumo de tokens, escrevendo descrições de ferramentas e mensagens de erro que orientam ativamente o modelo, e filtrando agressivamente os payloads de resposta (por exemplo, com JMESPath) para retornar apenas os campos que são necessários, mostrando uma redução de payloads de 80 a 90 por cento.

🔍 A2A É um Protocolo Sem Sentido

A contribuição única é a crítica arquitetônica: ela reformula os primitivos do "protocolo de agente" de mensagens diretas de ponto final para uma infraestrutura de eventos orientada a fluxo. Explica como primitivos estilo Kafka (grupos de consumidores, logs duráveis de apenas anexação, atraso/observabilidade, reprodução, retenção, tratamento de cartas mortas e particionamento) centralizam a pressão de retorno e a recuperação de falhas que a mensagem direta forçaria a cada agente. Em seguida, propõe um envelope de evento de agente cobrindo correlação/causalidade, versionamento, supersessão/compactação e campos de rastreamento.

🔍 Definição de API e Gestão de Protobuffer no Carousell Group

A contribuição única é um pipeline CI de produção que padroniza contratos proto em repositórios por unidade de negócios: impõe propriedade/autenticação/PII de RPC via anotações protobuf, bloqueia PII não anotadas usando regex+CI, e valida entradas com protoc-gen-validate. Arquitetonicamente, separa a fonte proto dos módulos Go gerados (servidor/cliente), previne importações proto entre serviços via listas brancas, e usa a detecção de mudança quebrada do buf.build além da geração de código de ramificação de recursos com segurança de mesclagem (sem commits de ramificação de recursos no go.mod do serviço).

🔍 Construindo Fluxos de Trabalho Transacionais Através de APIs Não Transacionais

A contribuição única é o design de saga focado em agentes e orientado para produção para APIs SaaS não transacionais: usar orquestração (coordenador) mais tempos de execução duráveis para persistir estado através de longas esperas, registrar compensações antes de executar a etapa (semântica de pivô), e tratar compensações como ações de negócios semânticas. Exige leitura após escrita em cada chamada de terceiros para derrotar a "narrativa" não confiável do LLM, e deriva chaves de idempotência estrutural a partir de execução/etapa/ferramenta (incluindo um namespace de compensação separado) para retomar tentativas com segurança.

🔍 Projete o Salesforce Como um Sistema Distribuído

A contribuição única é um design "distribuído" opinativo para o Salesforce: emparelhar Ações de Trigger para lógica de domínio síncrona e de único proprietário com Eventos de Plataforma que publicam apenas fatos de domínio. Impõe eventos de notificação finos dentro da organização (publicar após o commit, apenas ids, reconsultar localmente) versus fatos externos volumosos. Também enquadra orquestração versus coreografia com coordenadores/sagas locais e fundamenta a orientação em mecânicas concretas de Eventos de Plataforma: publicar imediato versus após o commit, enfileiramento assíncrono versus entrega, retenção, deduplicação e ordenação por chave de partição.

🔍 Não Tranque Sua API - Tranque Seu Agendador em Vez Disso

A contribuição única: inverter a responsabilidade adiando o bloqueio distribuído da ingestão por solicitação para um agendador de uma vez por janela. A API apenas persiste pedidos como PENDENTES; o trabalho agendado usa ShedLock para execução única em cluster, limpa o contexto de persistência JPA, processa cada participante em transações REQUIRES_NEW, rejeita explicitamente pedidos atrasados no corte, e publica eventos em lote via TransactionSynchronizationManager.afterCommit para Kafka. A partição do Kafka é chaveada por windowKey para preservar a ordenação sem bloqueios extras.

🔍 Versionamento de Eventos Com Upcasters: Evolução de Esquema Que Não Quebra a Reprodução

A contribuição única: um design de cadeia de upcaster passo a passo que centraliza a evolução do esquema para que os consumidores evitem ramificações de versão. Implementa transformações de vN para vN+1 (renomeação e correções unitárias, reestruturação de plano para aninhado), executa-as na leitura com base na schema_version armazenada, e colapsa para uma estrutura atual. Também enumera restrições de determinismo para reprodução (sem relógios, sem buscas externas, sem vazamento de aleatoriedade/ordem de mapa) e discute o cache do resultado do upcast para controlar o custo de longas cadeias.

🔍 Como Projetar Chaves de Idempotência Que Sobrevivem a Mudanças de Formato de Evento a Montante

A contribuição única: um esquema de chave de idempotência durável que permanece correto sob a deriva de formato de evento a montante. Prescreve quatro regras concretas para chaves de hash de payload: hash apenas campos estáveis a montante, normalize entradas de forma determinística, fixe o algoritmo de hash mais o formato de serialização wire, e incorpore uma versão de esquema como v1:hash(...) na chave. Em seguida, apresenta um fluxo de trabalho de detecção de deriva de esquema, mintagem de chave v2, preenchimento gradual com busca de chave dupla, corte de integração paralelo opcional, e SQL/métricas defensivas (relatórios duplicados, taxas de colisão, deriva de conjunto de campos) para detectar vazamentos.

🔍 Como Construímos Rollbacks de Saga para Workflows do Cloudflare

A contribuição única é um design concreto para rollbacks de saga nos Workflows do Cloudflare: os metadados de rollback são anexados por passo.do via {rollback, rollbackConfig} para que a compensação execute apenas em falha terminal do workflow. Manipuladores elegíveis incluem o passo falhado mesmo quando a saída é indefinida; as compensações são executadas na ordem reversa de início de passo durável (não de conclusão). Nos bastidores, o histórico de passos duráveis registra elegibilidade/saída enquanto o código do manipulador de rollback é mantido como stubs chamáveis, reconstruídos via reprodução usando resultados persistidos para evitar re-executar efeitos colaterais externos concluídos.

🔍 Eu Reverterei 50 Quebras de API. Os Mesmos Cinco Erros Continuam Aparecendo.

A contribuição única é um "Ciclo de Vida de Segurança de API" orientado para produção que vincula cinco padrões de violação recorrentes a controles de engenharia específicos: impor BOLA na camada de dados com testes adversariais de CI/CD por endpoint; governar a confiança de terceiros documentando escopos e revisando/revocando a cada 90 dias; prevenir a proliferação de segredos via revisão de código com foco em cofres e SLAs de varredura de segredos acionáveis; detectar enumeração/exfiltração usando linhas de base comportamentais autoradas por endpoint e contexto de propriedade; manter inventário de API/descomissionamento de endpoint para que a segurança seja contínua, não trimestral.

🔍 Orquestre o Núcleo, Coreografe as Bordas: Como Eu Realmente Escolho Entre os Dois

A contribuição única é um quadrante de decisão e critérios de costura concretos para "orquestrar o núcleo, coreografar as bordas." Liga a orquestração a ramificações complexas e com estado com humano no loop, timeouts, e desfazendo compensações via uma máquina de estado/workflow. Liga a coreografia a ações autônomas,