magalu-mcp-server

suissa/magalu-mcp-server

3.2

If you are the rightful owner of magalu-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP Server for integration with Magalu Marketplace APIs.

Tools
23
Resources
0
Prompts
0

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