AgenticBI
Conecte seus dados de negócios a qualquer cliente MCP. Os agentes AgenticBI encontram os dados certos, fazem junções entre sistemas, executam consultas, criam dashboards, geram relatórios e automatizam fluxos de análise. Sem necessidade de SQL.
Documentação
Servidor MCP AgenticBI
Demonstração
Veja o AgenticBI em ação: https://www.youtube.com/@TryAgenticBI
| Campo | Valor |
|---|---|
| Produto | Servidor MCP AgenticBI |
| Finalidade | Conectar Claude, Cursor, VS Code, ChatGPT, Codex CLI e outros clientes de IA habilitados para MCP diretamente aos dados de negócios |
| Endpoint | https://app.agenticbi.com/api/2.0/mcp |
| Protocolo | MCP 2024-11-05 |
| Transporte | HTTP Streamable (POST) com SSE |
| Autenticação | OAuth 2.1 com PKCE |
| Ferramentas Disponíveis | 33 |
| GitHub | https://github.com/AgenticBIHQ/agenticbi-mcp-server |
Pré-requisitos
| Requisito |
|---|
| Cliente de IA compatível com MCP (Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, Codex CLI) |
Configuração do Cliente
Claude Desktop
Adicione ao claude_desktop_config.json:
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
Locais dos arquivos:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
No primeiro uso, seu navegador abrirá o login do AgenticBI. Entre ou crie uma conta para autorizar.
Guia Completo: https://app.agenticbi.com/docs/mcp-server.html
Claude Code
claude mcp add agenticbi --transport http https://app.agenticbi.com/api/2.0/mcp
-
Execute o comando acima no seu terminal.
-
Saia e reinicie o Claude Code.
-
Execute
/mcp, selecione agenticbi e clique em Ativar. -
Clique no botão de autenticação — seu navegador abrirá o login do AgenticBI.
-
Entre ou crie uma conta e autorize o acesso.
-
Verifique perguntando:
Quais ferramentas do AgenticBI estão disponíveis?
Alternativa: Autenticação Manual por Token
Gere um token em AgenticBI → Configurações → Configurações de IA → Token MCP e execute:
claude mcp add agenticbi https://app.agenticbi.com/api/2.0/mcp \
--transport http \
--header "Authorization: Bearer YOUR_MCP_TOKEN"
Guia Completo: https://app.agenticbi.com/docs/claude-code-setup.html
Cursor
Requer Cursor v0.45 ou posterior.
- Abra Configurações → Configurações do Cursor
- Selecione Ferramentas e Integrações → Novo Servidor MCP
- Adicione o seguinte ao seu
mcp.json:
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
- Salve o arquivo. Seu navegador abrirá o login do AgenticBI no primeiro uso.
Alternativa: Autenticação Manual por Token
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
Guia Completo: https://app.agenticbi.com/docs/cursor-mcp-setup.html
VS Code
Opção A — Paleta de Comandos (Recomendado)
-
Abra a Paleta de Comandos:
- macOS:
Cmd + Shift + P - Windows:
Ctrl + Shift + P
- macOS:
-
Pesquise por MCP: Adicionar Servidor
-
Selecione HTTP como o tipo de servidor
-
Digite:
https://app.agenticbi.com/api/2.0/mcp -
Nomeie como
agenticbi -
Salve
-
Autorize pelo navegador no primeiro uso
Opção B — Arquivo de Configuração
Adicione ao settings.json:
{
"mcp": {
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
}
Ou adicione ao .vscode/mcp.json:
{
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
Alternativa: Autenticação Manual por Token
{
"mcp": {
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
}
Guia Completo: https://app.agenticbi.com/docs/vscode-mcp-setup.html
ChatGPT
-
Clique em + no campo de mensagem e selecione Conectores, ou vá para Configurações → Aplicativos Conectados
-
Escolha Adicionar Conector Personalizado
-
Nomeie como AgenticBI
-
Digite a URL do servidor:
https://app.agenticbi.com/api/2.0/mcp -
Selecione autenticação OAuth 2.0
-
Clique em Salvar
-
No primeiro uso, o ChatGPT abrirá seu navegador para login e autorização no AgenticBI
Alternativa: Autenticação Manual por Token
- Gere um token em AgenticBI → Configurações → Configurações de IA → Token MCP
- Repita os passos 1–4 acima
- Selecione autenticação Token Bearer
- Cole seu token
- Clique em Salvar
Guia Completo: https://app.agenticbi.com/docs/chatgpt-mcp-setup.html
Codex CLI
Adicione ao ~/.codex/config.json:
{
"mcpServers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
No primeiro uso, seu navegador abrirá o login do AgenticBI para autorização.
Alternativa: Autenticação Manual por Token
{
"mcpServers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
Guia Completo: https://app.agenticbi.com/docs/codex-mcp-setup.html
Endpoints de Autenticação
| Endpoint | URL |
|---|---|
| Autorização | https://app.agenticbi.com/oauth/mcp/authorize |
| Token | https://app.agenticbi.com/oauth/mcp/token |
| Registro | https://app.agenticbi.com/oauth/mcp/register |
Categorias de Ferramentas
| Categoria | Quantidade de Ferramentas |
|---|---|
| Perguntar e Consultar | 6 |
| Painéis e Exportações | 4 |
| Insights e Alertas | 3 |
| Documentos | 2 |
| Criar e Gerenciar | 16 |
| Destrutivas | 2 |
| Total | 33 |
Ferramentas de Perguntar e Consultar
| Ferramenta | Descrição |
|---|---|
ask | Faça uma pergunta sobre dados em linguagem natural |
get_data | Recupere o conjunto de dados completo ou dados de widget |
search | Pesquise ativos do AgenticBI |
find_widget | Encontre widgets por nome |
get_details | Recupere detalhes de ativos |
explain_lineage | Rastreie como uma resposta foi construída |
Ferramentas de Painel e Exportação
| Ferramenta | Descrição |
|---|---|
list_dashboards | Liste painéis |
get_embed_url | Gere links de incorporação |
export_pdf | Exporte painéis/widgets como PDF |
export_csv | Exporte dados como CSV |
Ferramentas de Insights e Alertas
| Ferramenta | Descrição |
|---|---|
get_insights | Gere insights com IA |
list_alerts | Liste alertas |
cloud9ql_assist | Gere, corrija, explique, converta, valide ou visualize Cloud9QL |
Ferramentas de Documentos
| Ferramenta | Descrição |
|---|---|
ask_document | Faça perguntas sobre documentos ingeridos |
list_documents | Liste documentos ingeridos |
Ferramentas de Criar e Gerenciar
| Ferramenta | Descrição |
|---|---|
do | Execute operações em linguagem natural |
push_data | Insira linhas em conjuntos de dados |
run | Execute consultas/relatórios salvos |
create_datasource | Crie uma conexão de fonte de dados |
create_query | Crie uma consulta |
create_widget | Crie uma visualização |
update_widget | Atualize uma visualização |
layout_dashboard | Organize widgets do painel |
import_file | Importe CSV, JSON, XML ou Excel |
create_report | Crie relatórios agendados |
update_report | Atualize relatórios |
create_alert | Crie alertas |
test_alert | Teste alertas |
update_alert | Atualize alertas |
ingest_document | Ingira documentos |
extract_document_data | Extraia dados estruturados de documentos |
Ferramentas Destrutivas
| Ferramenta | Descrição |
|---|---|
delete | Exclua ativos do AgenticBI |
delete_document | Exclua documentos ingeridos |
Saúde e Limites
| Configuração | Valor |
|---|---|
| Endpoint de Saúde | GET /api/2.0/mcp/health |
| Cabeçalho de Sessão | Mcp-Session-Id |
| Tempo Limite de Inatividade | 30 minutos |
| Máximo de Sessões Simultâneas | 1.000 |
Linhas Padrão (ask) | 500 |
Linhas Padrão (get_data) | 10.000 |
| Máximo de Linhas | 200.000 |
Exemplos de Prompts
| Exemplo |
|---|
| Quais foram nossos 10 principais clientes por receita no último trimestre? |
| Por que o churn disparou em março? |
| Quais canais de marketing geraram mais pipeline este mês? |
| Crie um painel mostrando inscrições semanais por fonte. |
| Alerte-me quando o MRR cair mais de 5% semana após semana. |
| Puxe nossas transcrições de chamadas e resuma as principais objeções de negócios perdidos. |
| Envie este PDF e extraia as principais métricas para um conjunto de dados. |
| Exporte o painel de receita do Q3 como PDF e envie por e-mail para a equipe. |
Links Importantes
| Recurso | URL |
|---|---|
| Site | https://www.agenticbi.com |
| Documentação MCP | https://app.agenticbi.com/docs/mcp-server.html |
| Política de Privacidade | https://www.agenticbi.com/privacy |
| Termos de Serviço | https://www.agenticbi.com/terms |
Suporte
| Contato |
|---|
| support@agenticbi.com |