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
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.
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
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
- 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.
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.