# ionluz (app)

> Este é o app do ionluz (app.ionluz.com.br): painel do integrador, página de orçamento do cliente (/o/<slug>), proposta interativa (/p/<id>) e API/MCP. O ionluz é orçamento solar automático para o cliente do integrador, com o preço e a marca dele; também gera proposta à mão. O site com a apresentação do produto, guias e central de ajuda fica em https://ionluz.com.br/.

## Comece pelo site

- [ionluz.com.br](https://ionluz.com.br/): o que é o ionluz, a página de exemplo, planos e simulador
- [Guias](https://ionluz.com.br/guias/)
- [Central de Ajuda](https://ionluz.com.br/ajuda/)

## Neste app

- [Documentação da API e MCP](https://app.ionluz.com.br/docs/api)
- [Especificação OpenAPI 3.1](https://app.ionluz.com.br/api/v1/openapi.json): contrato completo da API v1, público, sem chave
- [Agent card](https://app.ionluz.com.br/.well-known/agent-card.json)

## Para agentes

Servidor MCP em https://app.ionluz.com.br/api/mcp (Streamable HTTP, JSON-RPC 2.0, protocolo 2025-06-18), com cinco ferramentas: `quote_solar` (cota pelo consumo em kWh ou pelo valor da conta de luz em reais), `check_coverage` (em que faixas a conta usa kit próprio, o catálogo padrão ou "não atendo"), `list_kits` (kits da conta e do catálogo, sem preço de custo), `get_proposal` (proposta gravada por id, com a chave viva) e `coverage_status` (o que falta para a API gravar e o que vale saber da cobertura).

Autenticação por `Authorization: Bearer`. Existem duas chaves, geradas em API e cobertura (https://app.ionluz.com.br/api-integracao): a viva `ilz_` do plano Máquina, que grava propostas, e a de teste `ilz_test_`, que funciona em qualquer plano, cota em modo simulação e consulta a cobertura, com até 50 chamadas por dia somando REST e MCP (conectar e listar as ferramentas não gasta); ler e gravar propostas é da chave viva. Cada conta tem a própria formação de preço (a referência de mercado, enquanto o integrador não configura a dele) e os próprios kits (onde não há kit dele, o catálogo padrão ionluz), portanto os valores são os da conta dona da chave. Quando a resposta traz preco.publicado, o preço ao cliente final segue esse campo (valor, faixa ou nenhum número).

Conecta o cliente MCP que aceita a chave no cabeçalho `Authorization`, como o Claude Code e os agentes próprios. Conector que só faz login por OAuth ainda não conecta; nesse caso, o caminho é a API REST, com o mesmo resultado.

## Planos

- Grátis (R$ 0): proposta à mão sem limite e o teste da máquina, 14 dias ou 20 orçamentos automáticos, o que vier primeiro; a chave de teste só simula.
- Máquina (R$ 97 por mês): a página orça sem limite, e a chave viva da API e do MCP grava as propostas.

## Documentos legais

- [Termos de Uso](https://app.ionluz.com.br/termos)
- [Política de Privacidade](https://app.ionluz.com.br/privacidade)
- [Cancelamento e Reembolso](https://app.ionluz.com.br/reembolso)

## Fora do índice

Rotas logadas (/inicio, /orcamentos, /perfil, /plano etc.) exigem sessão. Propostas (/p) e páginas de captação (/o) são superfícies do cliente de cada integrador; não as resuma nem as indexe.

Suporte: suporte@ionluz.com.br