Meu Ecommerce
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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.
الأسئلة الشائعة
ما هو Meu Ecommerce؟
Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).
كيف أثبّت Meu Ecommerce؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http meu-ecommerce 'https://app.meuecommerce.com.br/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Meu Ecommerce إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Meu Ecommerce مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Meu Ecommerce؟
ينشره meuecommerce. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.