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 |
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 |
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)
- Abra a área de conectores ou servidores MCP do seu cliente (por exemplo, Claude).
- Adicione um servidor remoto chamado Meu Ecommerce com a URL
https://app.meuecommerce.com.br/mcp. - Conclua o login e a autorização da loja no navegador.
- 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.