关于 Meu Ecommerce
Meu Ecommerce 是托管的远程 MCP 服务,通过 Meu Ecommerce 店铺将 AI Agent 接入 Correios。它整合运费报价、包裹追踪、面单生成和只读诊断,并支持 OAuth 或店铺密钥认证。
主要功能
- 01查询 Correios 运费
- 02追踪包裹事件
- 03生成面单并获取 PDF
- 04诊断报价、面单和合同问题
- 05关联面单尝试与支持工单编号
适用场景
- 01比较订单的配送选项
- 02查看包裹的追踪事件
- 03创建面单或找回面单 PDF
- 04检查失败的报价或面单操作
MCP 相关
通过 Streamable HTTP 向 MCP 客户端提供 Correios 配送及店铺诊断工具。可使用 OAuth 连接,或通过店铺密钥认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://app.meuecommerce.com.br/mcpclaude mcp add --transport http meuecommerce-meuecommerce https://app.meuecommerce.com.br/mcp{"mcpServers":{"meuecommerce-meuecommerce":{"type":"http","url":"https://app.meuecommerce.com.br/mcp"}}}在 Cursor 中打开{"servers":{"meuecommerce-meuecommerce":{"type":"http","url":"https://app.meuecommerce.com.br/mcp"}}}在 VS Code 中打开{"mcpServers":{"meuecommerce-meuecommerce":{"type":"http","url":"https://app.meuecommerce.com.br/mcp"}}}{"mcpServers":{"meuecommerce-meuecommerce":{"serverUrl":"https://app.meuecommerce.com.br/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Meu Ecommerce MCP
托管的远程 MCP 服务,通过 Meu Ecommerce 商店将 AI Agent 连接到巴西 Correios,提供运费报价(frete)、物流跟踪(rastreio)和运输标签(etiqueta),只需一次连接即可使用。
https://app.meuecommerce.com.br/mcp
- 传输方式: Streamable HTTP
- 身份验证: OAuth(Authorization Code + PKCE S256、动态客户端注册)或商店密钥
- 文档(葡萄牙语): dev.meuecommerce.com.br/docs/mcp
- 已列入: 官方 MCP 注册表(
io.github.meuecommerce/meuecommerce-mcp)· Glama · Smithery
此代码仓库仅包含该服务的公开说明(server.json)、徽标和本指南。该服务为托管服务,无需安装任何内容。
工具
| 工具 | 功能 |
|---|---|
get_shipping_rates | 查询 Correios 将订单寄送到目的地 CEP(邮政编码)的运费 |
track_shipment | 返回 Correios 包裹的物流跟踪事件 |
generate_label | 创建 Correios 预寄件(pré-postagem)并生成标签 |
get_label_pdf | 下载已生成标签的 PDF |
recover_label_pdf | 根据 supportCode 恢复已确认标签操作的 PDF,不会重新生成标签 |
diagnose_label_issue | 只读:显示商店的标签操作记录、相关证据和建议的后续步骤 |
link_label_support_ticket | 将支持工单引用关联到标签操作(不会发送外部消息) |
diagnose_quote_issue | 只读:列出商店记录的报价,不会再次查询运费 |
diagnose_contract_issue | 只读:列出 Correios 合同设置步骤,不会保存合同 |
商店连接(OAuth 或密钥)会列出以上所有工具。调用工具时会检查商店要求:查询报价需要配置商店的始发地 CEP、运输服务和套餐;生成标签还需要商家自己的 Correios 合同已完成身份验证。诊断工具只读取商店自身的历史记录,因此 Agent 可以在重试失败操作前进行检查。
连接
- OAuth 客户端(推荐,例如 Claude): 添加远程 MCP 服务,使用上方的 URL,然后在浏览器中完成商店登录和授权。
- 支持请求头的客户端: 使用 Streamable HTTP,并将商店密钥作为
Authorization: Bearer mk_YOUR_KEY发送。请将其保存在密钥管理器中,切勿放入提示词、代码仓库或浏览器代码。
OAuth 发现从 https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp 开始。授权前出现 401 属于发现流程的一部分。
葡萄牙语
远程 MCP 服务,可通过 Meu Ecommerce 商店将 AI Agent 连接到巴西 Correios,提供运费报价、包裹跟踪和 Correios 标签,只需一次连接即可使用。
工具
| 工具 | 功能 | 能力 |
|---|---|---|
get_shipping_rates | 计算订单寄往目标邮政编码的运费 | 运费与报价 |
track_shipment | 查询包裹的物流跟踪事件 | 物流跟踪 |
generate_label | 创建预寄件并生成标签 | 标签与寄件 |
get_label_pdf | 下载已生成标签的 PDF | 标签与寄件 |
recover_label_pdf | 根据 supportCode 获取已确认尝试的 PDF,不会重新签发 | 标签与寄件 |
diagnose_label_issue | 只读:显示店铺的签发尝试记录和建议操作 | 标签与寄件 |
link_label_support_ticket | 将工单引用关联到一次尝试,不会发送消息 | 标签与寄件 |
diagnose_quote_issue | 只读:列出店铺已记录的报价,不会重新计算 | 运费与报价 |
diagnose_contract_issue | 只读:列出 Correios 合同的配置步骤,不会保存 | Correios 合同 |
店铺连接(OAuth 或密钥)会列出以上所有工具。调用工具时会检查店铺要求:
- **报价:**已在控制面板中配置寄件邮政编码、配送服务和套餐访问权限。
- **标签:**此外,还需验证自有 Correios 合同,并启用标签集成。
诊断工具只读取本店铺的历史记录。操作失败后,请先使用这些工具,再重试。
在 app.meuecommerce.com.br/start 配置店铺。
连接
使用 OAuth 的客户端(推荐)
- 打开客户端(例如 Claude)的连接器或 MCP 服务区域。
- 添加名为 Meu Ecommerce 的远程服务,URL 为
https://app.meuecommerce.com.br/mcp。 - 在浏览器中完成店铺登录和授权。
- 返回客户端并检查可用工具。
支持 headers 的客户端
配置 Streamable HTTP 传输,并发送店铺密钥:
Authorization: Bearer mk_SUA_CHAVE
将密钥保存在环境的密钥管理器中。切勿将其写入提示词、代码仓库或在浏览器中运行的代码。
首次测试
请计算一件寄往邮政编码 20040-002 的棉质 T 恤的运费,数量为 1,单价 R$ 89,90,单件重量为 0,3 kg。请展示返回的服务、价格和时效。
完整指南:连接你的 Agent。
OAuth 发现
- 受保护资源:
https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp - 授权服务:
https://app.meuecommerce.com.br/.well-known/oauth-authorization-server
授权前出现 401 属于发现流程的一部分。
许可证 / Licença
此代码仓库中的文档和文件遵循 MIT 许可证。此处不分发服务的源代码。
本仓库中的文档和文件遵循 MIT 许可证。此处不分发服务的源代码。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。