Documentação
BlogCentral de AjudaDocumentação APIO Melhor EnvioVerifique a Integração

MCP Server — Melhor Envio

Conecte seu modelo de IA à API do Melhor Envio em minutos, sem precisar gerenciar chamadas REST manualmente.

O que é MCP?

MCP (Model Context Protocol) é um protocolo aberto que padroniza a forma como modelos de linguagem (LLMs) se conectam a ferramentas e fontes de dados externas.

Pense no MCP como um "plug universal" entre uma IA e qualquer serviço: em vez de cada integração exigir código personalizado para cada modelo e cada API, o MCP define uma camada de comunicação comum. O modelo sabe como falar com um servidor MCP; o servidor MCP sabe como falar com a API. Você só precisa conectar os dois.

Por ser um protocolo aberto e agnóstico, o MCP é suportado por uma ampla variedade de modelos e ferramentas — incluindo assistentes de IA, IDEs com suporte a agentes, plataformas de automação e SDKs de diferentes provedores.

Por que isso importa para desenvolvedores?

Ao integrar via MCP, você deixa de escrever chamadas REST manualmente para cada endpoint e passa a descrever intenções em linguagem natural. O modelo interpreta a instrução, seleciona a ferramenta certa do servidor MCP e executa a chamada automaticamente.

Exemplos do que isso significa na prática:

  • Em vez de montar a requisição POST /cart com todos os parâmetros de peso, dimensões e CEP, você simplesmente instrui o agente: "Adicione este envio ao carrinho do usuário" — e ele resolve.

  • Em vez de consultar a documentação para lembrar o endpoint de cotação, o agente já sabe qual ferramenta usar e quais campos são obrigatórios.

  • Ciclos de debug de integração que levavam horas passam a ser resolvidos com uma conversa.

Como o MCP Server do Melhor Envio pode ajudar sua integração

Ele expõe as principais operações da API como ferramentas prontas para uso por modelos de IA. Isso traz benefícios concretos em três momentos do desenvolvimento:

1. Durante o desenvolvimento

Use qualquer assistente de IA compatível com MCP conectado ao servidor para explorar a API interativamente.Pergunte sobre endpoints, peça exemplos de payload, gere trechos de código para cotação de frete ou geração de etiquetas — tudo sem sair do seu editor.

2. Na construção de agentes e automações

Se você está construindo um sistema que precisa cotar fretes, comprar etiquetas ou rastrear envios de forma autônoma, o MCP é o caminho mais direto. O agente recebe um contexto (ex.: dados de um pedido) e executa todo o fluxo na API do Melhor Envio sem intervenção manual.

3. Na aceleração de integrações

Equipes que constroem integrações com plataformas de e-commerce, ERPs ou marketplaces podem usar o servidor MCP para prototipar o fluxo completo rapidamente — cotação → carrinho → pagamento → etiqueta — e depois traduzir para o código final da integração.

📘

URL do Servidor MCP

https://docs.melhorenvio.com.br/mcp

  • Este endpoint segue o protocolo MCP padrão (Streamable HTTP) e pode ser conectado a qualquer cliente compatível.

Tutorial: Conectando uma IA ao MCP Server do Melhor Envio

Pré-requisitos

Opção 1 — Aplicativos desktop com suporte a MCP (sem código)

Vários assistentes de IA possuem apps desktop que suportam a configuração de servidores MCP externos via arquivo JSON. O padrão de configuração é amplamente adotado e funciona de forma similar entre os diferentes clientes.

  • Passo 1: Localize o arquivo de configuração do seu cliente MCP. O caminho varia por aplicativo, mas geralmente fica em:

  • macOS: ~/Library/Application Support/<nome-do-app>/config.json

  • Windows: %APPDATA%\<nome-do-app>\config.json

Consulte a documentação do seu cliente para o caminho exato.

  • Passo 2: Adicione o servidor MCP do Melhor Envio na seção mcpServers:

{
  "mcpServers": {
    "melhorenvio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.melhorenvio.com.br/mcp",
        "--header",
        "Authorization: Bearer SEU_TOKEN_AQUI"
      ]
    }
  }
}

Substitua SEU_TOKEN_AQUI pelo seu token OAuth do Melhor Envio.

  • Passo 3: Reinicie o aplicativo. Um indicador de ferramentas ativas deverá aparecer na interface, confirmando que o servidor está conectado.

  • Passo 4: Teste com uma instrução em linguagem natural:

"Qual é o prazo e o preço de frete de São Paulo para Recife para uma caixa de 10x20x30 cm e 1 kg?"

Opção 2 — Copy Page

Utilize este recurso como ponte entre a documentação técnica e os agentes/assistentes de IA, permitindo o fornecimento de contexto da API do Melhor Envio para a IA de forma imediata e sem precisar copiar e colar textos manualmente.

Autenticação

O servidor MCP do Melhor Envio utiliza o mesmo token OAuth da API REST. Inclua o header Authorization: Bearer <token> em todas as requisições ao servidor MCP.

Para obter seu token, siga o fluxo descrito na seção Autenticação desta documentação.

Próximos passos

Com o servidor MCP conectado, você pode explorar o fluxo completo de integração:

Dúvidas? Acesse a Comunidade ou entre em contato com o suporte pelo menu superior.