Conecte seus chats de IA

Um chat de IA compatível com servidores MCP remotos (Model Context Protocol) pode explorar dados do FastBI, executar análises e consultar relatórios com o acesso que você autorizar.

Conectar com OAuth

1. No FastBI, abra User settings → Connect your AI with MCP e copie MCP server URL: https://fastbi.app/api/mcp/v1.
2. Adicione a URL nas configurações de integrações ou MCP do cliente. Se solicitado, escolha Streamable HTTP e OAuth. Os nomes dos controles variam conforme o cliente.
3. Inicie a conexão e entre no FastBI com Google, Microsoft ou e-mail e senha.
4. Em Connect …, confira o nome do aplicativo e Return address. Escolha Organization e os recursos necessários em Allow access to. Selecione Allow access para autorizar ou Cancel para recusar.
5. Volte ao chat, habilite o FastBI para essa conversa se necessário e peça a lista de recursos disponíveis.

O login confirma sua identidade. A autorização separada concede acesso à organização escolhida, não a todas as suas organizações.

Copie a URL do servidor MCP e escolha os recursos disponíveis para seu cliente de IA.

Escolher permissões

• Catalog: explorar dados conectados e esquemas.
• Reports: ler relatórios e executar widgets salvos.
• Ad hoc analysis: fazer perguntas e executar análises.
• SQL Workbench: planejar consultas, executar SQL e ler resultados.

AdHoc e SQL exigem a função Analyst. Sua participação ativa no espaço e suas permissões continuam valendo. Os dados solicitados são enviados ao cliente de IA; análises e consultas usam seus créditos normais do FastBI.

Fazer uma consulta pontual

Informe fonte, métrica, período, fuso horário e exclusões. Adapte este exemplo:

Use o FastBI para mostrar a receita líquida por semana nas últimas quatro semanas completas em USD. Use nossa fonte de pedidos, exclua os cancelados e aplique o fuso dos relatórios. Inclua um gráfico, o período coberto e as fontes utilizadas.

O cliente pode usar um relatório adequado ou iniciar uma análise AdHoc. Responda às perguntas de esclarecimento, aguarde a conclusão e confira filtros e totais. Faça perguntas complementares na mesma conversa. Se o cliente não exibir o gráfico, abra o resultado no FastBI.

Recuperar dados periodicamente

Configure o agendamento em um cliente ou automação que aceite chamadas MCP autenticadas durante execuções agendadas. Conectar o FastBI não cria um agendamento. Sem esse recurso, use consultas pontuais.

1. Crie um relatório salvo com as métricas e os filtros que deseja repetir.
2. Peça ao cliente para executar o widget correspondente e obter resultados atualizados. Defina período, fuso, frequência e destino no agendador do cliente.
3. Teste uma execução manual e confira período e atualização dos dados antes de ativar o agendamento.

Todo dia útil às 09:00 Asia/Bangkok, use o FastBI para executar o widget “Receita” do relatório “Vendas diárias” para o dia completo anterior. Retorne receita, quantidade de pedidos, comparação com o dia precedente, período e última atualização dos dados.

Adapte os nomes ao seu espaço e confira a tarefa salva no cliente. Os Jobs do FastBI sincronizam dados selecionados com o Lake; o agendamento do cliente os recupera. Programe a consulta após a sincronização terminar com sucesso. Cada execução pode consumir créditos.

Como funciona o OAuth e como revogar o acesso

Após sua aprovação, o cliente recebe um código temporário no endereço de retorno. Ele troca esse código, usando PKCE, por tokens de acesso e renovação. Você não precisa inserir sua senha do FastBI no cliente de IA.

Tokens de acesso duram no máximo uma hora. Um cliente compatível os renova automaticamente durante o período de autorização de 30 dias. Depois, conecte e autorize novamente: a renovação não prolonga esse prazo indefinidamente. Tarefas agendadas também precisam de acesso válido.

Para desconectar, abra User settings → Connect your AI with MCP → Connected AI apps → Revoke. Isso bloqueia novos acessos, mas não apaga dados já recebidos pelo cliente.

Tokens manuais

Em Manual access tokens, informe um nome, escolha Allowed features e selecione Create access token. Copie o token exibido uma única vez para o campo bearer token do cliente, usando a mesma URL MCP. Não o cole em chats nem em configurações compartilhadas. Esses tokens expiram após 30 dias e podem ser revogados em User settings.

Se a conexão falhar, confira validade, organização, recursos autorizados e função. Se os resultados estiverem antigos, confira o período do relatório e a última sincronização bem-sucedida. Para adicionar uma fonte MCP externa ao FastBI, consulte MCP integrations.