<p class="wp-block-paragraph">O Protocolo de Contexto de Modelo (MCP) é um padrão aberto criado para resolver esse problema. Introduzido pela <a href="https://cloud.google.com/products/model-garden/claude" rel="noreferrer noopener" target="_blank">Anthropic</a> em novembro de 2024, o MCP fornece uma “linguagem” segura e padronizada para que LLMs se comuniquem com dados, aplicativos e serviços externos. Ele atua como uma ponte, permitindo que a IA vá além do conhecimento estático e se torne um <a href="https://cloud.google.com/discover/what-are-ai-agents" rel="noreferrer noopener" target="_blank">agente</a> dinâmico que pode recuperar informações atuais e agir, tornando-a mais precisa, útil e automatizada.</p> <h1 class="wp-block-heading">Entender o Protocolo de Contexto de Modelo</h1> <p class="wp-block-paragraph">O MCP cria uma conexão bidirecional padronizada para aplicativos de IA, permitindo que LLMs se conectem facilmente a várias fontes de dados e ferramentas. O MCP se baseia em conceitos já existentes, como o uso de ferramentas e a chamada de função, mas os padroniza. Isso reduz a necessidade de conexões personalizadas para cada novo modelo de IA e sistema externo. Elas permitem que os LLMs usem dados atuais e do mundo real, realizem ações e acessem recursos especializados que não foram incluídos no treinamento original.</p> <h2 class="wp-block-heading">O que é proibido no padrão corporativo</h2> <p class="wp-block-paragraph">❌ MCP com LLM embutido<br>❌ MCP decidindo fluxo conversacional<br>❌ MCP mantendo histórico de diálogo<br>❌ Expor legado diretamente ao agente<br>❌ Retry automático infinito<br>❌ Mensagens técnicas ao usuário</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <div style="height:100px" aria-hidden="true" class="wp-block-spacer"></div> <h1 class="wp-block-heading">Arquitetura e Componentes do MCP — Explicação Aprofundada</h1> <p class="wp-block-paragraph">O <strong>Model Context Protocol (MCP)</strong> define <strong>como um LLM acessa capacidades externas</strong> (dados, sistemas, ferramentas) de forma <strong>padronizada e desacoplada</strong>.</p> <p class="wp-block-paragraph">Ele não é um “produto”, mas um <strong>protocolo de interação</strong> entre três componentes bem definidos:</p> Host MCP ←→ Cliente MCP ←→ Servidor MCP <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">1️⃣ Host do MCP (onde o LLM vive)</h2> <h3 class="wp-block-heading">O que é</h3> <p class="wp-block-paragraph">O <strong>Host do MCP</strong> é o ambiente onde o <strong>LLM está executando</strong> e onde ocorre a <strong>interação com o usuário</strong>.</p> <p class="wp-block-paragraph">Exemplos:</p> <ul class="wp-block-list"> <li>Copilot Studio</li> <li>IDE com IA (VS Code + Copilot)</li> <li>Chat corporativo</li> <li>Assistente conversacional</li> </ul> <h3 class="wp-block-heading">Responsabilidades reais</h3> <p class="wp-block-paragraph">✅ Interpretar a mensagem do usuário<br>✅ Identificar intenção<br>✅ Manter histórico conversacional<br>✅ Decidir <strong>se</strong> e <strong>quando</strong> chamar um MCP<br>✅ Formular prompts e tool calls<br>✅ Transformar respostas técnicas em linguagem humana</p> <h3 class="wp-block-heading">O que o Host <strong>não</strong> faz</h3> <p class="wp-block-paragraph">❌ Não acessa sistemas legados diretamente<br>❌ Não conhece protocolos técnicos do backend<br>❌ Não implementa lógica de negócio</p> <p class="wp-block-paragraph">👉 O Host pensa, conversa e decide.<br>👉 Ele <strong>nunca fala diretamente com o legado</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">2️⃣ Cliente MCP (ponte técnica dentro do host)</h2> <h3 class="wp-block-heading">O que é</h3> <p class="wp-block-paragraph">O <strong>Cliente MCP</strong> é uma <strong>camada técnica interna ao host</strong>, responsável por <strong>viabilizar a comunicação</strong> entre o LLM e os servidores MCP.</p> <p class="wp-block-paragraph">Ele <strong>não é um sistema separado</strong>, mas um <strong>adaptador</strong>.</p> <h3 class="wp-block-heading">Função principal</h3> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">Traduzir a intenção do LLM em chamadas MCP e converter respostas MCP em contexto compreensível para o LLM.</p> </blockquote> <h3 class="wp-block-heading">Responsabilidades reais</h3> <p class="wp-block-paragraph">✅ Descobrir servidores MCP disponíveis<br>✅ Publicar tools para o LLM<br>✅ Validar contratos MCP<br>✅ Serializar / desserializar mensagens<br>✅ Garantir que a resposta siga o protocolo</p> <h3 class="wp-block-heading">Analogia simples</h3> <ul class="wp-block-list"> <li>LLM fala “linguagem natural”</li> <li>MCP fala “contrato estruturado”</li> <li>Cliente MCP é o <strong>intérprete</strong></li> </ul> <p class="wp-block-paragraph">👉 Em Copilot Studio, esse papel é exercido pelas <strong>Actions / Tool calls</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">3️⃣ Servidor MCP (capacidade externa)</h2> <h3 class="wp-block-heading">O que é</h3> <p class="wp-block-paragraph">O <strong>Servidor MCP</strong> é um <strong>serviço externo</strong> que fornece:</p> <ul class="wp-block-list"> <li>dados</li> <li>contexto</li> <li>capacidades</li> <li>ações</li> </ul> <p class="wp-block-paragraph">para o LLM <strong>de forma segura e padronizada</strong>.</p> <p class="wp-block-paragraph">Ele é <strong>agnóstico ao LLM</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h3 class="wp-block-heading">Responsabilidades reais</h3> <p class="wp-block-paragraph">✅ Expor tools bem definidas<br>✅ Encapsular acesso a sistemas externos<br>✅ Traduzir respostas técnicas em formato MCP<br>✅ Aplicar timeout curto<br>✅ Implementar cache<br>✅ Proteger sistemas legados</p> <h3 class="wp-block-heading">O que o Servidor MCP <strong>não</strong> faz</h3> <p class="wp-block-paragraph">❌ Não conversa com usuário<br>❌ Não mantém histórico conversacional<br>❌ Não decide fluxo<br>❌ Não contém LLM</p> <p class="wp-block-paragraph">👉 O MCP <strong>serve capacidades</strong>, não inteligência.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">4️⃣ Onde entram os sistemas legados</h2> <p class="wp-block-paragraph">Os sistemas legados <strong>não fazem parte do MCP</strong>.</p> <p class="wp-block-paragraph">Eles ficam <strong>atrás</strong> do Servidor MCP.</p> LLM ↓ Host MCP ↓ Cliente MCP ↓ Servidor MCP ↓ Sistemas Legados <h3 class="wp-block-heading">Por quê?</h3> <ul class="wp-block-list"> <li>Legado tem SLA alto</li> <li>Legado fala protocolos antigos</li> <li>Legado não é conversacional</li> <li>Legado não entende contexto</li> </ul> <p class="wp-block-paragraph">👉 O Servidor MCP <strong>desacopla o legado da IA</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">5️⃣ Fluxo completo (do usuário ao legado)</h2> <h3 class="wp-block-heading">Exemplo: cálculo de frete</h3> <ol class="wp-block-list"> <li>Usuário pergunta: “Quanto custa o frete?”</li> <li>Host MCP (Copilot): <ul class="wp-block-list"> <li>identifica intenção</li> <li>decide chamar MCP</li> </ul> </li> <li>Cliente MCP: <ul class="wp-block-list"> <li>seleciona tool <code>calcularFrete</code></li> <li>monta payload estruturado</li> </ul> </li> <li>Servidor MCP: <ul class="wp-block-list"> <li>verifica cache</li> <li>se necessário, chama legado</li> <li>normaliza resposta</li> </ul> </li> <li>Cliente MCP: <ul class="wp-block-list"> <li>converte resposta MCP para contexto do LLM</li> </ul> </li> <li>Host MCP: <ul class="wp-block-list"> <li>explica o resultado ao usuário</li> <li>registra histórico</li> </ul> </li> </ol> <p class="wp-block-paragraph">✅ Conversa fluida<br>✅ Legado protegido<br>✅ Arquitetura governável</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">6️⃣ Onde fica a inteligência de fallback e retomada</h2> <figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>Capacidade</th><th>Onde fica</th></tr></thead><tbody><tr><td>Fallback conversacional</td><td>Host MCP</td></tr><tr><td>Retomada de contexto</td><td>Host MCP</td></tr><tr><td>Histórico do usuário</td><td>Host MCP</td></tr><tr><td>Timeout técnico</td><td>Servidor MCP</td></tr><tr><td>Cache</td><td>Servidor MCP</td></tr><tr><td>Retry técnico</td><td>Servidor MCP</td></tr></tbody></table></figure> <p class="wp-block-paragraph">👉 <strong>Nunca no legado</strong><br>👉 <strong>Nunca dentro do MCP como “IA”</strong></p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">7️⃣ Erro comum de interpretação (importante)</h2> <p class="wp-block-paragraph">❌ “O MCP é um agente”<br>❌ “O MCP conversa”<br>❌ “O MCP decide”</p> <p class="wp-block-paragraph">✅ Correto:</p> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">O MCP <strong>fornece contexto e capacidades</strong> para que o LLM decida.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">8️⃣ Frase técnica correta (para documentação)</h2> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">O Model Context Protocol define uma separação clara entre o ambiente que hospeda o LLM (Host MCP), a camada de comunicação (Cliente MCP) e os serviços externos que fornecem capacidades (Servidor MCP), permitindo que modelos de linguagem interajam com sistemas corporativos de forma desacoplada, segura e governável.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">9️⃣ Tradução disso para o padrão corporativo</h2> <ul class="wp-block-list"> <li>MCP Server <strong>é backend</strong></li> <li>Agente / Copilot <strong>é orquestrador</strong></li> <li>Cliente MCP <strong>é infraestrutura invisível</strong></li> <li>Legado <strong>nunca é exposto diretamente</strong></li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <p class="wp-block-paragraph">Se quiser, posso:</p> <ul class="wp-block-list"> <li>✅ Reescrever esse texto no <strong>tom normativo corporativo</strong></li> <li>✅ Criar um <strong>diagrama oficial MCP × Copilot × Legado</strong></li> <li>✅ Adaptar para <strong>documentação interna dos Correios</strong></li> <li>✅ Fazer um <strong>comparativo MCP × API tradicional</strong></li> </ul> <p class="wp-block-paragraph">Você quer essa explicação <strong>mais didática (treinamento)</strong> ou <strong>mais normativa (padrão / política interna)</strong>?</p> <p class="wp-block-paragraph">Perfeito. Abaixo está um <strong>DIAGRAMA MCP COMPLETO</strong>, no nível <strong>arquitetural oficial</strong>, cobrindo <strong>todos os componentes</strong>, <strong>fluxos</strong>, <strong>responsabilidades</strong> e <strong>fronteiras corretas</strong>.<br>Ele pode ser usado diretamente em <strong>documentação</strong>, <strong>padrão corporativo</strong>, <strong>treinamento</strong> ou convertido em <strong>slide/Visio/Draw.io</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">🧩 DIAGRAMA COMPLETO — Arquitetura MCP (Model Context Protocol)</h1> <h2 class="wp-block-heading">1️⃣ Visão geral (macroarquitetura)</h2> <hr class="wp-block-separator has-alpha-channel-opacity"/> ┌────────────────────────────────────────────┐ │ USUÁRIO │ └─────────────────────┬──────────────────────┘ │ linguagem natural ▼ ┌────────────────────────────────────────────┐ │ HOST DO MCP │ │ (Copilot / Agente de IA / IDE com IA) │ │ ────────────────────────────────────────── │ │ • LLM │ │ • Diálogo │ │ • Intenção │ │ • Histórico │ │ • Regras conversacionais │ └─────────────────────┬──────────────────────┘ │ tool call ▼ ┌────────────────────────────────────────────┐ │ CLIENTE MCP │ │ (camada técnica no host) │ │ ────────────────────────────────────────── │ │ • Descoberta de MCPs │ │ • Publicação de tools ao LLM │ │ • Tradução LLM ↔ MCP │ │ • Validação de contratos │ └─────────────────────┬──────────────────────┘ │ protocolo MCP ▼ ┌────────────────────────────────────────────┐ │ SERVIDOR MCP │ │ (serviço externo técnico) │ │ ────────────────────────────────────────── │ │ • Tools / Actions │ │ • Cache │ │ • Timeout curto │ │ • Normalização de respostas │ │ • Segurança │ └─────────────────────┬──────────────────────┘ │ chamadas técnicas ▼ ┌────────────────────────────────────────────┐ │ SISTEMAS LEGADOS │ │ ────────────────────────────────────────── │ │ • Regras de negócio │ │ • Cálculos │ │ • Bases de dados │ │ • Serviços antigos │ └────────────────────────────────────────────┘ <h2 class="wp-block-heading">2️⃣ DIAGRAMA EM MERMAID </h2> <p class="wp-block-paragraph"><img src="blob:https://labdx.org/2bf0d1f3-a788-4c19-b7fc-cd8a1dd0202d"></p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">3️⃣ Fronteiras claras (o que pertence a quem)</h2> <h3 class="wp-block-heading">🔹 Host do MCP</h3> <p class="wp-block-paragraph"><strong>Responsável por inteligência e conversa</strong></p> <ul class="wp-block-list"> <li>LLM</li> <li>Diálogo com usuário</li> <li>Histórico conversacional</li> <li>Retomada de contexto</li> <li>Decisão de chamar MCP</li> <li>Fallback conversacional</li> </ul> <p class="wp-block-paragraph">❌ Não acessa legado<br>❌ Não conhece protocolos técnicos</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h3 class="wp-block-heading">🔹 Cliente MCP</h3> <p class="wp-block-paragraph"><strong>Responsável por tradução técnica</strong></p> <ul class="wp-block-list"> <li>Descobre MCPs disponíveis</li> <li>Expõe tools ao LLM</li> <li>Converte linguagem do LLM em chamadas MCP</li> <li>Converte respostas MCP em contexto para o LLM</li> </ul> <p class="wp-block-paragraph">👉 É <strong>infraestrutura invisível</strong></p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h3 class="wp-block-heading">🔹 Servidor MCP</h3> <p class="wp-block-paragraph"><strong>Responsável por capacidades externas</strong></p> <ul class="wp-block-list"> <li>Exposição de tools</li> <li>Cache</li> <li>Timeout curto</li> <li>Normalização de dados</li> <li>Segurança</li> <li>Proteção do legado</li> </ul> <p class="wp-block-paragraph">❌ Não conversa<br>❌ Não mantém histórico<br>❌ Não decide fluxo<br>❌ Não contém LLM</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h3 class="wp-block-heading">🔹 Sistemas Legados</h3> <p class="wp-block-paragraph"><strong>Responsáveis apenas por negócio</strong></p> <ul class="wp-block-list"> <li>Cálculos</li> <li>Dados</li> <li>Regras antigas</li> </ul> <p class="wp-block-paragraph">❌ Não sabem que existe IA<br>❌ Não falam MCP<br>❌ Não têm SLA conversacional</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">4️⃣ Fluxo completo de uma interação (passo a passo)</h2> <h3 class="wp-block-heading">Exemplo: cálculo de frete</h3> <ol class="wp-block-list"> <li>Usuário pergunta: “Quanto custa o frete?”</li> <li><strong>Host MCP</strong> <ul class="wp-block-list"> <li>identifica intenção</li> <li>avalia histórico</li> <li>decide chamar MCP</li> </ul> </li> <li><strong>Cliente MCP</strong> <ul class="wp-block-list"> <li>seleciona tool <code>calcularFrete</code></li> <li>estrutura payload MCP</li> </ul> </li> <li><strong>Servidor MCP</strong> <ul class="wp-block-list"> <li>verifica cache</li> <li>chama legado se necessário</li> <li>normaliza resposta</li> </ul> </li> <li><strong>Cliente MCP</strong> <ul class="wp-block-list"> <li>traduz resposta para o LLM</li> </ul> </li> <li><strong>Host MCP</strong> <ul class="wp-block-list"> <li>explica o resultado ao usuário</li> <li>registra evento no histórico</li> </ul> </li> </ol> <p class="wp-block-paragraph">✅ Conversa fluida<br>✅ Legado protegido<br>✅ Governança clara</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">5️⃣ Onde ficam timeout, fallback e retomada (ponto crítico)</h2> <figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>Capacidade</th><th>Onde fica</th></tr></thead><tbody><tr><td>Timeout técnico</td><td>Servidor MCP</td></tr><tr><td>Cache</td><td>Servidor MCP</td></tr><tr><td>Retry técnico</td><td>Servidor MCP</td></tr><tr><td>Fallback conversacional</td><td>Host MCP</td></tr><tr><td>Retomada de contexto</td><td>Host MCP</td></tr><tr><td>Histórico do usuário</td><td>Host MCP</td></tr></tbody></table></figure> <p class="wp-block-paragraph">👉 <strong>Nunca no legado</strong><br>👉 <strong>Nunca dentro do MCP como “IA”</strong></p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">6️⃣ Diagrama de responsabilidades (resumo executivo)</h2> Usuário conversa com → HOST MCP HOST MCP decide → CLIENTE MCP CLIENTE MCP chama → SERVIDOR MCP SERVIDOR MCP protege → LEGADO <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">7️⃣ Frase oficial para documentação corporativa</h2> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">O Model Context Protocol estabelece uma arquitetura em camadas composta por Host MCP, Cliente MCP e Servidor MCP, permitindo que modelos de linguagem interajam com sistemas corporativos de forma desacoplada, governável e resiliente, sem exposição direta de sistemas legados.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">8️⃣ Erros comuns que esse diagrama evita</h2> <p class="wp-block-paragraph">❌ MCP como agente<br>❌ MCP com LLM embutido<br>❌ Legado sendo chamado direto pelo Copilot<br>❌ Fallback implementado no backend<br>❌ Confusão entre cliente MCP e servidor MCP</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <p class="wp-block-paragraph"><strong> (com menos detalhe técnico)</strong> ou <strong>mais técnico (para times de desenvolvimento)</strong>?</p> <p class="wp-block-paragraph">Perfeito — vou responder <strong>de forma bem técnica e objetiva</strong>, separando claramente:</p> <ol class="wp-block-list"> <li><strong>Onde os Correios atuam na arquitetura MCP</strong></li> <li><strong>Quais produtos/ativos os Correios precisam oferecer</strong></li> <li><strong>O que é responsabilidade do cliente / e‑commerce</strong></li> <li><strong>Como isso se conecta no MCP de preços e prazos</strong></li> </ol> <p class="wp-block-paragraph">Pense nisso como um <strong>mapa de responsabilidades + portfólio de produtos</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">1️⃣ Onde os Correios atuam na arquitetura MCP</h1> <p class="wp-block-paragraph">Os <strong>Correios NÃO atuam</strong> no Host MCP nem no Cliente MCP.<br>Eles atuam <strong>exclusivamente no lado do Servidor MCP e dos sistemas de negócio</strong>.</p> <h3 class="wp-block-heading">Arquitetura com responsabilidades destacadas</h3> [ Cliente / E‑commerce / IA ] │ │ (Copilot, Chatbot, Plataforma) ▼ ┌─────────────────────────────┐ │ Host MCP (Agente / LLM) │ ❌ Correios NÃO atuam └─────────────┬──────────────┘ │ ┌─────────────────────────────┐ │ Cliente MCP (SDK / Adapter) │ ❌ Correios NÃO atuam └─────────────┬──────────────┘ │ ┌─────────────────────────────┐ │ ✅ SERVIDOR MCP CORREIOS │ ✅ ATUAÇÃO DOS CORREIOS │ ────────────────────────── │ │ • Tool: preços e prazos │ │ • Cache │ │ • Timeout curto │ │ • Normalização │ └─────────────┬──────────────┘ │ ┌─────────────────────────────┐ │ ✅ SISTEMAS DE NEGÓCIO │ ✅ ATUAÇÃO DOS CORREIOS │ • Tarifação │ │ • Prazos │ │ • Serviços (PAC, SEDEX…) │ └─────────────────────────────┘ <p class="wp-block-paragraph">👉 <strong>Resumo</strong>:<br>Os Correios são <strong>provedores de capacidade</strong>, não de IA.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">2️⃣ Produtos que os Correios precisam oferecer (portfólio MCP)</h1> <p class="wp-block-paragraph">Para que <strong>qualquer cliente ou e‑commerce</strong> use um MCP de preços e prazos, os Correios precisam disponibilizar <strong>3 camadas de produto</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">🔹 Produto 1 — Servidor MCP oficial dos Correios (NOVO)</h2> <p class="wp-block-paragraph">Esse é o <strong>produto estratégico</strong>.</p> <h3 class="wp-block-heading">O que é</h3> <p class="wp-block-paragraph">Um <strong>Servidor MCP</strong> padronizado, público (ou autenticado), que expõe tools de logística.</p> <h3 class="wp-block-heading">Tool mínima obrigatória</h3> <p class="wp-block-paragraph">calcularPrecosEPrazos</p> <h3 class="wp-block-heading">Contrato MCP (exemplo)</h3> <pre class="wp-block-preformatted">{<br>"origem": "CEP",<br>  "destino": "CEP",<br>  "peso": "kg",<br>  "dimensoes": {<br>    "altura": "cm",<br>    "largura": "cm",<br>    "comprimento": "cm"<br>  },<br>  "servico": "PAC | SEDEX | ..."<br>}</pre> <p class="wp-block-paragraph"></p> <h3 class="wp-block-heading">Resposta MCP</h3> <pre class="wp-block-preformatted">{<br><br>  "status": "ok | partial | unavailable",<br>  "data": {<br>    "preco": 23.40,<br>    "prazoDias": 5,<br>    "servico": "SEDEX"<br>  },<br>  "source": "cache | sistema_tarifacao",<br>  "confidence": "high",<br>  "retryAllowed": true<br>}</pre> <p class="wp-block-paragraph">✅ <strong>Esse é o MCP em si</strong><br>✅ Reutilizável por IA, e‑commerce, apps, marketplaces</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">🔹 Produto 2 — APIs corporativas de logística (já existem, mas precisam ser organizadas)</h2> <p class="wp-block-paragraph">Esses são os <strong>ativos atuais dos Correios</strong>, que ficam <strong>atrás do MCP</strong>.</p> <p class="wp-block-paragraph">Exemplos:</p> <ul class="wp-block-list"> <li>API de preços</li> <li>API de prazos</li> <li>Tabelas contratuais</li> <li>Regras por serviço</li> <li>Regras por cliente</li> </ul> <p class="wp-block-paragraph">⚠️ <strong>Importante</strong>:<br>Essas APIs <strong>NÃO devem ser consumidas diretamente por IA</strong>.</p> <p class="wp-block-paragraph">👉 O MCP:</p> <ul class="wp-block-list"> <li>encapsula</li> <li>normaliza</li> <li>protege</li> <li>aplica cache</li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">🔹 Produto 3 — Catálogo técnico para desenvolvedores</h2> <p class="wp-block-paragraph">Sem isso, o MCP não escala.</p> <h3 class="wp-block-heading">Deve incluir:</h3> <ul class="wp-block-list"> <li>Documentação do MCP</li> <li>Lista de tools</li> <li>Schemas JSON</li> <li>SLAs</li> <li>Exemplos de uso (IA e e‑commerce)</li> <li>Regras de cache</li> <li>Códigos de status</li> </ul> <p class="wp-block-paragraph">👉 Isso é o <strong>“Correios Developer Portal” versão MCP</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">3️⃣ O que o cliente / e‑commerce precisa ter</h1> <p class="wp-block-paragraph">O cliente <strong>não precisa implementar MCP Server</strong>.</p> <p class="wp-block-paragraph">Ele precisa apenas de:</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">✅ Opção A — E‑commerce tradicional (sem IA)</h2> E‑commerce ↓ Cliente MCP (SDK / Adapter) ↓ MCP Correios <ul class="wp-block-list"> <li>Plugin / SDK MCP</li> <li>Ou gateway que suporte MCP</li> <li>Usa MCP como usaria uma API</li> </ul> <p class="wp-block-paragraph">✅ Zero IA obrigatória</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">✅ Opção B — E‑commerce com IA / Copilot</h2> Usuário ↓ Copilot / Agente ↓ Cliente MCP ↓ MCP Correios <p class="wp-block-paragraph">O cliente fornece:</p> <ul class="wp-block-list"> <li>Host MCP (Copilot, bot, app)</li> <li>Histórico do usuário</li> <li>Fallback e UX</li> </ul> <p class="wp-block-paragraph">👉 <strong>Toda a inteligência fica do lado do cliente</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">4️⃣ O que NÃO é responsabilidade dos Correios</h1> <p class="wp-block-paragraph">❌ Criar agente de IA para o cliente<br>❌ Gerenciar histórico conversacional<br>❌ Decidir fallback conversacional<br>❌ Criar UX de chat<br>❌ Conhecer o fluxo do e‑commerce</p> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">Correios fornecem <strong>capacidade logística</strong>, não <strong>experiência conversacional</strong>.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">5️⃣ Visão consolidada — “quem faz o quê”</h1> <figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>Camada</th><th>Responsável</th></tr></thead><tbody><tr><td>IA / Copilot</td><td>Cliente / E‑commerce</td></tr><tr><td>Histórico / UX</td><td>Cliente / E‑commerce</td></tr><tr><td>Cliente MCP</td><td>Plataforma do cliente</td></tr><tr><td><strong>Servidor MCP</strong></td><td>✅ <strong>Correios</strong></td></tr><tr><td>Cache técnico</td><td>✅ <strong>Correios</strong></td></tr><tr><td>Tarifação / Prazos</td><td>✅ <strong>Correios</strong></td></tr><tr><td>Sistemas legados</td><td>✅ <strong>Correios</strong></td></tr></tbody></table></figure> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">6️⃣ Frase pronta para apresentação institucional</h1> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">Os Correios atuam como provedores de capacidades logísticas por meio de um Servidor MCP oficial, expondo preços e prazos de forma padronizada e desacoplada, permitindo que e‑commerces e agentes de IA consumam essas informações sem dependência direta de sistemas legados.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h2 class="wp-block-heading">Próximo passo (se quiser)</h2> <p class="wp-block-paragraph">Posso:</p> <ul class="wp-block-list"> <li>✅ Criar um <strong>mapa de produtos MCP dos Correios</strong></li> <li>✅ Ajudar a definir <strong>roadmap de implantação</strong></li> <li>✅ Montar um <strong>slide “Proposta de valor MCP Correios”</strong></li> <li>✅ Comparar <strong>MCP vs APIs tradicionais Correios</strong></li> </ul> <p class="wp-block-paragraph">Você quer que eu <strong>transforme isso em um slide executivo</strong> ou em um <strong>documento técnico de produto</strong>?</p> <p class="wp-block-paragraph">Excelente pergunta — esse é <strong>o ponto mais perigoso</strong> de todo o desenho.<br>Vou ser <strong>bem direto e técnico</strong>, porque “consumir a API direto como se fosse encapsulamento” <strong>parece simples</strong>, mas <strong>cria riscos graves</strong> quando o consumidor é IA, e‑commerce ou ambos.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">⚠️ Qual o perigo de consumir as APIs diretamente (sem MCP de verdade)</h1> <h2 class="wp-block-heading">Resumo executivo (frase curta)</h2> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">Consumir APIs legadas diretamente, tratando-as como “encapsulamento”, transfere riscos técnicos, operacionais e conversacionais para o cliente, quebra o fluxo da IA e cria dependência rígida de contratos que não foram desenhados para uso conversacional.</p> </blockquote> <div style="height:100px" aria-hidden="true" class="wp-block-spacer"></div> <h1 class="wp-block-heading">P<strong>erigos concretos</strong>.</h1> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">1️⃣ Quebra do fluxo conversacional (o risco nº 1)</h1> <h3 class="wp-block-heading">O que acontece na prática</h3> <p class="wp-block-paragraph">APIs legadas:</p> <ul class="wp-block-list"> <li>demoram</li> <li>variam latência</li> <li>falham sem padrão</li> <li>retornam erros técnicos</li> <li>não têm noção de contexto</li> </ul> <p class="wp-block-paragraph">Quando o <strong>agente de IA</strong> consome isso direto:</p> <ul class="wp-block-list"> <li>tool call estoura timeout</li> <li>LLM “abandona” a intenção</li> <li>fallback automático entra</li> <li>resposta vira genérica</li> <li>usuário perde confiança</li> </ul> <p class="wp-block-paragraph">👉 <strong>A IA não espera sistemas legados</strong>.</p> <h3 class="wp-block-heading">Sem MCP</h3> IA → API legado (3–6s) ❌ timeout ❌ conversa quebra <h3 class="wp-block-heading">Com MCP</h3> IA → MCP (<300ms) ✅ conversa continua ↓ legado (em background) <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">2️⃣ SLA errado exposto ao cliente (erro arquitetural)</h1> <h3 class="wp-block-heading">APIs legadas têm SLA de negócio</h3> <ul class="wp-block-list"> <li>2s</li> <li>5s</li> <li>10s</li> <li>variável</li> </ul> <h3 class="wp-block-heading">IA precisa de SLA conversacional</h3> <ul class="wp-block-list"> <li>previsível</li> <li>curto</li> <li>consistente</li> </ul> <p class="wp-block-paragraph">Quando o cliente consome API direta:</p> <ul class="wp-block-list"> <li>o SLA do legado vira SLA da IA</li> <li>o cliente herda o problema</li> <li>o Correios perde controle da experiência</li> </ul> <p class="wp-block-paragraph">👉 MCP existe exatamente para <strong>desacoplar SLAs</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">3️⃣ Contratos instáveis e difíceis de evoluir</h1> <p class="wp-block-paragraph">APIs legadas:</p> <ul class="wp-block-list"> <li>retornam campos demais</li> <li>mudam nomes</li> <li>têm códigos específicos</li> <li>expõem regras internas</li> </ul> <p class="wp-block-paragraph">Quando o cliente consome direto:</p> <ul class="wp-block-list"> <li>qualquer mudança quebra integração</li> <li>não há versionamento conversacional</li> <li>IA passa a “aprender” contratos errados</li> </ul> <p class="wp-block-paragraph">Com MCP:</p> <ul class="wp-block-list"> <li>contrato é <strong>estável</strong></li> <li>mudanças internas não vazam</li> <li>MCP absorve evolução do legado</li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">4️⃣ Erros técnicos vazam para a IA (grave)</h1> <p class="wp-block-paragraph">Exemplos reais de retorno legado:</p> <ul class="wp-block-list"> <li>HTTP 500</li> <li>stacktrace</li> <li>códigos internos</li> <li>mensagens técnicas</li> </ul> <p class="wp-block-paragraph">IA não sabe lidar com isso corretamente.</p> <p class="wp-block-paragraph">Resultado:</p> <ul class="wp-block-list"> <li>respostas confusas</li> <li>mensagens incoerentes ao usuário</li> <li>risco reputacional</li> </ul> <h3 class="wp-block-heading">MCP correto</h3> <p class="wp-block-paragraph">Retorna sempre algo assim:</p> <p class="wp-block-paragraph">{</p> <p class="wp-block-paragraph">  “status”: “unavailable”,</p> <p class="wp-block-paragraph">  “retryAllowed”: true</p> <p class="wp-block-paragraph">}</p> <p class="wp-block-paragraph">👉 A IA sabe o que fazer.<br>👉 O usuário nunca vê erro técnico.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">5️⃣ Retry descontrolado (risco operacional)</h1> <p class="wp-block-paragraph">LLMs <strong>tentam de novo automaticamente</strong> quando algo falha.</p> <p class="wp-block-paragraph">Se a IA chama a API direto:</p> <ul class="wp-block-list"> <li>múltiplas tentativas</li> <li>picos de carga</li> <li>efeito cascata</li> <li>possível indisponibilidade do legado</li> </ul> <p class="wp-block-paragraph">Sem MCP:</p> IA → API IA → API IA → API ❌ <p class="wp-block-paragraph">Com MCP:</p> <ul class="wp-block-list"> <li>retry técnico controlado</li> <li>circuit breaker</li> <li>cache</li> <li>proteção do backend</li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">6️⃣ Cache inexistente ou mal implementado</h1> <p class="wp-block-paragraph">APIs legadas:</p> <ul class="wp-block-list"> <li>geralmente não têm cache</li> <li>ou cache não é pensado para CEP/peso/faixa</li> </ul> <p class="wp-block-paragraph">IA:</p> <ul class="wp-block-list"> <li>repete perguntas</li> <li>gera alto volume</li> <li>chama várias vezes o mesmo cálculo</li> </ul> <p class="wp-block-paragraph">Sem MCP:</p> <ul class="wp-block-list"> <li>cada pergunta = chamada real</li> <li>custo e latência explodem</li> </ul> <p class="wp-block-paragraph">Com MCP:</p> <ul class="wp-block-list"> <li>cache é <strong>obrigatório</strong></li> <li>hot path resolve 80–95%</li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">7️⃣ Acoplamento direto com o cliente (problema institucional)</h1> <p class="wp-block-paragraph">Quando o cliente consome API direto:</p> <ul class="wp-block-list"> <li>ele aprende detalhes internos</li> <li>cria dependência de comportamento</li> <li>dificulta mudanças futuras</li> <li>dificulta governança</li> </ul> <p class="wp-block-paragraph">Com MCP:</p> <ul class="wp-block-list"> <li>Correios controlam o contrato</li> <li>Correios controlam evolução</li> <li>Correios protegem o core</li> </ul> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">8️⃣ Impossibilidade de uso seguro por IA</h1> <p class="wp-block-paragraph">Esse é o ponto-chave.</p> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph"><strong>APIs legadas NÃO são seguras para consumo direto por LLMs.</strong></p> </blockquote> <p class="wp-block-paragraph">Elas não foram desenhadas para:</p> <ul class="wp-block-list"> <li>tool calling</li> <li>fallback</li> <li>partial responses</li> <li>status semântico</li> <li>conversação</li> </ul> <p class="wp-block-paragraph">👉 MCP <strong>não é luxo</strong>, é <strong>camada de segurança para IA</strong>.</p> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">9️⃣ Comparativo direto (API direto × MCP)</h1> <figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>Aspecto</th><th>API direta</th><th>MCP correto</th></tr></thead><tbody><tr><td>SLA</td><td>legado</td><td>conversacional</td></tr><tr><td>Cache</td><td>raro</td><td>obrigatório</td></tr><tr><td>Timeout</td><td>longo</td><td>curto</td></tr><tr><td>Retry</td><td>descontrolado</td><td>controlado</td></tr><tr><td>Erro</td><td>técnico</td><td>semântico</td></tr><tr><td>Evolução</td><td>arriscada</td><td>segura</td></tr><tr><td>IA-friendly</td><td>❌</td><td>✅</td></tr><tr><td>Governança</td><td>❌</td><td>✅</td></tr></tbody></table></figure> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">🔑 Regra de ouro (para padrão corporativo)</h1> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph"><strong>Encapsular não é apenas “colocar uma API na frente”.<br>MCP é uma camada de adaptação semântica, temporal e operacional entre IA e sistemas legados.</strong></p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <h1 class="wp-block-heading">Frase pronta para defender em comitê</h1> <blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"> <p class="wp-block-paragraph">Consumir APIs legadas diretamente, mesmo com um wrapper simples, expõe latência, erros e contratos inadequados ao consumo por IA, comprometendo o fluxo conversacional e a governança. O MCP existe para desacoplar essas preocupações.</p> </blockquote> <hr class="wp-block-separator has-alpha-channel-opacity"/> <p class="wp-block-paragraph"></p> <p class="wp-block-paragraph"></p>

{
"origem": "CEP",
  "destino": "CEP",
  "peso": "kg",
  "dimensoes": {
    "altura": "cm",
    "largura": "cm",
    "comprimento": "cm"
  },
  "servico": "PAC | SEDEX | ..."
}

{

  "status": "ok | partial | unavailable",
  "data": {
    "preco": 23.40,
    "prazoDias": 5,
    "servico": "SEDEX"
  },
  "source": "cache | sistema_tarifacao",
  "confidence": "high",
  "retryAllowed": true
}