Meu Ecommerce
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent 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.
Questions fréquentes
Qu'est-ce que Meu Ecommerce ?
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
Comment installer Meu Ecommerce ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http meu-ecommerce 'https://app.meuecommerce.com.br/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Meu Ecommerce ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Meu Ecommerce est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Meu Ecommerce ?
Il est publié par meuecommerce. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.