Kyomi MCP

Plataforma de inteligencia de datos: consulta tu base de datos en lenguaje natural, crea paneles y configura alertas automatizadas que monitorean tus métricas las 24 horas del día, los 7 días de la semana.

Documentación

Integración con MCP

Accede a tu inteligencia de datos directamente desde Cursor o Claude Code. Consulta tu almacén de datos, busca en tu catálogo y aprovecha el conocimiento acumulado de tu equipo, todo sin salir de tu IDE.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y fuentes de datos externas. El servidor MCP de Kyomi expone tu inteligencia de datos a cualquier cliente compatible con MCP.

Herramientas disponibles

Cuando conectas Kyomi a través de MCP, tu asistente de IA obtiene acceso a:

Catálogo de datos

  • search_catalog - Búsqueda semántica en todas tus fuentes de datos conectadas. Pregunta "encuentra tablas de ingresos de clientes" y obtén resultados al instante.
  • get_table_info - Obtén información detallada del esquema de cualquier tabla, incluidos tipos de columna y descripciones.
  • list_datasources - Ve todas las fuentes de datos conectadas a tu espacio de trabajo.

Ejecución de consultas

  • query_datasource - Ejecuta consultas SQL contra BigQuery, Snowflake, PostgreSQL y otras 6 plataformas.
  • validate_sql - Verifica la sintaxis de la consulta antes de ejecutarla.

Base de conocimiento

  • search_learnings - Accede al conocimiento acumulado de tu equipo sobre tus datos.
  • save_learning - Captura nuevos conocimientos sobre tablas, métricas o reglas de negocio.

Paneles de control

  • search_dashboards - Encuentra paneles existentes por contenido o título.
  • get_dashboard_info - Ve los detalles del panel y el contenido ChartML.
  • create_dashboard - Crea nuevos paneles con visualizaciones ChartML.

Monitores

  • search_watches - Encuentra monitores de datos existentes.
  • create_watch - Configura monitoreo automatizado de datos con alertas.

Análisis de sitios web

  • create_analytics_site - Configura el seguimiento de análisis de sitios web. Devuelve un fragmento <script> y aprovisiona una fuente de datos consultable.
  • list_analytics_sites - Ve todos los sitios de análisis y sus fragmentos de seguimiento.
  • update_analytics_site - Cambia el nombre del sitio o los dominios permitidos.
  • delete_analytics_site - Elimina un sitio de análisis y todos sus datos.

Conexión desde Cursor

  1. Ve a Configuración > Perfil en Kyomi
  2. Haz clic en Conectar con Cursor
  3. Cursor te pedirá que confirmes la instalación
  4. Autoriza a Kyomi cuando se te solicite en tu navegador

¡Eso es todo! Las herramientas de Kyomi ahora están disponibles en Cursor.

Conexión desde Claude Code

Ejecuta este comando en tu terminal:

claude mcp add kyomi --transport http https://app.kyomi.ai/mcp

Luego reinicia Claude Code. Cuando uses por primera vez una herramienta de Kyomi, se te pedirá que autorices la conexión en tu navegador.

Configuración manual

Si prefieres editar tu archivo de configuración MCP directamente, agrega esto a tu configuración:

{
  "mcpServers": {
    "kyomi": {
      "type": "http",
      "url": "https://app.kyomi.ai/mcp"
    }
  }
}

Ubicaciones de archivos de configuración:

  • Cursor: ~/.cursor/mcp.json
  • Claude Code: ~/.claude/claude_desktop_config.json

Ejemplo de uso

Una vez conectado, puedes hacerle preguntas a tu asistente de IA como:

"Busca tablas relacionadas con pedidos de clientes"

"¿Qué columnas hay en la tabla sales.transactions?"

"Ejecuta una consulta para obtener los ingresos de ayer por categoría de producto"

"¿Qué sabe nuestro equipo sobre calcular MRR?"

"Crea un panel que muestre la tendencia de usuarios activos semanales"

"Configura análisis de sitios web para my-app.com y dame el fragmento de seguimiento"

"¿Cuánto tráfico recibió mi sitio esta semana?"

La IA usará las herramientas de Kyomi para responder tus preguntas, con acceso completo a tu almacén de datos y al conocimiento acumulado de tu equipo.

Autenticación

  • OAuth basado en navegador - Cuando te conectes por primera vez, autorizarás a través de tu navegador
  • Actualización automática - Los tokens se actualizan automáticamente, no es necesario volver a conectarse
  • Mismos permisos - MCP usa tus credenciales existentes de Kyomi y el acceso a fuentes de datos

Seguridad

  • Todas las consultas usan tus credenciales y respetan los permisos de las fuentes de datos
  • El mismo límite de vista previa de 20 filas que la aplicación web de Kyomi para consultas de IA
  • Aislamiento del espacio de trabajo: solo ves los datos de tu espacio de trabajo
  • Desconéctate en cualquier momento desde Configuración > Perfil

Disponibilidad

La integración MCP está disponible en los planes Pro, Team y Enterprise.


Solución de problemas

Errores de "No autorizado"

Tu token puede haber expirado. Desconéctate y vuelve a conectarte desde Configuración > Perfil.

Las herramientas no aparecen

Asegúrate de haber autorizado a Kyomi en tu navegador. Verifica que tu suscripción incluya acceso a MCP.

Tiempo de espera de conexión

Verifica que tu red pueda acceder a app.kyomi.ai. Algunos firewalls corporativos pueden bloquear las conexiones MCP.