Servidor MCP de Knowi

Conecte Claude Code, Claude Desktop, Cursor o cualquier cliente de IA compatible con MCP a Knowi. Consulte sus datos, cree paneles, gestione informes y más, en lenguaje natural, directamente desde su asistente de IA.

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

Inicio rápido

1. Generar un token MCP

1. Inicie sesión en Knowi

2. Vaya a Settings → AI Settings (Configuración → Configuración de IA)

3. En MCP Token, elija una fecha de caducidad y haga clic en Generate Token (Generar token)

4. Copie el token: solo se muestra una vez

2. Conectar a 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 a Claude Desktop

Edite su 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"
      }
    }
  }
}

Reinicie Claude Desktop después de guardar.

4. Verificar

"What Knowi tools are available?"

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

Related MCP server: AgenticBI

Herramientas disponibles

Herramientas impulsadas por IA

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

Herramientas deterministas

Operaciones directas y rápidas con un comportamiento predecible.

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:

1. Vaya a Settings → AI Settings → MCP Token

2. Haga clic en Revoke Token (Revocar token)

3. Genere uno nuevo y actualice su 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 transmitible (para clientes MCP) como puntos finales REST (para uso programático directo).

Comprobación de estado

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 transmitible (JSON-RPC)

Todas las operaciones del cliente 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: Los tokens MCP solo acceden a los puntos finales MCP; no pueden utilizarse 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 ejecutarlo.

• Protección contra inyección de prompts: Las herramientas impulsadas por IA escanean las instrucciones en busca de patrones de inyección conocidos y los rechazan antes de llegar al modelo de IA.

• Salvaguarda de operaciones destructivas: knowi_do bloquea las instrucciones de eliminación/borrado/purga. 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 de forma predeterminada.

• Seguridad de sesión: Las sesiones HTTP transmitibles 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 los resultados para actuar sobre ellos.

Para obtener el máximo aislamiento de datos, utilice los agentes de IA integrados en el producto de Knowi en lugar de MCP.

Solución de problemas

Las herramientas no aparecen en Claude:

• Reinicie Claude Code / Claude Desktop por completo

• Verifique que el servidor sea accesible: curl https://your-instance.knowi.com/api/2.0/mcp/health

• Verifique que el token sea válido: curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

"Failed to connect" en claude mcp list:

• Confirme que utilizó --transport http (necesario para HTTP transmitible)

• Elimine y vuelva a añadir el servidor si el transporte se configuró incorrectamente

Errores 401:

• El token puede haber caducado o haber sido revocado. Genere un nuevo token desde Settings → AI Settings y actualice su configuración.

Las llamadas a herramientas devuelven acceso denegado:

• El usuario cuyo token configuró no tiene permiso para el recurso solicitado.

• Para uso en producción, cree un usuario de Knowi dedicado con los permisos mínimos requeridos.

Requisitos

• Cuenta de Knowi con AI Agents habilitados (Settings → AI Settings)

• Claude Code CLI, Claude Desktop o cualquier cliente compatible con MCP

Documentación

• Referencia del servidor MCP: referencia completa de la 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: Abra un issue en GitHub