Agente de IA que cota energia solar: o servidor MCP do ionluz
Ligue o seu assistente ao servidor MCP e ele passa a orçar sistemas fotovoltaicos com a sua tabela de preço, dentro da conversa. Você pergunta em português, ele chama a ferramenta e devolve potência, valor e payback.
O que é MCP
Um protocolo para o agente usar as suas ferramentas
MCP é a sigla de Model Context Protocol. Ele padroniza como um agente de IA descobre ferramentas externas, entende o que cada uma recebe e chama a que precisa. O servidor do ionluz publica 5 ferramentas e o agente as encontra sozinho assim que conecta.
quote_solar
Recebe o consumo em kWh e devolve potência, valor, payback, economia do primeiro mês e em 25 anos e quanto do consumo o sistema cobre, com a sua formação de preço. Respeita o seu raio de atendimento e mostra o deslocamento em linha própria. Por padrão só simula; com persist true e consent true, grava a proposta e devolve os links. Nas contas com três opções, aceita opcao (economica, recomendada ou bateria) para gravar a escolhida, e a resposta diz como o preço é publicado.
check_coverage
Mostra quais faixas de potência têm kit seu e quais você marcou como “não atendo”. Faixa sem kit seu cota com o catálogo padrão; só a “não atendo” recusa o pedido.
list_kits
Os kits que a sua conta pode usar, os seus e os do catálogo, com potência, módulos, ligações e se entram na cotação. Sem preço: quem cota é o quote_solar.
get_proposal
Recupera uma proposta já gravada da sua conta pelo id, com os números e os links do PDF e da página do cliente. Só com a chave viva.
coverage_status
Diz em português o que falta para a API gravar propostas (plano e chave) e o que vale saber da cobertura e do modo de preço. Serve para quando a cotação volta faixa-nao-atendida, fora-da-area ou sem-preco-configurado.
Criou a conta, você já gera uma chave de teste em qualquer plano, com 50 chamadas por dia, para cotar em preview pela API REST e pelo MCP. Conectar e listar as ferramentas não gasta a cota.
Configuração
Conectar leva um bloco de configuração
Gere a chave no painel, em API e cobertura. O servidor autentica pela chave no cabeçalho Authorization. Em clientes com arquivo de configuração, é este bloco:
{
"mcpServers": {
"ionluz": {
"url": "https://app.ionluz.com.br/api/mcp",
"headers": { "Authorization": "Bearer ilz_sua_chave" }
}
}
}No Claude Code, é um comando, com a chave no cabeçalho. Depois é pedir a cotação em português:
claude mcp add --transport http ionluz https://app.ionluz.com.br/api/mcp \
--header "Authorization: Bearer ilz_sua_chave"No seu próprio agente
Qualquer cliente MCP que aceite servidor remoto com cabeçalho serve. A descoberta de ferramentas é padrão, então o agente lê os parâmetros de quote_solar sem você escrever esquema nenhum.
Conector só com login
Conectores que só fazem login por OAuth ainda não conectam: o servidor aceita a chave no cabeçalho. Use a API REST, com o mesmo resultado.
Na prática
Como fica a conversa
Você: um cliente de Campinas gastou 780 kWh no mês passado,
ligação bifásica. Monta o orçamento e me diz o payback.
Agente: [chama quote_solar com consumoKwhMes 780, uf SP, cidade Campinas, fases bi]
Sistema de 5,72 kWp por R$ 14.297, cobre 97% do consumo.
Economia de R$ 617 no primeiro mês e payback em 1,9 ano.
Quer que eu grave a proposta e gere o link para mandar?
Você: grava, o cliente autorizou o contato.
Agente: [chama quote_solar de novo, com persist true e consent true]
Proposta gravada. Link do PDF pronto para enviar.Números de uma conta que ainda cota pela referência de mercado. Com a sua formação de preço, o valor e o payback mudam; a tarifa e a irradiação são as da região do cliente. Nas contas em que a empresa aprova o valor antes ou apresenta o preço no contato, o agente não fala número: diz que a empresa confirma o valor.
Antes de assinar
Teste com a chave de teste, em modo preview
Crie a conta grátis, gere a chave de teste em API e cobertura e conecte o agente: ele cota em preview com a sua tabela (a referência de mercado, até você salvar a sua), sem gravar nada. Quer ver antes de criar a conta? A demonstração ao vivo da API cota com a tabela de uma conta de demonstração. Quando a resposta estiver do jeito que você vende, assine o plano Máquina e troque pela chave viva.
Perguntas frequentes
O que é MCP?
MCP significa Model Context Protocol: um jeito padronizado de um agente de IA descobrir e usar ferramentas de sistemas externos. Em vez de você colar dados na conversa, o agente chama a ferramenta e recebe a resposta estruturada.
Quais ferramentas o servidor do ionluz oferece?
Cinco, e o agente descobre todas sozinho ao conectar: quote_solar: recebe o consumo em kWh e devolve potência, valor, payback, economia do primeiro mês e em 25 anos e quanto do consumo o sistema cobre, com a sua formação de preço; check_coverage: mostra quais faixas de potência têm kit seu e quais você marcou como “não atendo”; list_kits: os kits que a sua conta pode usar, os seus e os do catálogo, com potência, módulos, ligações e se entram na cotação; get_proposal: recupera uma proposta já gravada da sua conta pelo id, com os números e os links do PDF e da página do cliente; coverage_status: diz em português o que falta para a API gravar propostas (plano e chave) e o que vale saber da cobertura e do modo de preço.
Como conecto o meu assistente?
Com a chave no cabeçalho Authorization: Bearer. Em clientes que aceitam servidor MCP remoto com cabeçalho, é só colar o bloco de configuração acima; no Claude Code, é o comando claude mcp add com --header. Conectores que só fazem login por OAuth ainda não conectam: use a API REST, com o mesmo resultado.
Dá para testar sem gravar proposta?
Dá. Peça ao agente para cotar em modo preview: a conta roda e a resposta volta sem criar lead nem proposta. Com a chave de teste (ilz_test_), tudo roda em preview. É o modo indicado para simular vários cenários com o cliente na frente.
Tem limite de chamadas?
O servidor aceita 120 mensagens por minuto por conta e 300 por endereço de origem, e as cotações contam no mesmo limite da API, 60 por minuto. Com a chave de teste, as 50 do dia somam as chamadas de ferramenta e as da API REST; conectar e listar as ferramentas não gasta.
Em qual plano está o MCP?
A chave de teste, de qualquer plano, já conecta o agente e cota em modo preview. A chave viva, que grava propostas e lê as gravadas, é do plano Máquina, R$ 97 por mês.
Coloque o seu agente para cotar
Conta grátis e chave de teste para conectar hoje; R$ 97 por mês quando a chave for para produção.