Meu Ecommerce

io.github.meuecommercev1.0.1更新于 Oct 7, 2026

Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).

已验证Streamable HTTP可网页运行Business & CommerceProductivity & Workflow

概览

AI 生成的概览

将助手连接到 Meu Ecommerce 店铺,用于 Correios 运费报价、包裹追踪和面单。

功能
这是一个托管的远程 MCP 服务器,把 AI 助手连接到 Meu Ecommerce 店铺和巴西 Correios。它提供工具:按目的地邮政编码为订单报价运费、返回包裹的追踪事件、创建 Correios 预投递并生成面单,以及下载已生成面单的 PDF。可用工具取决于店铺的凭据和配置。
适用场景
适合已经使用 Meu Ecommerce 店铺的巴西商家或客服团队,希望助手在聊天客户端内回答运费和时效问题、查询包裹追踪,或生成并获取 Correios 面单。
运行要求
远程 Streamable HTTP 端点,无需本地安装。认证方式为 OAuth(Authorization Code + PKCE S256,支持动态客户端注册)或通过 Authorization Bearer 请求头发送店铺密钥。运费报价需要配置店铺的发货地邮政编码、配送服务和套餐;面单还需要商家自己已认证的 Correios 合同并启用面单集成。
安装前请注意
店铺密钥属于凭据:应保存在密钥管理器中,不要放入提示词、代码仓库或浏览器代码。生成面单会创建真实的 Correios 预投递,可能产生运费或与 Correios 的合同义务。连接并不解锁全部操作,工具可用性取决于店铺配置。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Meu Ecommerce,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "meuecommerce-mcp": {
      "type": "http",
      "url": "https://app.meuecommerce.com.br/mcp"
    }
  }
}

README

[Meu Ecommerce]

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.

text
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

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

ToolWhat it does
get_shipping_ratesQuotes Correios shipping for an order to a destination CEP (postal code)
track_shipmentReturns the tracking events of Correios parcels
generate_labelCreates the Correios pre-posting (pré-postagem) and generates the label
get_label_pdfDownloads the PDF of a label already generated

Available tools depend on the store's credentials and setup. Connecting does not unlock every operation: quotes need the store's origin CEP, shipping services and plan configured; labels also need the merchant's own authenticated Correios contract.

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

FerramentaO que fazCapacidade
get_shipping_ratesCota o frete de um pedido para um CEP de destinoFretes e cotações
track_shipmentConsulta os eventos de rastreamento de objetosRastreamento
generate_labelCria a pré-postagem e gera a etiquetaEtiquetas e postagens
get_label_pdfBaixa o PDF de uma etiqueta já geradaEtiquetas e postagens

As ferramentas disponíveis dependem da credencial e da configuração da loja. Conectar o MCP não libera todas as operações:

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

Configure a loja em app.meuecommerce.com.br/start.

Conectar

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

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

来源:README.md,提交 337400f

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.1最新Oct 7, 2026