AgenticBI
Conecta tus datos empresariales con cualquier cliente MCP. Los agentes de AgenticBI encuentran los datos correctos, los combinan entre sistemas, ejecutan consultas, crean paneles, generan informes y automatizan flujos de trabajo analíticos. Sin necesidad de SQL.
Documentación
AgenticBI MCP Server
Demostración
Mira AgenticBI en acción: https://www.youtube.com/@TryAgenticBI
| Campo | Valor |
|---|---|
| Producto | AgenticBI MCP Server |
| Propósito | Conecta Claude, Cursor, VS Code, ChatGPT, Codex CLI y otros clientes de IA habilitados para MCP directamente a los datos empresariales |
| Endpoint | https://app.agenticbi.com/api/2.0/mcp |
| Protocolo | MCP 2024-11-05 |
| Transporte | Streamable HTTP (POST) con SSE |
| Autenticación | OAuth 2.1 con PKCE |
| Herramientas disponibles | 33 |
| GitHub | https://github.com/AgenticBIHQ/agenticbi-mcp-server |
Requisitos previos
| Requisito |
|---|
| Cliente de IA compatible con MCP (Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, Codex CLI) |
Configuración del cliente
Claude Desktop
Agregar a claude_desktop_config.json:
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
Ubicaciones de archivos:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
En el primer uso, tu navegador se abre al inicio de sesión de AgenticBI. Inicia sesión o crea una cuenta para autorizar.
Guía completa: https://app.agenticbi.com/docs/mcp-server.html
Claude Code
claude mcp add agenticbi --transport http https://app.agenticbi.com/api/2.0/mcp
-
Ejecuta el comando anterior en tu terminal.
-
Sal y vuelve a lanzar Claude Code.
-
Ejecuta
/mcp, selecciona agenticbi y haz clic en Habilitar. -
Haz clic en el botón de autenticación: tu navegador se abre al inicio de sesión de AgenticBI.
-
Inicia sesión o crea una cuenta y autoriza el acceso.
-
Verifica preguntando:
¿Qué herramientas de AgenticBI están disponibles?
Alternativa: Autenticación manual con token
Genera un token en AgenticBI → Configuración → Configuración de IA → Token MCP y luego ejecuta:
claude mcp add agenticbi https://app.agenticbi.com/api/2.0/mcp \
--transport http \
--header "Authorization: Bearer YOUR_MCP_TOKEN"
Guía completa: https://app.agenticbi.com/docs/claude-code-setup.html
Cursor
Requiere Cursor v0.45 o posterior.
- Abre Configuración → Configuración de Cursor
- Selecciona Herramientas e integraciones → Nuevo servidor MCP
- Agrega lo siguiente a tu
mcp.json:
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
- Guarda el archivo. Tu navegador se abre al inicio de sesión de AgenticBI en el primer uso.
Alternativa: Autenticación manual con token
{
"mcpServers": {
"agenticbi": {
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
Guía completa: https://app.agenticbi.com/docs/cursor-mcp-setup.html
VS Code
Opción A — Paleta de comandos (Recomendada)
-
Abre la paleta de comandos:
- macOS:
Cmd + Shift + P - Windows:
Ctrl + Shift + P
- macOS:
-
Busca MCP: Agregar servidor
-
Selecciona HTTP como tipo de servidor
-
Ingresa:
https://app.agenticbi.com/api/2.0/mcp -
Nómbralo
agenticbi -
Guardar
-
Autoriza mediante el navegador en el primer uso
Opción B — Archivo de configuración
Agregar a settings.json:
{
"mcp": {
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
}
O agregar a .vscode/mcp.json:
{
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
Alternativa: Autenticación manual con token
{
"mcp": {
"servers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
}
Guía completa: https://app.agenticbi.com/docs/vscode-mcp-setup.html
ChatGPT
-
Haz clic en + en el campo de mensaje y selecciona Conectores, o ve a Configuración → Aplicaciones conectadas
-
Elige Agregar conector personalizado
-
Nómbralo AgenticBI
-
Ingresa la URL del servidor:
https://app.agenticbi.com/api/2.0/mcp -
Selecciona autenticación OAuth 2.0
-
Haz clic en Guardar
-
En el primer uso, ChatGPT abre tu navegador para el inicio de sesión y autorización de AgenticBI
Alternativa: Autenticación manual con token
- Genera un token en AgenticBI → Configuración → Configuración de IA → Token MCP
- Repite los pasos 1–4 anteriores
- Selecciona autenticación Token Bearer
- Pega tu token
- Haz clic en Guardar
Guía completa: https://app.agenticbi.com/docs/chatgpt-mcp-setup.html
Codex CLI
Agregar a ~/.codex/config.json:
{
"mcpServers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp"
}
}
}
En el primer uso, tu navegador se abre al inicio de sesión de AgenticBI para la autorización.
Alternativa: Autenticación manual con token
{
"mcpServers": {
"agenticbi": {
"type": "http",
"url": "https://app.agenticbi.com/api/2.0/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
Guía completa: https://app.agenticbi.com/docs/codex-mcp-setup.html
Endpoints de autenticación
| Endpoint | URL |
|---|---|
| Autorización | https://app.agenticbi.com/oauth/mcp/authorize |
| Token | https://app.agenticbi.com/oauth/mcp/token |
| Registro | https://app.agenticbi.com/oauth/mcp/register |
Categorías de herramientas
| Categoría | Cantidad de herramientas |
|---|---|
| Preguntar y consultar | 6 |
| Paneles y exportaciones | 4 |
| Información y alertas | 3 |
| Documentos | 2 |
| Crear y gestionar | 16 |
| Destructivas | 2 |
| Total | 33 |
Herramientas de preguntar y consultar
| Herramienta | Descripción |
|---|---|
ask | Haz una pregunta de datos en lenguaje natural |
get_data | Recupera el conjunto de datos completo o los datos del widget |
search | Busca activos de AgenticBI |
find_widget | Encuentra widgets por nombre |
get_details | Recupera detalles del activo |
explain_lineage | Rastrea cómo se construyó una respuesta |
Herramientas de paneles y exportación
| Herramienta | Descripción |
|---|---|
list_dashboards | Lista los paneles |
get_embed_url | Genera enlaces de inserción |
export_pdf | Exporta paneles/widgets como PDF |
export_csv | Exporta datos como CSV |
Herramientas de información y alertas
| Herramienta | Descripción |
|---|---|
get_insights | Genera información impulsada por IA |
list_alerts | Lista las alertas |
cloud9ql_assist | Genera, corrige, explica, convierte, valida o previsualiza Cloud9QL |
Herramientas de documentos
| Herramienta | Descripción |
|---|---|
ask_document | Haz preguntas sobre documentos ingeridos |
list_documents | Lista los documentos ingeridos |
Herramientas de creación y gestión
| Herramienta | Descripción |
|---|---|
do | Ejecuta operaciones en lenguaje natural |
push_data | Inserta filas en conjuntos de datos |
run | Ejecuta consultas/informes guardados |
create_datasource | Crea una conexión de fuente de datos |
create_query | Crea una consulta |
create_widget | Crea una visualización |
update_widget | Actualiza una visualización |
layout_dashboard | Organiza los widgets del panel |
import_file | Importa CSV, JSON, XML o Excel |
create_report | Crea informes programados |
update_report | Actualiza informes |
create_alert | Crea alertas |
test_alert | Prueba alertas |
update_alert | Actualiza alertas |
ingest_document | Ingiere documentos |
extract_document_data | Extrae datos estructurados de documentos |
Herramientas destructivas
| Herramienta | Descripción |
|---|---|
delete | Elimina activos de AgenticBI |
delete_document | Elimina documentos ingeridos |
Salud y límites
| Configuración | Valor |
|---|---|
| Endpoint de salud | GET /api/2.0/mcp/health |
| Encabezado de sesión | Mcp-Session-Id |
| Tiempo de espera de inactividad | 30 minutos |
| Máximo de sesiones concurrentes | 1,000 |
Filas predeterminadas (ask) | 500 |
Filas predeterminadas (get_data) | 10,000 |
| Máximo de filas | 200,000 |
Ejemplos de indicaciones
| Ejemplo |
|---|
| ¿Cuáles fueron nuestros 10 principales clientes por ingresos el último trimestre? |
| ¿Por qué aumentó la deserción en marzo? |
| ¿Qué canales de marketing generaron más pipeline este mes? |
| Crea un panel que muestre los registros semanales por fuente. |
| Avísame cuando el MRR caiga más del 5% semana a semana. |
| Obtén nuestras transcripciones de llamadas y resume las principales objeciones de los acuerdos perdidos. |
| Sube este PDF y extrae las métricas clave a un conjunto de datos. |
| Exporta el panel de ingresos del tercer trimestre como PDF y envíalo por correo al equipo. |
Enlaces importantes
| Recurso | URL |
|---|---|
| Sitio web | https://www.agenticbi.com |
| Documentación de MCP | https://app.agenticbi.com/docs/mcp-server.html |
| Política de privacidad | https://www.agenticbi.com/privacy |
| Términos de servicio | https://www.agenticbi.com/terms |
Soporte
| Contacto |
|---|
| support@agenticbi.com |