Magalu MCP Server

MCP服务器-Magalu市场

用于与Magalu Marketplace API集成的模型上下文协议（MCP）服务器。

功能

此服务器可访问以下 Magalu API：

📦 产品组合（Portfolio）

• 列出、创建和更新 SKU
• 管理产品价格
• 库存控制
• 查看优化分数

📋 订单

• 列出和查看订单
• 管理交付
• 查看税务报表

🎫 战略空军司令部

• 列出和管理服务票

❓ 问题和答案

• 列出客户问题
• 回答有关产品的问题

💬 与客户聊天

• 管理对话
• 发送消息

安装

cd Magalu/mcp-server
npm install
npm run build

配置

设置环境变量 ：

export MAGALU_API_KEY="sua_api_key"
export MAGALU_SELLER_ID="seu_seller_id"
export MAGALU_ENV="sandbox"  # ou "production"

与 Kiro 一起使用

添加到您的文件 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "magalu": {
      "command": "node",
      "args": ["C:/caminho/para/Magalu/mcp-server/dist/index.js"],
      "env": {
        "MAGALU_API_KEY": "sua_api_key",
        "MAGALU_SELLER_ID": "seu_seller_id",
        "MAGALU_ENV": "sandbox"
      }
    }
  }
}

可用工具

产品

• list_skus - 产品组合SKU列表
• get_sku - 获取SKU的详细信息
• create_sku 创建新 SKU
• update_sku 更新现有SKU
• get_sku_price - 查询价格
• update_sku_price - 价格更新
• get_sku_stock - 查询库存
• update_sku_stock - 更新库存
• get_sku_score - 查询优化分数

订单

• list_orders - 订单列表
• get_order - 获取订单详情
• get_order_delivery -咨询交付
• update_order_delivery - 更新交付
• get_order_invoice -税务咨询说明

战略空军司令部

• list_tickets -Lista门票
• get_ticket 获取门票详情
• update_ticket 更新门票

问题

• list_questions - 问题清单
• get_question - 获取问题详情
• answer_question - 回答问题

聊天

• list_conversations - 对话列表
• get_conversation - 获取对话详细信息
• send_message - 发送消息

埃斯科波斯OAuth2

要使用 API，您需要以下范围：

产品

• open:portfolio-skus-seller:read
• open:portfolio-skus-seller:write
• open:portfolio-prices-seller:read
• open:portfolio-prices-seller:write
• open:portfolio-stocks-seller:read
• open:portfolio-stocks-seller:write
• open:portfolio-scores-seller:read

订单

• open:order-order-seller:read
• open:order-delivery-seller:read
• open:order-delivery-seller:write
• open:order-logistics-seller:read
• open:order-logistics-seller:write
• open:order-invoice-seller:read

官方文件

欲了解更多信息，请参阅 Magalu官方文件.

许可证

麻省理工学院