MCP do Lumo

Tipo

Como fazer

Para

Usuário, Analista, Desenvolvedor

Na tela

Agentes de IA › Use no MCP (/agents/mcp)

O MCP do Lumo deixa um assistente de fora (Claude, ChatGPT, Cursor, Codex e outros) consultar os Indicadores e os dados das Aplicações que você acessa, sem sair dele. A ligação usa o MCP (Model Context Protocol), um protocolo aberto que esses assistentes falam. O acesso é somente leitura e carrega as suas permissões.

O endereço e os tokens ficam na página Use no MCP, aberta pelo atalho Conectar da tela Agentes de IA ou pelo ícone Usar no MCP no topo do chat.

Antes de começar

O MCP depende de liberação no Tenant. Liberado, ele vale para todo usuário, e o administrador pode bloqueá-lo por grupo ou por usuário na função Conectar via MCP, em Grupos e permissões. Bloqueado, o atalho some, nenhum token novo pode ser gerado ("Seu grupo não tem acesso ao MCP.") e os assistentes já conectados param de consultar. Os tokens que a pessoa já tinha continuam listados, para ela poder revogá-los.

O que o assistente pode fazer

O assistente usa quatro ferramentas, todas de leitura: procurar no catálogo (search_catalog), abrir uma Aplicação (get_app), procurar valores no dado (search_values) e consultar (query). Nada grava, edita ou apaga. Os argumentos e o resultado de cada uma estão em Ferramentas do MCP.

Toda consulta devolve um link para o mesmo resultado como relatório no Lumo, para conferir o número. Cada consulta traz no máximo 500 linhas e informa quantas existem no total. O número vem sempre de uma consulta real; o que o assistente pode errar é a interpretação da pergunta, e o link mostra o que ele consultou.

As skills que você vê aparecem no assistente como prompts prontos, com as instruções Como analisar e Como responder de cada uma. O nome do prompt é o nome da skill em minúsculas e com hífens (inadimplencia-por-filial). Há sempre um prompt padrão, data-analyst, mesmo sem skill nenhuma.

Onde funciona

Há dois jeitos de conectar. No 1 clique, você cola o endereço e autoriza no navegador. No token, você gera um token pessoal e cola na configuração do assistente. Os dois dão o mesmo acesso. Onde os dois funcionam, prefira o 1 clique: não há token para guardar.

Assistente	1 clique	Token
Claude (aplicativo e site)	Sim
ChatGPT	Sim
Claude Code	Sim	Sim
Codex	Sim	Sim
Cursor	Sim	Sim
VS Code (Copilot)	Sim	Sim
Windsurf	Sim	Sim
Zed	Sim	Sim
Antigravity		Sim
Cline		Sim

Copiar o endereço

Na página Use no MCP, copie o Endereço do servidor. Em Tenant com domínio próprio, o endereço usa esse domínio, então copie sempre o que aparece na sua tela.

Conectar com 1 clique

Claude. No endereço padrão do Lumo, o botão Abrir no Claude leva ao conector Lumo by HorusBI no diretório do Claude; lá, clique em Conectar. Em domínio próprio, ou para adicionar à mão, vá em Configurações › Conectores › Adicionar conector personalizado, preencha o nome e o endereço que a página mostra, clique em Adicionar e, no conector novo, em Conectar.

ChatGPT. No endereço padrão do Lumo, o botão Abrir no ChatGPT abre o plugin; lá, clique em Conectar. À mão, vá em Configurações › Plugins › Explorar catálogo › Adicionar › Adicionar servidor MCP personalizado, preencha o nome e o endereço e deixe a autenticação em OAuth. O servidor personalizado depende do plano da conta e do Modo desenvolvedor ligado; em conta de empresa, um administrador libera antes.

VS Code e Cursor. Os botões Instalar no VS Code e Instalar no Cursor da página Use no MCP instalam o servidor no editor; confirme em Instalar (VS Code) ou Install (Cursor). No Copilot Business ou Enterprise, um administrador da organização precisa liberar servidores MCP.

Claude Code, Codex, Windsurf e Zed. Ponha o endereço na configuração de MCP, sem o cabeçalho de token. Na primeira consulta, o assistente abre o navegador para autorizar.

Ao autorizar, o navegador abre a tela Conectar outra IA no endereço do Lumo. Faça login se precisar, escolha o Tenant em Conectar ao ambiente (quem tem mais de um vê a lista) e clique em Autorizar. A autorização vale para um Tenant por vez; para outro, conecte de novo, e o assistente trata cada um como um conector separado. A conexão se renova sozinha, e você desconecta pelo próprio assistente.

Conectar com token

1. Na página Use no MCP, em Tokens de acesso, dê um nome ao token ("Cursor do notebook") e clique em Gerar token.
2. Copie o token na hora: "Copie agora. Este token não será mostrado novamente."
3. Cole na configuração do assistente. A página mostra o trecho certo de cada um, já com o token.

O token é pessoal, vale com as permissões de quem o gerou, começa com lumo_key_ e não expira. A lista mostra quando cada um foi criado e o último uso. Revogar, na mesma página, corta o acesso na hora; revogou por engano, gere outro e troque na configuração.

Nos exemplos, troque <endereço> e <seu-token> pelos valores da página. O nome do servidor (lumia nos exemplos) é o nome do assistente no seu Tenant; a página já mostra o certo.

Claude Code

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

Codex, em ~/.codex/config.toml, com o token numa variável de ambiente (export MCP_TOKEN=<seu-token>):

[mcp_servers.lumia]
url = "<endereço>"
bearer_token_env_var = "MCP_TOKEN"

Cursor, em ~/.cursor/mcp.json:

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

Windsurf e Antigravity usam serverUrl no lugar de url. O arquivo é ~/.codeium/windsurf/mcp_config.json no Windsurf e ~/.gemini/antigravity/mcp_config.json no Antigravity.

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

Zed, no settings.json (Settings › Open Settings), em context_servers:

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

Cline, em MCP Servers › Configure MCP Servers, onde type precisa ser exatamente streamableHttp:

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

Limites e erros

Situação	O que acontece
Mais de 60 requisições por minuto do mesmo usuário, ou 300 do Tenant	Erro 429 "Rate limit exceeded. Slow down.", com o tempo de espera no cabeçalho Retry-After
Função Conectar via MCP bloqueada	Erro 403 "Your user is not allowed to use MCP. Ask a tenant admin."
Consulta com mais de 500 linhas	Volta o começo, com o total. O link abre o resultado completo

As restrições de linha e de coluna do seu usuário valem nas consultas, como no Chat com Dados. As consultas pelo MCP não chamam o modelo do Lumo e não consomem créditos de IA do Tenant: o modelo que responde é o do assistente de fora, na conta dele.

Melhorar as respostas

O MCP lê o mesmo catálogo de Indicadores do chat. Se o assistente escolhe a coluna errada ou responde diferente a perguntas parecidas, revise os Indicadores com Desenhar bons Indicadores.

Para ligar o seu próprio sistema ao chat do Lumo, com token do Tenant, veja a API e o streaming do chat.

Relacionado

• Ferramentas do MCP: argumentos e resultado de cada ferramenta
• Agentes de IA: skills que viram prompts no assistente
• Whitelabel: MCP com a marca de quem revende