Knowi

Consulta bases de datos, crea paneles y analiza documentos en lenguaje natural desde Claude o cualquier cliente MCP. Más de 28 herramientas, más de 70 fuentes de datos.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Knowi

Conecta Claude Code, Claude Desktop, Cursor o cualquier cliente de IA compatible con MCP a Knowi. Consulta tus datos, crea paneles, gestiona informes y más — en lenguaje natural, directamente desde tu asistente de IA.

El servidor MCP está integrado en la aplicación Knowi. No se requiere instalación adicional.

Inicio Rápido

1. Generar un Token MCP

Inicia sesión en Knowi
Ve a Configuración → Configuración de IA
En Token MCP, elige una fecha de expiración y haz clic en Generar Token
Copia el token — solo se muestra una vez

2. Conectar con Claude Code

claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Para cuentas de knowi.com:

claude mcp add knowi https://www.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

3. Conectar con Claude Desktop

Edita tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "knowi": {
      "type": "streamable-http",
      "url": "https://your-instance.knowi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

4. Verificar

"What Knowi tools are available?"

Deberías ver herramientas que incluyen knowi_do, knowi_ask, knowi_search, knowi_list_dashboards y otras.

Herramientas Disponibles

Herramientas Impulsadas por IA

Herramientas de lenguaje natural que utilizan el orquestador de IA de Knowi para interpretar instrucciones y encadenar operaciones.

Herramienta	Descripción
`knowi_do`	Ejecuta cualquier operación de Knowi mediante lenguaje natural
`knowi_ask`	Haz una pregunta sobre datos — encuentra el conjunto de datos, genera una consulta y devuelve resultados
`knowi_search`	Busca en todos los paneles, widgets, conjuntos de datos e informes

Herramientas Deterministas

Operaciones directas y rápidas con comportamiento predecible.

Herramienta	Descripción
`knowi_list_dashboards`	Lista todos los paneles accesibles
`knowi_get_data`	Recupera filas de datos de un widget o conjunto de datos
`knowi_push_data`	Envía filas de datos a un conjunto de datos (lo crea si no existe)
`knowi_get_details`	Obtén metadatos completos de cualquier activo
`knowi_find_widget`	Busca widgets por nombre
`knowi_create_datasource`	Crea una nueva conexión de fuente de datos
`knowi_create_query`	Crea y ejecuta una consulta contra una fuente de datos
`knowi_create_widget`	Crea un nuevo gráfico o visualización
`knowi_update_widget`	Actualiza un widget existente
`knowi_create_report`	Crea un informe programado
`knowi_create_alert`	Crea una alerta de datos
`knowi_list_alerts`	Lista las alertas configuradas
`knowi_test_alert`	Prueba una alerta
`knowi_update_alert`	Actualiza una alerta
`knowi_run`	Activa la ejecución de una consulta o informe
`knowi_export_pdf`	Exporta un panel o widget como PDF
`knowi_export_csv`	Exporta datos como CSV
`knowi_get_embed_url`	Genera una URL de uso compartido incrustable
`knowi_get_insights`	Obtén información generada por IA para un widget
`knowi_layout_dashboard`	Organiza widgets en un panel
`knowi_import_file`	Importa un archivo (CSV, Excel) como conjunto de datos
`knowi_ingest_document`	Incorpora un documento para preguntas y respuestas con IA
`knowi_ask_document`	Haz preguntas sobre documentos incorporados
`knowi_extract_document_data`	Extrae datos estructurados de un documento
`knowi_list_documents`	Lista los documentos incorporados
`knowi_delete_document`	Elimina un documento incorporado
`knowi_delete`	Elimina un activo (requiere confirmación explícita)

Ejemplos de Uso

"Show me my Knowi dashboards"

"Ask Knowi: what were our top customers by revenue last month?"

"Create a sales dashboard with revenue trends and top products"

"Search Knowi for dashboards related to customer analytics"

"Get the data from the Monthly Revenue widget"

"Export the Executive Summary dashboard to PDF"

"Push these sales records to a Knowi dataset called 'Daily Sales'"

"Set up a daily email report for the executive dashboard"

Gestión de Tokens

Rotar un token:

Ve a Configuración → Configuración de IA → Token MCP
Haz clic en Revocar Token
Genera uno nuevo y actualiza tu configuración:

claude mcp remove knowi
claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_NEW_TOKEN"

Un token por usuario. Generar un nuevo token revoca automáticamente el anterior.

Referencia de API

El servidor MCP expone tanto HTTP Streamable (para clientes MCP) como endpoints REST (para uso programático directo).

Verificación de Salud

curl https://your-instance.knowi.com/api/2.0/mcp/health

{
  "status": "healthy",
  "toolCount": 28,
  "tools": ["knowi_do", "knowi_ask", "knowi_search", "..."],
  "activeSessions": 0
}

Listar Herramientas

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-instance.knowi.com/api/2.0/mcp/tools

Llamar a una Herramienta (REST)

curl -X POST https://your-instance.knowi.com/api/2.0/mcp/tools/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "knowi_list_dashboards",
    "arguments": {}
  }'

HTTP Streamable (JSON-RPC)

Todas las operaciones de clientes MCP utilizan POST /api/2.0/mcp con JSON-RPC estándar:

# Initialize
curl -X POST https://your-instance.knowi.com/api/2.0/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

La respuesta incluye un encabezado Mcp-Session-Id para usar en solicitudes posteriores.

Seguridad

Credenciales con alcance limitado: Los tokens MCP solo acceden a endpoints MCP — no pueden usarse contra la API de gestión más amplia.
Autorización en cada solicitud: Cada herramienta verifica que el usuario autenticado tenga acceso al recurso solicitado antes de ejecutar.
Protección contra inyección de instrucciones: Las herramientas impulsadas por IA escanean las instrucciones en busca de patrones de inyección conocidos y las rechazan antes de llegar al modelo de IA.
Protección para operaciones destructivas: knowi_do bloquea instrucciones de eliminar/descartar/purgar. Las eliminaciones requieren la herramienta explícita knowi_delete con un parámetro obligatorio confirm: true.
Truncamiento de datos: knowi_get_data y knowi_ask devuelven como máximo 100 filas por defecto.
Seguridad de sesión: Las sesiones HTTP Streamable están vinculadas al usuario autenticado. Los ID de sesión por sí solos no otorgan acceso.

Flujo de Datos

Cuando Claude llama a una herramienta MCP de Knowi, la respuesta de la herramienta (filas de datos, metadatos, información) se devuelve a Claude y se procesa en la infraestructura de Anthropic. Esto es inherente a MCP — el cliente debe recibir resultados para actuar sobre ellos.

Para máxima aislamiento de datos, usa los agentes de IA integrados en el producto de Knowi en lugar de MCP.

Solución de Problemas

Las herramientas no aparecen en Claude:

Reinicia Claude Code / Claude Desktop por completo
Verifica que el servidor sea accesible: curl https://your-instance.knowi.com/api/2.0/mcp/health
Verifica que el token sea válido: curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

"Error de conexión" en claude mcp list:

Confirma que usaste --transport http (requerido para HTTP Streamable)
Elimina y vuelve a agregar el servidor si el transporte se configuró incorrectamente

Errores 401:

El token puede estar expirado o revocado. Genera un nuevo token desde Configuración → Configuración de IA y actualiza tu configuración.

Las llamadas a herramientas devuelven acceso denegado:

El usuario cuyo token configuraste no tiene permiso para el recurso solicitado.
Para uso en producción, crea un usuario dedicado de Knowi con los permisos mínimos requeridos.

Requisitos

Cuenta de Knowi con Agentes de IA habilitados (Configuración → Configuración de IA)
CLI de Claude Code, Claude Desktop o cualquier cliente compatible con MCP

Documentación

Referencia del Servidor MCP — referencia completa de API, todos los esquemas de herramientas, modelo de seguridad
Guía de Configuración de Claude Code — instrucciones de configuración paso a paso
Documentación de Knowi — documentación completa del producto

Soporte

Documentación: knowi.com/docs
Soporte: support.knowi.com
Problemas con este repositorio: Abre un issue en GitHub