Esta página describe Calíope 1.5, la versión que estamos construyendo ahora mismo. La 1.4 está terminada y en revisión de App Store, y la tienda sirve hoy la 1.3 en el Mac y la 1.2 en iPad. El changelog dice en qué versión llegó cada función.
Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.
Genera SQL a partir de instrucciones en lenguaje natural.
Dónde está: Espacio de Trabajo › Herramientas › IA
Pulsa IA en la barra de navegación del workspace. Escribe tu petición en español (o inglés) en el área de texto inferior, por ejemplo: "Dame los 10 clientes con más compras del mes pasado".
El asistente genera el SQL correspondiente y lo muestra en un panel de código. Con un proveedor listo —los de nube necesitan tu clave; Apple Intelligence y Ollama no piden ninguna—, las respuestas las genera el modelo de lenguaje.
Elige el proveedor del asistente: Apple Intelligence no pide clave; los de nube, sí.
Dónde está: Asistente IA › Configuración (gear)
Pulsa el ícono de engranaje en la cabecera del Asistente IA para abrir el panel de configuración. Ahí eliges el proveedor: Apple Intelligence corre en el propio aparato y no necesita clave ni cuenta; los proveedores de nube piden tu API key y, además, dejan elegir modelo.
El panel se dibuja según lo que el proveedor elegido necesite. Si no pide clave, la fila de la clave no aparece: no es que falte, es que no hace falta.
En un proveedor que sí pide clave y todavía no la tiene, el asistente funciona en modo demo, con respuestas de ejemplo basadas en coincidencia de patrones.
Palabras clave: api key, openai, gemini, configurar, modelo, GPT, apple intelligence, sin clave, local
El modelo del sistema, en el aparato: sin clave, sin coste y sin que nada salga a internet.
Dónde está: Calíope › Preferencias › Asistente AI
Apple Intelligence es el modelo de lenguaje del sistema. Corre en el propio aparato: no necesita clave ni cuenta, no tiene coste y tu pregunta no sale a internet.
Para que aparezca en el selector hacen falta dos cosas: un aparato compatible y Apple Intelligence encendida en Ajustes del Sistema. Si falta alguna, el selector no la ofrece — no sale apagada, sencillamente no está, y el asistente sigue funcionando con los proveedores de nube.
Donde va bien es en peticiones cortas: explicar un error, escribir una consulta sobre una o dos tablas, recordar una sintaxis. Donde no va es en esquemas grandes: su ventana es pequeña, y cuando el esquema no cabe el asistente lo dice en la conversación y propone qué hacer.
Ahí entra la casilla Mandar esquema al modelo, en ese mismo panel y también en Preferencias › Asistente AI. Puesta, se envían los nombres de tablas, columnas y claves foráneas de la base activa — nunca filas. Quitada, no se envía nada del esquema: las tablas hay que nombrarlas en la pregunta.
Recomendación: si la consulta va sobre pocas tablas, nómbralas y quita la casilla. Es una línea más de escribir, y con Apple Intelligence es además lo que evita que el esquema no quepa.
Palabras clave: apple intelligence, local, sin clave, privacidad, ventana, esquema, no cabe
Un servidor de modelos abiertos que corre donde tú digas. Sin clave y sin coste por consulta.
Dónde está: Calíope › Preferencias › Asistente AI
Ollama es un programa que corre modelos de lenguaje abiertos en tu propio Mac. Se instala desde ollama.com y un modelo se trae con ollama pull <nombre> — por ejemplo ollama pull qwen2.5-coder. Calíope le habla como a cualquier otro proveedor: sin clave y sin coste por consulta.
Qué escribir en la dirección. La de fábrica —http://127.0.0.1:11434— vale cuando Ollama corre en el mismo Mac. Desde el iPad o el iPhone se escribe la dirección del Mac en tu red (http://192.168.x.x:11434), y ahí hay un paso que se olvida: por omisión Ollama sólo escucha en sí mismo. Para que acepte conexiones de la red hay que arrancarlo con OLLAMA_HOST=0.0.0.0 ollama serve.
Qué viaja. Tu pregunta y, con la casilla Mandar esquema al modelo puesta, los nombres de tablas, columnas y claves foráneas de la base activa — nunca filas. Y llega sólo a esa dirección: en el mismo Mac no sale de él; en la red, va hasta ese Mac y no más lejos.
Qué modelo. Uno pensado para código da bastante mejor SQL. Uno pequeño puede contestar en prosa, sin el bloque de SQL, y entonces el asistente enseña el texto tal cual y no hay nada que llevar al editor; también puede inventarse nombres de columna que tu esquema no tiene. Con un modelo local, además, la espera la marca tu ordenador: si da error de tiempo, sube el límite de generación en Preferencias.
Si no contesta. El asistente lo dice con la dirección dentro. Son dos cosas y se comprueban en este orden: que Ollama está arrancado, y que la dirección escrita es la suya.
Un cliente de IA de este Mac puede listar bases, describir tablas y hacer consultas de lectura.
Dónde está: Calíope › Preferencias › Asistente AI
Con el servidor MCP encendido, un cliente de IA que corra en este Mac —Claude Desktop, Cursor y cualquiera que hable MCP— puede pedirle a Calíope que liste bases, describa tablas y ejecute consultas de sólo lectura sobre las conexiones que tú marques.
Dónde corre. Dentro de Calíope, escuchando en 127.0.0.1 — o sea, sólo en este Mac — y sólo mientras Calíope está abierta. Nada se expone a tu red ni a internet: no es una opción que se pueda cambiar, es cómo está hecho.
Qué ve. Sólo las conexiones que marques en Preferencias › Asistente AI › Servidor MCP. Lo que no marques no existe para el cliente: no sale ni en la lista.
Qué puede hacer. Leer, y nada más. Una sentencia por llamada, y sólo SELECT, SHOW, EXPLAIN o DESCRIBE: un INSERT, un UPDATE, un DROP o un SELECT … FOR UPDATE se rechazan antes de tocar el servidor. Las respuestas se topan en 200 filas.
La clave. El servidor no contesta sin ella. Vive en el Llavero de este Mac, no viaja a iCloud y no entra en el respaldo de ajustes. Si crees que se te ha escapado, «Generar clave nueva» invalida la anterior en el acto — y hay que volver a pegar la configuración en el cliente.
Si el puerto que elijas ya lo está usando otro programa, Calíope te lo dice y no arranca.
Palabras clave: mcp, servidor, cliente, claude desktop, cursor, sólo lectura, token, puerto
Configurar tu cliente de IA para hablar con Calíope
Encender, marcar las conexiones, copiar la configuración y pegarla en el cliente.
Cinco pasos, en este orden:
1. En Preferencias › Asistente AI › Servidor MCP, enciende el interruptor.
2. Marca las conexiones que quieras que el cliente pueda ver. Lo que no marques queda invisible para él.
3. Pulsa Copiar configuración. Al portapapeles van dos bloques, uno por cliente, con tu puerto y tu clave ya dentro.
4. Pega el bloque que te toque en el archivo de tu cliente:
- Cursor → ~/.cursor/mcp.json
- Claude Desktop → ~/Library/Application Support/Claude/claude_desktop_config.json
5. Reinicia el cliente. Los clientes leen su configuración al arrancar.
Claude Desktop sólo sabe hablar por entrada y salida estándar, no por HTTP, así que su bloque usa mcp-remote como puente — es lo que hace npx en esa configuración.
Calíope tiene que estar abierta para que el cliente encuentre nada. Si la cierras, las herramientas dejan de responder hasta que la vuelvas a abrir.
Palabras clave: mcp, configurar, cursor, claude desktop, mcp-remote, json, cliente
Qué ve tu cliente de IA, y qué hace después con ello
Por MCP sí viajan filas. Van a tu cliente, en tu máquina; lo que él haga luego lo decide él.
El asistente de Calíope manda al modelo, como mucho, los nombres del esquema. El servidor MCP es otra cosa y conviene decirlo claro: por aquí sí viajan filas, porque la respuesta a una consulta son los datos.
A dónde van. Al cliente que tú configuraste, corriendo en esta misma máquina. Calíope no manda nada a internet.
Y después. Lo que ese cliente haga con lo que recibe —por ejemplo, enviárselo a su modelo en la nube para redactar la respuesta— lo decide ese cliente y su política de privacidad, no Calíope. Si eso importa en tus datos, esa decisión se toma antes de marcar la conexión.
Cómo cortarlo, de menos a más:
- Desmarca la conexión: deja de existir para el cliente.
- Apaga el servidor: dejan de responder todas.
- Genera una clave nueva: la anterior deja de servir en el acto, aunque alguien la tuviera.
Qué queda escrito. Todo lo que se ejecuta por MCP queda en el Registro de consultas, con la conexión y el resultado, igual que lo que escribes tú. Lo que se rechaza no llega al servidor y no deja fila.
Palabras clave: mcp, privacidad, filas, datos, cliente, nube, registro de consultas
Envía el SQL generado por la IA directamente al Editor SQL.
Dónde está: Asistente IA › Abrir en editor
Cuando el asistente genera un bloque SQL, aparece el botón Abrir en editor bajo el código. Al pulsarlo, Calíope abre una nueva pestaña del Editor SQL con el SQL pre-cargado, listo para revisar y ejecutar.
El asistente recibe la estructura de la base activa mientras la casilla esté puesta.
Dónde está: Espacio de Trabajo › Herramientas › IA
Con la casilla Mandar esquema al modelo puesta —lo está de fábrica— y una base seleccionada, Calíope lee la lista de tablas, columnas y claves foráneas del esquema activo y la envía al modelo junto con tu petición. Eso es lo que permite que el SQL salga ajustado a tus tablas reales sin describirlas a mano. No se envía ni una fila de datos. Puedes cambiar la base de contexto desde el selector de la cabecera del asistente; se abre con un campo de filtro, para encontrar una base por su nombre cuando el servidor tiene muchas.
Quitada la casilla, no se envía nada del esquema y las tablas hay que nombrarlas en la pregunta. Es lo que conviene cuando la consulta va sobre pocas tablas, y con Apple Intelligence es además lo que evita que el esquema no quepa en la ventana del modelo.
Si la cuenta del servidor no tiene permisos para leer el catálogo, el asistente avisa de que el contexto no se pudo cargar. Ese aviso es de una lectura que falló: quitar la casilla no lo produce, porque entonces no se leyó nada porque nadie lo pidió.
Controla cuánto texto puede generar el modelo en cada respuesta.
Dónde está: Calíope › Preferencias › Asistente AI
Los modelos de IA trabajan con tokens — fragmentos de texto de aproximadamente 0,75 palabras cada uno. El ajuste Longitud máxima del SQL establece cuántos tokens puede generar el modelo en una sola respuesta. Afecta únicamente a la salida; no limita la longitud de tu petición ni el esquema enviado.
Opciones disponibles (en Preferencias › Asistente IA › Generación):
- Compacto (800 tokens) — Suficiente para queries simples: SELECT con una o dos tablas, filtros básicos, GROUP BY sencillo. Reduce el costo por llamada y acorta el tiempo de espera. Úsalo si tus consultas habituales son cortas y directas.
- Estándar (2 000 tokens) — Valor predeterminado. Adecuado para la gran mayoría de queries, incluyendo JOINs entre varias tablas, subconsultas y CTEs moderadas.
- Extendido (4 000 tokens) — Para queries muy complejos: múltiples JOINs encadenados, CTEs con varias ramas, procedimientos almacenados o consultas analíticas largas. Úsalo si el SQL aparece cortado con las otras opciones.
¿Cuándo aumentar la longitud? Si el SQL generado se ve incompleto — por ejemplo, la cláusula FROM aparece cortada a mitad o le falta el cierre de un JOIN — es señal de que el modelo alcanzó el límite antes de terminar. Cambia a Extendido para corregirlo.
¿Cuándo reducirla? Si solo haces consultas de mantenimiento o de diagnóstico rápido, el modo Compacto es suficiente y reduce el costo cuando el proveedor cobra por token, y acorta la espera cuando el modelo corre en tu propia máquina — ahí lo que se paga es tiempo.
El ajuste se aplica inmediatamente; no es necesario reiniciar la aplicación ni reabrir el asistente.
Palabras clave: tokens, longitud, max tokens, sql cortado, truncado, costo, generación, longitud máxima
Ajusta cuánto tiempo espera Calíope antes de cancelar una llamada a la API de IA.
Dónde está: Calíope › Preferencias › Asistente AI
Algunos modelos tardan: los de razonamiento —o1, o3 u o4 de OpenAI, o Gemini Ultra— y los que corren en tu propia máquina, que responden a la velocidad del ordenador que los ejecuta. Pueden pasar de 30 segundos en generar una respuesta para queries complejas. Si Calíope cancela la llamada antes de que el modelo termine, verás un error de timeout que parece un fallo de la app cuando en realidad solo se necesitaba más tiempo.
En Preferencias › Asistente IA › Generación hay dos sliders:
- Tiempo límite de carga de modelos (5–60 s, predeterminado 15 s) — controla cuánto tiempo espera Calíope al obtener la lista de modelos que publica el proveedor elegido.
- Tiempo límite de generación SQL (10–120 s, predeterminado 30 s) — controla cuánto tiempo espera Calíope para recibir el SQL generado por el modelo.
¿Cuándo aumentar el tiempo de generación? Si usas un modelo de razonamiento, o uno local en un Mac sin mucha memoria, y recibes errores al generar queries complejas, sube el valor a 60–90 s. Estos modelos piensan antes de responder y necesitan más tiempo.
¿Cuándo dejarlo en el valor predeterminado? Con gpt-4o o gemini-1.5-flash los 30 s son más que suficientes para la gran mayoría de queries.
Los cambios se aplican inmediatamente sin reiniciar la aplicación.
Usa el micrófono para transcribir tus peticiones al asistente en tiempo real, sin que tu voz salga del dispositivo.
Dónde está: Asistente IA › Micrófono
Pulsa el botón de micrófono junto al campo de texto para activar el dictado. Habla en el idioma que indica la cápsula que hay junto al micrófono; el texto aparece en tiempo real mientras hablas. El icono se pone en rojo mientras graba.
Al pulsar el botón de nuevo el dictado se detiene y el texto transcrito queda en el campo listo para editar o enviar directamente con ↩.
Primera vez: el sistema pide un solo permiso, el del micrófono. El de reconocimiento de voz ya no hace falta, porque la transcripción no sale del dispositivo. Si lo rechazas, puedes restablecerlo en Configuración del Sistema › Privacidad y seguridad › Micrófono.
Idioma: junto al micrófono hay una cápsula con el código del idioma en el que se escucha —ES, FR, IT…—, y mientras grabas el campo lo dice entero. Por omisión es el que tengas puesto en Calíope, con la variante regional de tu sistema cuando existe: con la app en francés y el Mac en Canadá, francés canadiense. Pulsa la cápsula para elegir otro. Los idiomas cuyo modelo todavía no está en el aparato lo dicen al ofrecerse, y si eliges uno de ésos, un aviso encima del campo te recuerda que se descargará la primera vez que dictes; la descarga ocurre una vez y a partir de ahí funciona sin conexión.
Tu voz no sale del dispositivo: la transcripción se hace entera aquí, sin enviar audio a ningún servidor, así que también funciona sin conexión. Por eso, cuando falta el modelo del idioma, Calíope te lo dice en lugar de dictar a través de internet.
Error al iniciar: si aparece un mensaje de error al presionar el micrófono, revisa que los permisos estén activos y que ninguna otra aplicación esté usando el micrófono de forma exclusiva.
Palabras clave: voz, micrófono, dictado, transcripción, hablar, speech, mic, reconocimiento de voz
Guarda el historial completo de la conversación con el asistente como archivo de texto.
Dónde está: Asistente IA › Exportar (↑)
Pulsa el botón ↑ (cuadrado con flecha) en la cabecera del Asistente IA para exportar la conversación activa. El botón solo se activa cuando hay al menos un mensaje tuyo en el historial.
Al pulsarlo se abre el diálogo de guardar del sistema. El nombre de archivo predeterminado incluye la fecha y hora actuales: caliope_ai_AAAAMMDD_HHmm.txt.
Contenido del archivo exportado:
- Encabezado con fecha y hora de exportación
- Base de datos activa, proveedor de IA y modelo usados
- Todos los mensajes del historial, marcados con [Tú] o [Asistente IA]
- Bloques SQL generados (si los hay), delimitados con --- SQL ---
El archivo se guarda en texto plano (.txt) con codificación UTF-8, compatible con cualquier editor de texto o herramienta de análisis.
Nota: el historial es volátil — se resetea al cerrar la pestaña del asistente. Exporta la conversación antes de cerrarla si necesitas conservarla.
El SQL generado por IA requiere verificación y se envía a un servicio externo.
Dónde está: Asistente IA › Panel SQL
Aviso «Generado por IA»
Cada bloque de SQL producido por el asistente lleva al pie "Generado por IA · Verifica antes de ejecutar" y el nombre del proveedor que lo generó. Revísalo siempre antes de ejecutarlo: los modelos de lenguaje cometen errores lógicos y se inventan nombres de tabla.
A dónde va tu pregunta
Depende del proveedor que elijas, y son cinco:
- OpenAI — a sus servidores. Clave propia: platform.openai.com
- Google Gemini — a sus servidores. Clave propia: aistudio.google.com
- Anthropic Claude — a sus servidores. Clave propia: console.anthropic.com
- Apple Intelligence — a ningún sitio: el modelo es del sistema y corre en tu aparato. Sin clave.
- Ollama — sólo a la dirección que tú escribas: tu propia máquina, o una de tu red. Sin clave.
Con los tres de nube, Calíope actúa como cliente de ese servicio y nunca guarda tu clave en servidores propios ni la comparte: vive en el Llavero de tu aparato.
Qué se envía
Al mandar una pregunta viaja tu texto, los últimos 3 intercambios de la conversación y, si la casilla «Mandar esquema al modelo» está puesta, los nombres de tablas, columnas y claves foráneas de la base activa.
Nunca se envían datos de las tablas, contraseñas ni credenciales de conexión.
Cada conversación con el asistente se guarda y se puede retomar.
Dónde está: Asistente IA › Historial (reloj)
Pulsa el ícono de reloj en la cabecera del Asistente IA para abrir el panel de historial junto al chat. Cada conversación se guarda en cuanto envías la primera pregunta, así que una respuesta que falla o un cambio de conexión no se lleva por delante lo que preguntaste.
Retomar una conversación. Pulsa una fila de la lista: se convierte en la conversación activa con todo su contexto, y las preguntas siguientes continúan ese mismo hilo. Para empezar de cero usa el botón + de la cabecera; lo anterior queda en el historial.
Buscar. El campo de arriba busca texto llano en el título y en todos los turnos —también en el SQL generado—, no solo en los títulos.
Qué guarda cada fila. El título se deriva de tu primera pregunta; debajo se ven la fecha, la base de datos que era el contexto y cuántas preguntas tiene el hilo.
Borrar. Menú contextual sobre una fila para eliminarla, o el ícono de papelera del pie para borrar el historial completo.
Dónde vive. En este dispositivo, en ~/Library/Application Support/Caliope/ai_history.json. Se conservan las 200 conversaciones más recientes; al llegar a ese techo el pie del panel lo indica. En ventanas estrechas el panel se colapsa a un cajón y sigue alcanzable desde la banda lateral.
Opcional: sube tus conversaciones a tu iCloud privado para tenerlas en todos tus dispositivos.
Dónde está: Asistente IA › Historial › iCloud (nube)
El historial es local por omisión. La sincronización se activa con el ícono de nube del pie del panel de historial, y Calíope pregunta antes qué hacer con lo que ya tienes: subir las conversaciones existentes o sincronizar solo las nuevas.
Qué se sube. El título, la fecha, el contexto (conexión, base de datos, proveedor y modelo) y el transcript completo: tus preguntas, las respuestas y el SQL generado. Va a la base privada de tu cuenta de iCloud, no a un servidor de Calíope.
Credenciales. Antes de salir del dispositivo, el texto pasa por el mismo redactor que el registro de consultas: un IDENTIFIED BY '…' o un SET PASSWORD se sustituyen por '***REDACTED***'. El archivo local conserva el texto original.
Al desactivarla Calíope pregunta si quieres conservar en este dispositivo las conversaciones que estén en iCloud; si eliges descargarlas, se fusionan con las locales quedándose con la versión más reciente de cada una.
Si algo falla el ícono se pone en rojo: púlsalo para ver el motivo (cuenta de iCloud no configurada, restricciones, red) y reintentar o desactivar la sincronización.
Borrado. Al borrar una conversación o todo el historial con la sincronización activa, también se eliminan de iCloud.
Copia una respuesta, solo su SQL o la conversación entera.
Dónde está: Asistente IA › Copiar respuesta
Bajo cada burbuja hay un botón Copiar respuesta: copia el texto y, si la respuesta trae un bloque SQL, también el SQL. El botón confirma con un visto durante dos segundos.
Solo el SQL. En la cabecera del panel de código, junto a Abrir en editor, está Copiar SQL.
Un fragmento suelto. El texto de las burbujas y del panel SQL es seleccionable: puedes arrastrar sobre una parte y copiarla con ⌘C.
La conversación entera. Menú contextual sobre una burbuja para copiar ese turno, o menú contextual sobre una fila del historial › Copiar conversación para llevarte el transcript completo con su cabecera de fecha y contexto — el mismo formato del botón de exportar.