Conectar seu Assistente de IA (MCP)

O MCP (Model Context Protocol) é um protocolo aberto que permite conectar assistentes de IA externos — como Claude, Claude Code e Cursor — diretamente aos dados das suas Aplicações no Lumo. Você conecta uma vez e passa a perguntar sobre os seus indicadores sem sair da ferramenta que já usa no dia a dia.

Há dois jeitos de conectar, e você não precisa escolher: cole o endereço e autorize com um clique (no Claude para aplicativo e site), ou gere um token pessoal (no Claude Code e no Cursor, que pedem token). Os dois dão exatamente o mesmo acesso.

O acesso fica no card Use no MCP, dentro do módulo Agentes de IA.

Recurso em beta

Disponível mediante habilitação pelo administrador do tenant.

O que o assistente enxerga

O assistente conectado vê exatamente o que você vê — nada mais:

Só as Aplicações que você tem acesso.
Só as colunas liberadas para IA em cada Aplicação.

Toda consulta que ele executa retorna um permalink: um link para o relatório correspondente no Lumo. É a mesma consulta, aberta como relatório de verdade — dá pra conferir os números, não só confiar na resposta em texto do assistente.

O que o assistente consegue fazer

O acesso é somente leitura — o assistente nunca grava, edita ou apaga nada nos seus dados. Com o MCP conectado, ele pode:

listar as Aplicações que você tem acesso;
consultar os indicadores curados (fatos) de cada Aplicação;
explorar colunas e valores — por exemplo, resolver "cliente acme" para o nome exato cadastrado;
executar consultas agregadas, com filtros.

NOTE

Existem limites de uso por minuto (por usuário e por tenant). Se o seu assistente parar de responder consultas com um erro de limite, espere um minuto e tente de novo.

O assistente não inventa números

Assim como o Chat com Dados, o MCP sempre executa uma consulta real para responder — os números que o assistente relata vêm do banco, não de estimativa. O que o assistente pode errar é a interpretação da pergunta, não o dado em si. Na dúvida, abra o permalink do relatório.

Agentes prontos

Os Agentes de IA que você configura no Lumo aparecem no seu assistente externo como prompts prontos (o que Claude, Cursor e afins chamam de "skills" ou "prompts"). Cada agente carrega a persona que você definiu — o "como investigar" e o "como responder" — e o assistente passa a usar essa orientação junto das ferramentas somente-leitura.

Na prática: no seu assistente, escolha o prompt com o nome do agente e faça a pergunta. Ele responde com a persona daquele agente, consultando os seus dados. Há sempre um prompt padrão ("data analyst") disponível, mesmo que você ainda não tenha criado nenhum agente.

NOTE

Você só vê os agentes que já veria logado no Lumo — os que abrangem Aplicações a que você tem acesso.

Como ativar

Acesse Agentes de IA no menu lateral.
Clique no card "Use no MCP" — ou, dentro do chat, no atalho de plugue no cabeçalho da conversa.
Na página que abre estão o endereço do servidor (para conectar com 1 clique) e o botão para gerar um token (para os assistentes que pedem token).

A página mostra o endereço do servidor MCP — algo como https://dataviz.horusbi.com.br/mcp. É esse endereço que você cola no assistente.

TIP

Em ambientes whitelabel o endereço usa o domínio da sua empresa. Sempre copie o valor exibido na sua tela, não o exemplo desta página.

Conectar com 1 clique (OAuth)

No Claude para aplicativo e site, não é preciso gerar nem colar token: você cola o endereço e autoriza no navegador, como faz ao entrar com Google num site qualquer.

No Claude, vá em Settings → Connectors → Add custom connector.
Cole o endereço do servidor MCP copiado da página Use no MCP.
O Claude abre a tela de autorização no seu próprio domínio, com a identidade visual da sua empresa.
Se você ainda não estiver logado, faça login normalmente. Depois escolha o ambiente que quer autorizar — se você tem acesso a mais de um, todos aparecem na lista, com o da sua sessão já selecionado — e clique em Autorizar.

Pronto. O Claude volta conectado, e o acesso é somente leitura.

Alguns pontos que valem saber:

A autorização vale para um ambiente por vez. Para conectar outro, repita o processo — o Claude trata cada um como um conector separado.
A conexão se renova sozinha: não há token para expirar na sua mão.
Você pode desconectar a qualquer momento pelo próprio Claude.
A autorização é pessoal e herda exatamente as suas permissões — o assistente não passa a enxergar nada que você já não enxergasse logado no Lumo.

Gerando e gerenciando seu token

O Claude Code e o Cursor pedem um token em vez de abrir o navegador — é para eles que esta seção serve. Quem usa o Claude para aplicativo ou site pode pular direto para o passo anterior.

O token é pessoal: vale para o usuário que o criou e herda exatamente as permissões dele (as mesmas Aplicações e colunas que você já enxerga no Lumo).

Dê um nome livre que ajude a identificar onde ele foi usado (ex.: "Claude Desktop", "Meu Cursor").
O token aparece uma única vez, no momento em que é gerado — copie antes de sair da tela, porque ele não é mostrado de novo.
É possível revogar a qualquer momento, na mesma página. A revogação corta o acesso na hora.

Conectando seu assistente

Há dois jeitos de conectar, e cada assistente usa um deles. Comece pela tabela para achar o seu:

Assistente	1 clique	Token
Claude (aplicativo e site)	✅	—
ChatGPT	✅	—
Cursor	✅	✅
VS Code (Copilot)	✅	✅
Zed	✅	✅
Claude Code	✅	✅
Windsurf		✅
Cline		✅

Onde os dois aparecem, prefira o 1 clique — não há token para guardar nem renovar.

Com 1 clique (Claude, ChatGPT e outros)

O caminho sem token: cole o endereço do servidor no assistente e autorize no navegador. É como funciona no Claude (aplicativo e site), no ChatGPT e, se preferir, também no Cursor, VS Code e Zed. Ver Conectar com 1 clique acima.

ChatGPT tem três detalhes que valem saber antes:

É preciso ligar o Modo desenvolvedor nas configurações do ChatGPT. Em contas de equipe, um administrador precisa habilitar isso antes.
Não aparece no plano gratuito. Nos planos pagos, o assistente consulta seus dados — que é exatamente o que este conector faz, já que ele é somente leitura.
Fora isso, o passo é o mesmo: informar o endereço do servidor e autorizar.

Com token

Os snippets abaixo usam <endereço> e <seu-token> como placeholders — substitua pelos valores exibidos na página Use no MCP. Cada assistente espera uma estrutura ligeiramente diferente; copie a do seu.

Claude Code

bash

claude mcp add --transport http lumo <endereço> --header "Authorization: Bearer <seu-token>"

Cursor

json

{
  "mcpServers": {
    "lumo": {
      "url": "<endereço>",
      "headers": { "Authorization": "Bearer <seu-token>" }
    }
  }
}

Windsurf — o campo é serverUrl, não url:

json

{
  "mcpServers": {
    "lumo": {
      "serverUrl": "<endereço>",
      "headers": { "Authorization": "Bearer <seu-token>" }
    }
  }
}

Zed — vai em context_servers:

json

{
  "context_servers": {
    "lumo": {
      "url": "<endereço>",
      "headers": { "Authorization": "Bearer <seu-token>" }
    }
  }
}

Cline — o type precisa ser exatamente streamableHttp:

json

{
  "mcpServers": {
    "lumo": {
      "type": "streamableHttp",
      "url": "<endereço>",
      "headers": { "Authorization": "Bearer <seu-token>" }
    }
  }
}

Como melhorar as respostas do assistente

O MCP usa o mesmo catálogo de fatos do Chat com Dados para responder. Quanto melhor curados os indicadores e as descrições de cada Aplicação, melhores as respostas — para o assistente externo tanto quanto para o chat interno do Lumo.

Comece pelos fatos

Se o assistente estiver escolhendo a coluna errada ou dando respostas inconsistentes entre perguntas parecidas, veja Fatos: Ensinando seu Negócio — é a mesma configuração que deixa o Chat com Dados mais consistente.

Perguntas frequentes

A conexão dá acesso a tudo do tenant? Não — e isso vale tanto para o token quanto para o 1 clique. A conexão é pessoal e carrega as permissões de quem conectou: as mesmas Aplicações e colunas que essa pessoa já vê logada no Lumo. Em ambos os casos o acesso é somente leitura.

Preciso gerar token se conectei com 1 clique? Não. São caminhos alternativos para a mesma coisa. O token existe para os assistentes que não abrem o navegador para autorizar (como Claude Code, Windsurf e Cline) ou para quem prefere configurá-lo à mão. O Claude para aplicativo e site e o ChatGPT só usam o 1 clique.

Tenho acesso a mais de um ambiente. Dá para conectar todos? Dá, um de cada vez: cada autorização vale para o ambiente escolhido na tela de consentimento. Repita o processo para conectar outro — o assistente trata cada um como um conector separado.

Revoguei um token por engano, e agora? Gere um novo na mesma página e atualize a configuração do seu assistente com o token novo.

Por que uma consulta veio com poucas linhas, se eu esperava milhares? Consultas via MCP têm um limite de linhas por resposta — é assim por design, para caber no contexto do assistente. Para ver o resultado completo, abra o permalink do relatório que vem junto da resposta.

Isso substitui a API REST de chat? São coisas diferentes. O MCP conecta um assistente de terceiros (Claude, Cursor) com o seu próprio token pessoal. Para integrar seu próprio sistema ao motor de IA do Lumo — sem passar por um assistente externo — use a API REST de Chat IA, autenticada por token de tenant.

Próximos passos

Agentes de IA — o módulo onde o card "Use no MCP" vive, e como criar personas de investigação reutilizáveis.
Fatos: Ensinando seu Negócio — a peça central para respostas consistentes, seja no chat ou via MCP.
Chat com Dados — o assistente de IA embutido no Lumo, mesma base de indicadores.
API REST de Chat IA — para integrar seu próprio sistema (não um assistente de terceiros) via token de tenant.

Conectar seu Assistente de IA (MCP) ​

O que o assistente enxerga ​

O que o assistente consegue fazer ​

Agentes prontos ​

Como ativar ​

Conectar com 1 clique (OAuth) ​

Gerando e gerenciando seu token ​

Conectando seu assistente ​

Com 1 clique (Claude, ChatGPT e outros) ​

Com token ​

Como melhorar as respostas do assistente ​

Perguntas frequentes ​

Próximos passos ​

Conectar seu Assistente de IA (MCP)

O que o assistente enxerga

O que o assistente consegue fazer

Agentes prontos

Como ativar

Conectar com 1 clique (OAuth)

Gerando e gerenciando seu token

Conectando seu assistente

Com 1 clique (Claude, ChatGPT e outros)

Com token

Como melhorar as respostas do assistente

Perguntas frequentes

Próximos passos