HoyaLab MCP Server

Servidor MCP que conecta agentes de IA ao sistema de pedidos da Hoya Brasil. Permite autenticar como laboratório, consultar produtos e criar pedidos diretamente pelo agente, sem acessar o portal manualmente.

Variáveis de Ambiente

| Variável | Obrigatória | Descrição | |---|---|---| | HOYALAB_MASTER_KEY | Sim | Chave mestra fornecida pela Hoya Brasil | | HOYALAB_ENV | Não | prod ou homolog (padrão: homolog) |

Para obter sua chave, entre em contato com seu consultor Hoya.

Como usar em um projeto Node.js

1. Instale o SDK MCP:

npm install @modelcontextprotocol/sdk

2. Conecte ao servidor MCP via stdio:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', 'hoyalabmcp'],
  env: {
    HOYALAB_MASTER_KEY: process.env.HOYALAB_MASTER_KEY,
    HOYALAB_ENV: process.env.HOYALAB_ENV,
  },
});

const client = new Client({ name: 'meu-app', version: '1.0.0' });
await client.connect(transport);

3. Chame as ferramentas:

// Autenticar o laboratório
await client.callTool({ name: 'authenticate', arguments: { telefone: '...', codigoCliente: '...' } });

// Buscar produtos
const resultado = await client.callTool({ name: 'search_products_mcp', arguments: { texto: 'transitions 1.67' } });

Configuração em agentes de IA

Claude Desktop

{
  "mcpServers": {
    "hoyalab": {
      "command": "npx",
      "args": ["-y", "hoyalabmcp"],
      "env": {
        "HOYALAB_MASTER_KEY": "SUA_CHAVE_MESTRA_AQUI",
        "HOYALAB_ENV": "homolog"
      }
    }
  }
}

Ferramentas Disponíveis

Autenticação

| Ferramenta | O que faz | |---|---| | authenticate | Autentica o laboratório (Telefone + Código do Cliente) |

Catálogo de Produtos

| Ferramenta | O que faz | |---|---| | list_products | Lista todos os produtos disponíveis | | search_products_mcp | Busca produtos por descrição ou atributos | | get_product | Detalhes completos de um produto | | get_colors | Cores disponíveis por material e tratamento | | get_materials | Catálogo de materiais | | get_treatments | Catálogo de tratamentos | | list_designs | Catálogo de desenhos | | list_heights | Catálogo de alturas | | list_frame_types | Tipos de armação | | list_photosensitive_types | Tipos de lente fotossensível |

Pedidos

| Ferramenta | O que faz | |---|---| | create_order | Cria um pedido na HoyaLab | | get_order | Consulta um pedido pelo número | | track_order | Rastreia pedidos por data/status | | get_order_xml | XML fiscal do pedido |

Pagamento e Medidas

| Ferramenta | O que faz | |---|---| | get_payment_conditions | Condições de pagamento do cliente | | get_visureal_measure | Medidas do sistema VisuReal |

© 2026 HOYA Brasil