HoyaLab MCP Server

Este servidor implementa o Model Context Protocol (MCP) para consumir os serviços da API HoyaLab.

Funcionalidades

• Pedidos: Consultar detalhes, rastrear e obter XML de notas fiscais.
• Produtos: Listar produtos, consultar por SKU/Código e listar categorias (armações, desenhos, alturas, etc).
• Pagamentos: Consultar condições de pagamento.

Configuração

1. Obtenha sua x-api-key no portal HoyaLab.
2. Defina a variável de ambiente HOYALAB_API_KEY.

Como Rodar

Desenvolvimento

npm install
npm run dev

Produção

npm run build
npm start

Uso no Claude Desktop / Outros Clientes MCP

Adicione a seguinte configuração ao seu arquivo mcp_config.json:

{
  "mcpServers": {
    "hoyalab": {
      "command": "node",
      "args": ["C:/Git/HoyalabMCP/build/index.js"],
      "env": {
        "HOYALAB_API_KEY": "SUA_API_KEY_AQUI",
        "HOYALAB_ENV": "prod" 
      },
    }
  }
}

Ambientes Disponíveis

Você pode alternar entre os ambientes usando a variável HOYALAB_ENV:

• prod: (Padrão) URL de produção https://hoyalab.com.br/api/customer
• homolog: URL de homologação https://tst.hoyalabhomologa.com.br/api/customer

Ferramentas Disponíveis

• get_order: Busca detalhes de um pedido.
• track_order: Rastreamento de pedidos.
• get_order_xml: Obtém o XML da nota fiscal.
• list_products: Lista todos os produtos.
• get_product: Detalhes de um produto específico.
• list_frame_types: Lista tipos de armação.
• list_designs: Lista desenhos disponíveis.
• list_heights: Lista alturas disponíveis.
• list_photosensitive_types: Lista tipos fotossensíveis.
• get_materials: Lista materiais.
• get_treatments: Lista tratamentos.
• get_payment_conditions: Consulta condições de pagamento.