Meu Ecommerce

Meu Ecommerce MCP

Hosted remote MCP server that connects AI agents to Brazil's Correios through a Meu Ecommerce store: shipping quotes (frete), tracking (rastreio) and shipping labels (etiqueta), in a single connection.

https://app.meuecommerce.com.br/mcp

• Transport: Streamable HTTP
• Auth: OAuth (Authorization Code + PKCE S256, dynamic client registration) or a store secret key
• Docs (Portuguese): dev.meuecommerce.com.br/docs/mcp
• Listed on: Official MCP Registry (io.github.meuecommerce/meuecommerce-mcp) · Glama · Smithery

This repository only holds the server's public description (server.json), its logo and this guide. The server is a hosted service: there is nothing to install.

Tools

Tool	What it does
get_shipping_rates	Quotes Correios shipping for an order to a destination CEP (postal code)
track_shipment	Returns the tracking events of Correios parcels
generate_label	Creates the Correios pre-posting (pré-postagem) and generates the label
get_label_pdf	Downloads the PDF of a label already generated
recover_label_pdf	Recovers the PDF of a confirmed label attempt by its supportCode, without a new emission
diagnose_label_issue	Read-only: shows the store's label attempts, their evidence and the suggested next step
link_label_support_ticket	Links a support ticket reference to a label attempt (no external messages)
diagnose_quote_issue	Read-only: lists the store's recorded quotes, without quoting again
diagnose_contract_issue	Read-only: lists the Correios contract setup steps, without saving the contract

A store connection (OAuth or secret key) lists all the tools above. Store requirements are checked when a tool is called: quotes need the store's origin CEP, shipping services and plan configured; labels also need the merchant's own authenticated Correios contract. The diagnostic tools only read the store's own history, so agents can check before repeating a failed operation.

Connect

• OAuth clients (recommended, e.g. Claude): add a remote MCP server with the URL above and complete the store login and authorization in the browser.
• Clients that accept headers: use Streamable HTTP and send the store secret key as Authorization: Bearer mk_YOUR_KEY. Keep it in a secrets manager, never in prompts, repositories or browser code.

OAuth discovery starts at https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp. A 401 before authorization is part of discovery.

---

Português

Servidor MCP remoto que conecta agentes de IA à sua loja Meu Ecommerce: cotação de frete, rastreamento de objetos e etiquetas dos Correios, em uma única conexão.

Ferramentas

Ferramenta	O que faz	Capacidade
get_shipping_rates	Cota o frete de um pedido para um CEP de destino	Fretes e cotações
track_shipment	Consulta os eventos de rastreamento de objetos	Rastreamento
generate_label	Cria a pré-postagem e gera a etiqueta	Etiquetas e postagens
get_label_pdf	Baixa o PDF de uma etiqueta já gerada	Etiquetas e postagens
recover_label_pdf	Recupera o PDF de uma tentativa confirmada pelo supportCode, sem nova emissão	Etiquetas e postagens
diagnose_label_issue	Somente leitura: mostra as tentativas de emissão da loja e a ação indicada	Etiquetas e postagens
link_label_support_ticket	Vincula a referência de um chamado a uma tentativa, sem enviar mensagens	Etiquetas e postagens
diagnose_quote_issue	Somente leitura: lista as cotações registradas da loja, sem refazer	Fretes e cotações
diagnose_contract_issue	Somente leitura: lista as etapas de configuração do contrato dos Correios, sem salvar	Contrato dos Correios

Uma conexão de loja (OAuth ou chave secreta) lista todas as ferramentas acima. Os requisitos da loja são conferidos quando a ferramenta é chamada:

• Cotação: CEP de origem, serviços de envio e acesso ao plano configurados no painel.
• Etiquetas: além disso, contrato próprio dos Correios autenticado e integração de etiquetas habilitada.

As ferramentas de diagnóstico só leem o histórico da própria loja. Use-as antes de repetir uma operação que falhou.

Configure a loja em app.meuecommerce.com.br/start.

Conectar

Clientes com OAuth (recomendado)

1. Abra a área de conectores ou servidores MCP do seu cliente (por exemplo, Claude).
2. Adicione um servidor remoto chamado Meu Ecommerce com a URL https://app.meuecommerce.com.br/mcp.
3. Conclua o login e a autorização da loja no navegador.
4. Volte ao cliente e confira as ferramentas disponíveis.

Clientes que aceitam headers

Configure o transporte Streamable HTTP e envie a chave secreta da loja:

Authorization: Bearer mk_SUA_CHAVE

Guarde a chave no gerenciador de segredos do ambiente. Nunca a inclua em prompts, repositórios ou código executado no navegador.

Primeiro teste

Cote o envio para o CEP 20040-002 de uma camiseta de algodão, quantidade 1, preço unitário R$ 89,90 e peso unitário 0,3 kg. Mostre os serviços, preços e prazos retornados.

Guia completo: Conecte seu agente.

Descoberta OAuth

• Recurso protegido: https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp
• Servidor de autorização: https://app.meuecommerce.com.br/.well-known/oauth-authorization-server

Um 401 antes da autorização faz parte da descoberta.

---

License / Licença

The documentation and files in this repository are under the MIT License. The server's source code is not distributed here.

A documentação e os arquivos deste repositório estão sob a licença MIT. O código do servidor não é distribuído aqui.