MCP Server - Magalu Marketplace

Servidor MCP (Model Context Protocol) para integração com as APIs do Magalu Marketplace.

Funcionalidades

Este servidor fornece acesso às seguintes APIs do Magalu:

📦 Produtos (Portfolio)

• Listar, criar e atualizar SKUs
• Gerenciar preços de produtos
• Controlar estoque
• Consultar scores de otimização

📋 Pedidos

• Listar e consultar pedidos
• Gerenciar entregas
• Consultar notas fiscais

🎫 SAC

• Listar e gerenciar tickets de atendimento

❓ Perguntas & Respostas

• Listar perguntas de clientes
• Responder perguntas sobre produtos

💬 Chat com Cliente

• Gerenciar conversas
• Enviar mensagens

Instalação

cd Magalu/mcp-server
npm install
npm run build

Configuração

Configure as variáveis de ambiente:

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

Uso com Kiro

Adicione ao seu arquivo .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"
      }
    }
  }
}

Ferramentas Disponíveis

Produtos

• list_skus - Lista SKUs do portfólio
• get_sku - Obtém detalhes de um SKU
• create_sku - Cria novo SKU
• update_sku - Atualiza SKU existente
• get_sku_price - Consulta preço
• update_sku_price - Atualiza preço
• get_sku_stock - Consulta estoque
• update_sku_stock - Atualiza estoque
• get_sku_score - Consulta score de otimização

Pedidos

• list_orders - Lista pedidos
• get_order - Obtém detalhes de pedido
• get_order_delivery - Consulta entrega
• update_order_delivery - Atualiza entrega
• get_order_invoice - Consulta nota fiscal

SAC

• list_tickets - Lista tickets
• get_ticket - Obtém detalhes de ticket
• update_ticket - Atualiza ticket

Perguntas

• list_questions - Lista perguntas
• get_question - Obtém detalhes de pergunta
• answer_question - Responde pergunta

Chat

• list_conversations - Lista conversas
• get_conversation - Obtém detalhes de conversa
• send_message - Envia mensagem

Escopos OAuth2

Para usar as APIs, você precisa dos seguintes escopos:

Produtos

• 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

Pedidos

• 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

Documentação Oficial

Para mais informações, consulte a documentação oficial do Magalu.

Licença

MIT