Meu Ecommerce
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http meu-ecommerce 'https://app.meuecommerce.com.br/mcp'{
"mcpServers": {
"meu-ecommerce": {
"type": "http",
"url": "https://app.meuecommerce.com.br/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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)
- 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_CHAVEGuarde 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.
Frequently asked questions
What is Meu Ecommerce?
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
How do I install Meu Ecommerce?
It runs as a remote server. In Claude Code: claude mcp add --transport http meu-ecommerce 'https://app.meuecommerce.com.br/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Meu Ecommerce need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Meu Ecommerce open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Meu Ecommerce?
It is published by meuecommerce. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.