Conectar apps de IA (MCP)

Kimiko incluye un servidor MCP para que las apps de IA de tu ordenador puedan buscar en tus reuniones, leer tus notas y transcripciones y trabajar con tus tareas. MCP (Model Context Protocol) es el estándar abierto que usan las apps de IA para conectarse a herramientas.

El servidor, kimiko-mcp, forma parte de Kimiko y funciona en tu ordenador. La app de IA inicia el servidor cuando lo necesita, y el servidor se detiene cuando la app cierra la conexión. No existe una versión en línea del servidor, así que solo pueden conectarse las apps del mismo ordenador.

Qué puede hacer una app de IA

Una app conectada dispone de diez herramientas. Ocho leen tu biblioteca y dos cambian tareas.

Herramienta	Qué hace
list_meetings	Enumera las reuniones y notas, de la más reciente a la más antigua, por fecha, proyecto o tipo
search_meetings	Busca en transcripciones, notas, resúmenes y títulos, y devuelve momentos con marcas de tiempo
get_meeting	Muestra los detalles de una reunión, quién estaba invitado y quién habló, y su resumen más reciente
get_notes	Lee lo que escribiste, la versión pulida si la creaste y los resúmenes en directo
get_transcript	Lee una transcripción página a página, para que una reunión larga no desborde la app
get_screenshots	Lee el texto que Kimiko encontró en las capturas de pantalla de una llamada, nunca las imágenes
list_tasks	Enumera tus tareas con su reunión y su proyecto; las completadas, solo si la app lo pide
list_projects	Enumera tus proyectos con su número de tareas
create_task	Añade una tarea
update_task	Edita una tarea, la cambia de estado o de proyecto, o la marca como completada

La búsqueda siempre encuentra coincidencias por palabras clave. Si tu modelo de búsqueda funciona en Ollama o en otro servidor local de tu ordenador, también encuentra coincidencias por significado. Con el motor integrado, las apps de IA buscan por palabras clave. Consulta la búsqueda del chat.

Prompts listos para usar

Kimiko también ofrece tres prompts. Las apps compatibles con los prompts de MCP los muestran como comandos de barra o en un menú de prompts.

• weekly_review: un repaso de la última semana, o de un periodo más largo de hasta 90 días, con las decisiones, los compromisos, los temas pendientes y las tareas abiertas por proyecto. Su argumento days fija el periodo, de 1 a 90 días (7 por defecto).
• meeting_prep: una nota de preparación sobre una persona o un tema, con el contexto, los compromisos de ambas partes, los temas pendientes y preguntas que plantear. Su argumento person_or_topic es obligatorio.
• open_loops: las tareas vencidas y los compromisos de las dos últimas semanas que nunca llegaron a ser una tarea. Su argumento opcional project, el nombre o el id de un proyecto, lo limita a un solo proyecto. El prompt pide a la app que cree una tarea solo después de que lo confirmes.

En Claude Code, escribe / y elige Kimiko:meeting_prep (MCP), o escribe /mcp__Kimiko__meeting_prep Anna. Claude Code separa los argumentos por los espacios, así que ahí indica una persona o un tema de una sola palabra.

Lo que una app nunca puede hacer

Kimiko no da a las apps de IA ninguna forma de:

• iniciar o detener una grabación
• eliminar tareas, reuniones o notas
• crear o eliminar proyectos
• cambiar tus notas
• abrir el audio o las imágenes de las capturas de pantalla
• leer tus ajustes o tus claves de API

Con Permitir cambios en tareas activado, una app sí puede editar una tarea, e incluso borrar sus detalles, el responsable o las fechas.

Activa el acceso

El acceso está desactivado hasta que lo actives.

1. Abre Ajustes → Conexiones.
2. En la tarjeta Servidor MCP, activa Permitir apps de IA.

Mientras esté activado, cualquier app de tu ordenador que inicie el servidor MCP de Kimiko puede leer tus reuniones. Todas las acciones de añadir y de copiar de Ajustes → Conexiones activan el acceso por ti, y Kimiko te avisa cuando lo hace.

Permitir cambios en tareas, en la tarjeta Qué pueden hacer las apps, está activado por defecto. Permite que las apps creen y actualicen tareas. Si lo desactivas, las apps pueden leer las tareas, pero no cambiarlas. Kimiko rechaza create_task y update_task de inmediato y las deja fuera de la lista de herramientas que cargue una app a partir de entonces.

Activar o desactivar Permitir apps de IA surte efecto en la siguiente solicitud de una app conectada. Si una app intentó iniciar Kimiko mientras el acceso estaba desactivado, reinicia la app. Un cambio en Permitir cambios en tareas también se aplica desde la siguiente solicitud, pero la app conserva la lista de herramientas que cargó al conectarse hasta que la reinicies o la vuelvas a conectar.

Conecta una app

En Mac, deja que el servidor de Kimiko use tu llavero antes de que una app se conecte por primera vez, para que la solicitud de macOS, que solo aparece una vez, no quede oculta detrás de la app. Selecciona Autorizar ahora en la fila Acceso al llavero y después Permitir siempre. La fila está en la tarjeta Servidor MCP cuando el acceso está activado, y en Ayuda en caso contrario. En La solicitud del llavero de macOS encontrarás más detalles.

La tarjeta Apps de IA de Ajustes → Conexiones conecta estas apps por ti:

• Claude (la app de escritorio): selecciona Añadir a Claude. Kimiko te muestra lo que va a escribir en el archivo de ajustes de Claude, guarda antes una copia de seguridad y conserva el resto de tus ajustes. Selecciona Añadir y después cierra Claude por completo y vuelve a abrirlo, porque Claude solo lee sus ajustes al iniciarse. En Mac, elige Claude → Salir de Claude; en Windows, haz clic con el botón derecho en el icono de Claude de la bandeja del sistema y elige Salir. No basta con cerrar la ventana.
• Claude Code: selecciona Añadir a Claude Code para añadir Kimiko en todos tus proyectos y después inicia una nueva sesión de Claude Code. Si Kimiko no encuentra el comando claude, la fila ofrece Copiar comando en su lugar. Ejecuta el comando en Terminal en Mac, o en un terminal en Windows.
• Cursor: selecciona Añadir a Cursor. Cursor abre su propio cuadro de diálogo de instalación con los datos de Kimiko ya rellenados; confirma ahí la instalación.
• VS Code: selecciona Añadir a VS Code para abrir la página de instalación de Kimiko en VS Code y después confirma la instalación. Las herramientas de Kimiko funcionan en el modo agente de GitHub Copilot.
• LM Studio (versión 0.3.17 o posterior): abre Más apps y selecciona Añadir a LM Studio. LM Studio abre su propio cuadro de diálogo con los datos de Kimiko ya rellenados; confírmalo ahí.

Las demás apps de Más apps tienen un botón Copiar comando, Copiar configuración o Copiar ruta: ChatGPT y Codex, Gemini CLI, Raycast, Zed, Windsurf y Warp. Cada uno copia un fragmento listo para usar con la ruta exacta de tu ordenador.

Añade Kimiko a mano

Todas las apps de abajo inician el mismo servidor, llamado Kimiko, sin argumentos ni variables de entorno.

Uses la app que uses, activa primero Permitir apps de IA. Cualquier acción de copiar de Ajustes → Conexiones lo hace por ti. En Mac, selecciona también Autorizar ahora en la fila Acceso al llavero y después Permitir siempre, antes de que la app se conecte por primera vez.

Los ejemplos usan la ruta del servidor en Mac, con Kimiko en la carpeta Aplicaciones:

/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp

Si Kimiko está en otro sitio, usa en su lugar el fragmento de Ajustes → Conexiones. Siempre lleva la ruta correcta del Kimiko que estás usando. Para copiar solo la ruta, abre Más apps y selecciona Copiar ruta en la fila de Raycast.

En Windows, Añadir a Claude y Añadir a Cursor rellenan la ruta por ti. Para configurar cualquiera de las dos a mano, usa Copiar configuración en la fila de Windsurf o de Warp, en Más apps: copia la misma entrada mcpServers con la ruta ya escapada. Zed tiene su propio botón Copiar configuración, y también la fila de ChatGPT y Codex, en su menú ⋯. Si escribes tú una ruta de Windows en JSON o TOML, duplica cada barra invertida (C:\\Users\\…\\kimiko-mcp.exe). En Windows, ~ en las rutas de abajo significa tu carpeta de usuario (%USERPROFILE%).

Claude (app de escritorio)

Añade esta entrada al archivo de ajustes de Claude, ~/Library/Application Support/Claude/claude_desktop_config.json en Mac o %APPDATA%\Claude\claude_desktop_config.json en Windows, sin quitar los demás servidores que tengas. En Mac, la entrada es:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

En Windows, el servidor es kimiko-mcp.exe, junto a kimiko-app.exe; copia su ruta exacta desde Ajustes → Conexiones.

Después, cierra Claude por completo y vuelve a abrirlo: en Mac, elige Claude → Salir de Claude; en Windows, haz clic con el botón derecho en el icono de Claude de la bandeja del sistema y elige Salir. No basta con cerrar la ventana. Entonces, las herramientas y los prompts de Kimiko aparecen en Claude.

Claude Code

En Mac, ejecuta esto en un terminal:

claude mcp add --scope user --transport stdio Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

--scope user añade Kimiko en todos los proyectos. Usa --scope project para añadirlo solo al .mcp.json del proyecto actual. claude mcp list muestra si se ha conectado, y /mcp dentro de una sesión enumera las herramientas.

Cursor

En Mac, añade a ~/.cursor/mcp.json la misma entrada mcpServers que para Claude:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

VS Code

Añade Kimiko a tu mcp.json de usuario (~/Library/Application Support/Code/User/mcp.json, o %APPDATA%\Code\User\mcp.json en Windows). En Mac, la entrada es:

{
  "servers": {
    "Kimiko": {
      "type": "stdio",
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

O, en Mac, añádelo desde un terminal:

code --add-mcp '{"name":"Kimiko","command":"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp","args":[]}'

ChatGPT y Codex

Los hilos de Codex de la app de escritorio de ChatGPT y la CLI de Codex comparten ~/.codex/config.toml. Kimiko funciona en Codex, no en los chats normales de ChatGPT. En Mac, la entrada es:

[mcp_servers.Kimiko]
command = "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

O, en Mac, ejecuta:

codex mcp add Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Gemini CLI

En Mac, esto añade Kimiko a ~/.gemini/settings.json:

gemini mcp add -s user Kimiko "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Zed

Añade una entrada context_servers al archivo de ajustes de Zed (~/.config/zed/settings.json en Mac, %APPDATA%\Zed\settings.json en Windows). En Mac, la entrada es:

{
  "context_servers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp",
      "args": []
    }
  }
}

Raycast

En Raycast, ejecuta Install MCP Server, elige el transporte Standard Input/Output (stdio) y pega la ruta del servidor como comando. Más apps → Raycast → Copiar ruta la copia.

Windsurf y Warp

Las dos usan la misma entrada mcpServers que Claude. En Windsurf, añádela a ~/.codeium/windsurf/mcp_config.json. En Warp, añádela en los ajustes de Warp, en AI y después en MCP servers. Copiar configuración, en la fila de cada app, la copia. En Mac, la entrada es:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Cualquier otra app

Añade un servidor MCP local que use el transporte stdio, llamado Kimiko, cuyo comando sea la ruta del servidor, sin argumentos. Activa Permitir apps de IA y después, en Mac, permite el acceso al llavero la primera vez que la app se conecte (lo explicamos más abajo).

Para probar el servidor desde un terminal, ejecútalo con --check. La comprobación abre tu biblioteca sin atender solicitudes y, en Mac, puede mostrar la solicitud del llavero. En Mac, ejecuta:

"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp" --check

En Windows, en PowerShell, ejecuta & "<path to kimiko-mcp.exe>" --check, con la ruta de Ajustes → Conexiones.

La comprobación muestra ok cuando Kimiko puede leer tu biblioteca. No comprueba Permitir apps de IA, que las apps siguen necesitando. Si algo falla, muestra el motivo, como un problema con el llavero o con la base de datos.

Apps que no pueden conectarse

Las apps de IA que se usan en el navegador, como claude.ai y ChatGPT en la web, no pueden conectarse. Tampoco las apps móviles. Solo se conectan a servidores MCP en internet, y el servidor de Kimiko funciona únicamente en tu ordenador, por diseño.

En la app de escritorio de ChatGPT, Kimiko funciona en los hilos de Codex, no en los chats normales.

La solicitud del llavero de macOS

Kimiko guarda la clave de cifrado de tu biblioteca en el llavero de macOS. La primera vez que kimiko-mcp la lee, macOS pregunta si puede usar tu llavero. Selecciona Permitir siempre.

Esa solicitud suele abrirse detrás de la ventana de la app de IA, y la primera conexión espera hasta que la respondas. Para evitarlo, selecciona Autorizar ahora en la fila Acceso al llavero de Ajustes → Conexiones antes de que una app se conecte por primera vez. Así, la solicitud se abre encima de Kimiko. Mientras el acceso esté activado y aún sin autorizar, la fila está en la tarjeta Servidor MCP; si no, está en Ayuda.

macOS puede volver a preguntar después de una actualización de Kimiko. Si elegiste Denegar, abre Acceso a Llaveros, busca app.kimiko.db, quita kimiko-mcp en Control de acceso y después selecciona Volver a intentarlo en la fila.

El Administrador de credenciales en Windows

En Windows, la clave se guarda en el Administrador de credenciales de tu cuenta de Windows, así que no aparece ninguna solicitud. Comprobar ahora, en la fila Administrador de credenciales de Ayuda, confirma que las apps pueden leerla.

Privacidad

Kimiko, por su parte, no envía nada a internet cuando una app de IA lo usa. El servidor solo responde a la app que lo inició y nunca se conecta a internet. La búsqueda usa tu modelo de búsqueda solo cuando funciona en Ollama o en otro servidor local de tu ordenador.

Lo que lee una app lo gestionan esa app y su proveedor de IA. Una app de IA en la nube envía lo que lee, incluido el texto de las transcripciones, a su propio proveedor de modelos, según las condiciones de esa app. Una app que usa un modelo local puede mantenerlo en tu ordenador. El Modo solo local controla las conexiones propias de Kimiko; no impide que una app conectada envíe lo que lee.

Los detalles de una reunión pueden incluir información de tu calendario, como el título del evento y las personas invitadas, con sus nombres y direcciones de correo. Una app de IA en la nube los envía a su proveedor, igual que todo lo demás que lee.

Historial de conexiones, en Ayuda, muestra qué apps han usado Kimiko y cuándo. Solo guarda los nombres de las apps, las versiones, las horas, los recuentos y la última herramienta usada; nunca lo que se ha preguntado. Las entradas sin usar durante 90 días se borran.

Consulta privacidad y datos para saber qué guarda y qué envía Kimiko.

El contenido de las reuniones no es de confianza

Cualquier persona en una reunión puede decir frases dirigidas a una app de IA, como «ignora tus instrucciones», y una pantalla compartida puede mostrarlas. Los resúmenes de la reunión pueden repetirlas, y el título de una reunión que viene de la invitación de calendario de otra persona también puede contenerlas. Kimiko indica a la app que trate el texto de las transcripciones, el texto de la pantalla y los resúmenes como datos, nunca como instrucciones.

Aun así, revisa lo que te sugiera una app antes de actuar. Si tu app puede usar herramientas sin preguntar, haz que siga pidiendo confirmación antes de create_task y update_task: una edición puede cambiar el nombre de una tarea, moverla o borrar sus detalles y fechas. Kimiko nunca permite que una app elimine una tarea. Si quieres que las apps solo lean, desactiva Permitir cambios en tareas.

Desactiva el acceso de las apps de IA

Desactiva Permitir apps de IA en Ajustes → Conexiones. Todas las apps pierden el acceso al instante, y una app conectada recibe el error agent access is off en su siguiente solicitud.

Para quitar Kimiko de una app, elimina su entrada Kimiko de los ajustes de esa app. En Claude Code, ejecuta:

claude mcp remove Kimiko

Solución de problemas

Ayuda → ¿No se conecta?, en Ajustes → Conexiones, recoge las más habituales de estas soluciones.

Problema	Solución
La app dice que Kimiko no se ha podido iniciar o se ha desconectado, o muestra agent access is off	Activa Permitir apps de IA y después reinicia la app. Si el problema era el acceso, el registro de la app muestra agent access is off (para Claude, consulta su registro más abajo; para Claude Code, ejecuta claude mcp get Kimiko).
La primera conexión se queda colgada en Mac	Puede que haya una solicitud del llavero oculta detrás de la app. Selecciona Permitir siempre, o usa antes Autorizar ahora.
Claude Code deja de esperar a los 30 segundos	Inícialo con MCP_TIMEOUT=60000 claude (en PowerShell, $env:MCP_TIMEOUT=60000; claude) o usa antes Autorizar ahora. claude mcp get Kimiko muestra los mensajes del servidor.
Kimiko no aparece en Claude	Cierra Claude por completo y vuelve a abrirlo; no basta con cerrar la ventana. Su registro es ~/Library/Logs/Claude/mcp-server-Kimiko.log (en Windows, %APPDATA%\Claude\logs\mcp-server-Kimiko.log).
Solo hay ocho herramientas, sin create_task ni update_task	Activa Permitir cambios en tareas y después reinicia la app (en Claude Code, vuelve a conectar Kimiko desde /mcp o inicia una nueva sesión).
Has movido Kimiko, o la fila de Claude dice Necesita una actualización	Selecciona Actualizar en la fila de Claude y después cierra Claude y vuelve a abrirlo. En las demás apps, vuelve a añadir Kimiko o vuelve a copiar su fragmento desde Ajustes → Conexiones.
Kimiko dice que el archivo de ajustes de Claude no es válido	Corrige el archivo o elimínalo y después vuelve a seleccionar Añadir a Claude. Si editaste el archivo a mano, busca una coma que falte o una barra invertida simple en una ruta de Windows.
Ajustes → Conexiones dice que falta una parte de Kimiko	Reinstala Kimiko.
Una búsqueda no devuelve nada	Pide un intervalo de fechas más amplio, u otro proyecto u otro tipo, o pide a la app que explore con list_meetings.
Una búsqueda no encuentra una reunión	Usa palabras que se dijeron en la reunión. Las apps buscan por palabras clave, salvo que tu modelo de búsqueda funcione en un servidor local.
El servidor se detiene al instante y dice que no se ha encontrado la base de datos	Abre Kimiko una vez para que pueda crear tu biblioteca.
Acceso al llavero dice Denegado	Sigue los pasos de La solicitud del llavero de macOS.