Esta página describe Calíope 1.5, la versión que estoy construyendo ahora mismo. La 1.4 ya está en la App Store para Mac, iPad, iPhone, Apple Watch, Apple TV y Apple Vision Pro. 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.
En el Gestor de Conexiones, pulsa + en la barra lateral izquierda. Introduce un nombre descriptivo, la familia del servidor (el protocolo con el que habla) y el producto dentro de ella, el host, puerto, usuario y contraseña. El campo "Base de datos por defecto" es opcional.
En la sección Opciones del servidor puedes configurar el charset, la cotejación y activar SSL/TLS. Si SSL está activo aparecerán campos para seleccionar el certificado y la clave del cliente.
Palabras clave: perfil, nueva conexión, guardar servidor, host, configurar
Selecciona el perfil en la lista de la barra lateral. El formulario de la derecha se carga con sus datos actuales y puedes editar cualquier campo directamente. No hay botón de guardar: cada cambio se guarda en cuanto lo haces.
Para eliminar un perfil hay un tema propio, porque no se puede deshacer y se lleva más de lo que parece: ver Eliminar una conexión.
Eliminar una conexión no borra sólo su dirección y su usuario: se lleva todo lo que Calíope había guardado de ese servidor. Por eso pregunta antes, y por eso la pregunta dice el nombre de la conexión — si no es la que creías, ése es el momento de enterarte.
Desde dónde
- macOS: selecciona el perfil y pulsa − en la barra de abajo de la lista, junto al +. O haz clic derecho sobre la fila y elige Eliminar.
- iPad: selecciona el perfil y pulsa − en la barra inferior; o mantén pulsada la fila y elige Eliminar; o desliza la fila de derecha a izquierda. El deslizamiento no borra al soltar: revela el botón, y la pregunta llega igual. Deslizar en el otro sentido —de izquierda a derecha— es Mover a grupo.
Qué se va con ella
- El perfil, con todos sus datos.
- Su contraseña del Llavero, y también la de SSH y la frase de paso de su clave privada.
- Su historial de consultas, y sus filas del registro de errores y del registro de mensajes del servidor.
- El SQL que tuviera guardado en el editor de esa conexión, y su caché de esquema.
No se puede deshacer. No hay papelera ni deshacer: la confirmación es la única oportunidad de echarse atrás.
En tus otros dispositivos. Con la sincronización de iCloud activada la baja viaja, y la conexión desaparece también allí. Al revés no pasa nada raro: un perfil que creaste en el otro equipo y que éste todavía no había visto no se lee como una baja, así que no se borra solo.
Un grupo entero. Eliminar un grupo elimina también las conexiones que tiene dentro, con la misma pregunta y el mismo alcance; se explica en Organizar perfiles en grupos.
El campo «Host alternativo» del perfil sirve para un servidor al que se llega por dos direcciones distintas. El caso típico es una máquina de desarrollo: desde el propio equipo responde en 127.0.0.1, y desde el iPad hay que usar su dirección en la red local. Como los perfiles se sincronizan entre tus dispositivos, un solo campo de host no puede ser correcto en los dos sitios.
Al conectar se intenta primero el host principal. Si no responde, se intenta el alternativo con el mismo puerto, el mismo usuario, la misma contraseña y las mismas opciones: lo único que cambia es la dirección. Si necesitas también otro puerto, escribe «dirección:puerto» (por ejemplo, 10.0.0.20:3307).
Cuando la sesión entra por el alternativo, aparece una marca junto al nombre del servidor y «Probar conexión» dice a qué dirección respondió, para que sepas siempre contra qué máquina estás trabajando.
Con un túnel SSH el campo se ignora, y no es un olvido: ahí la dirección del servidor la resuelve la máquina del túnel, no tu dispositivo, así que no cambia según desde dónde te conectes.
Palabras clave: host alternativo, segunda dirección, ip local, red local, failover, 127.0.0.1, ipad, dos direcciones
Cuándo hace falta escribirla, qué campos deja de usar Calíope cuando lo haces y dónde queda la contraseña.
Dónde está: Panel lateral › Conexiones › Cadena de conexión
El campo «Cadena de conexión» aparece solo cuando el motor del perfil es MongoDB, y es opcional. Si lo dejas vacío, Calíope arma la conexión con lo que hay arriba: dirección, puerto, usuario, contraseña, TLS y base de datos. Para un servidor normal eso basta.
Escríbela cuando la conexión no se pueda describir con esos campos. Son tres casos: un conjunto de réplica, que necesita varias direcciones y el nombre del conjunto; una base de autenticación distinta de la habitual, que se indica con authSource; y un clúster de Atlas, cuya dirección empieza por mongodb+srv:// y no lleva puerto que teclear.
Cuando la escribes manda sobre los campos de arriba: usuario, contraseña, TLS y opciones salen de ella. Hay dos excepciones. Si el perfil usa un túnel SSH, la dirección la pone el túnel y no la cadena, porque el servidor que nombra la cadena es el que ve la máquina del túnel y no tu dispositivo. Y si la cadena no nombra ninguna base de datos, se usa la del perfil, o admin si tampoco la hay.
Sin cadena, la autenticación va contra admin. Es donde viven las cuentas administrativas y es lo que asumen mongosh y Compass cuando alguien teclea usuario y contraseña sin más; si las tuyas están en otra base, indícalo con authSource.
Una advertencia sobre la contraseña: la del campo de arriba se guarda en el Llavero, pero una contraseña escrita dentro de la cadena no. La cadena se guarda con el resto del perfil y, si tienes activada la sincronización con iCloud, viaja con él. Si eso te importa, deja la contraseña en su campo y usa la cadena solo para lo demás.
Si la cadena está mal escrita, la conexión falla diciéndolo: es un error del formulario, así que se arregla ahí y no reintentando.
Palabras clave: cadena de conexión, mongodb, uri, srv, atlas, conjunto de réplica, replica set, authSource, mongodb+srv
Verifica los datos del servidor antes de conectar.
Dónde está: Gestor de Conexiones › Probar conexión
Pulsa Probar conexión en el formulario del perfil. Calíope intenta abrir una conexión real con los datos introducidos y muestra el resultado en un banner verde (éxito) o rojo (error con descripción).
La prueba es especialmente útil para validar credenciales SSL, firewalls o configuraciones de host antes de guardar el perfil.
Establece la conexión y abre el Espacio de Trabajo.
Dónde está: Gestor de Conexiones › Conectar
Una vez completados los datos del perfil, pulsa el botón Conectar (con ícono de rayo). Calíope abre el pool de conexiones con el controlador del motor y carga el árbol de esquemas.
Si la conexión falla aparece un mensaje de error en la barra de estado. Revisa el host, las credenciales y que el servidor esté activo y accesible desde tu red.
Palabras clave: connect, conectar, abrir workspace, pool
Cambia la base de datos de la sesión desde el panel de esquema.
Dónde está: Editor SQL › Panel de esquema › Usar como base de datos activa
En el panel de esquema del Editor SQL, haz clic derecho en una base de datos y elige Usar como base de datos activa. La sesión pasa a ella sin reconectar —equivale a ejecutar USE nombre_bd— y el menú de servidor enseña su nombre junto al del servidor. El cambio afecta solo a la sesión actual.
Palabras clave: use database, cambiar bd, seleccionar base de datos
Desconecta del servidor y vuelve al Gestor de Conexiones.
Dónde está: Espacio de Trabajo › Desconectar
Pulsa el botón Desconectar en la cabecera del Espacio de Trabajo. Calíope cierra el pool de conexiones y regresa a la pantalla del Gestor de Conexiones con animación.
La desconexión es automática al cerrar la ventana principal de la aplicación.
En el formulario de perfil de conexión, activa el interruptor Reconexión automática. Con esta opción activa, Calíope intentará restablecer la conexión automáticamente si el servidor la cierra por inactividad o por reinicio.
Útil para sesiones largas o para servidores con tiempo de espera de conexión corto.
Trabaja con varios servidores al mismo tiempo sin perder el contexto.
Dónde está: Espacio de Trabajo › Menú de servidor
Calíope soporta tener varias conexiones a servidores activas al mismo tiempo. Cada servidor tiene su propia sesión independiente con su propio árbol de esquemas, pestañas SQL abiertas, historial de consultas y estado del asistente IA.
Cómo funciona:
Cada vez que pulsas Conectar en el Gestor de Conexiones, se abre una nueva sesión sin cerrar las anteriores. Todas las sesiones coexisten y puedes alternar entre ellas sin perder nada.
Estado de cada sesión:
- Pestañas SQL y su contenido se conservan al cambiar de servidor.
- El árbol de esquemas muestra las bases de datos del servidor activo.
- El asistente IA mantiene su historial de conversación por sesión.
Puedes abrir tantas sesiones como necesites, por ejemplo para comparar datos entre entornos de desarrollo, staging y producción al mismo tiempo.
Palabras clave: multi-servidor, múltiples conexiones, simultáneo, varias conexiones, sesiones, multiserver
Cambia entre servidores conectados desde el menú desplegable del Espacio de Trabajo.
Dónde está: Espacio de Trabajo › Menú de servidor
El menú selector de servidor muestra el nombre del servidor activo y un indicador de estado de conexión (punto verde = conectado, rojo = error). Al pulsarlo se despliega un menú con todas las sesiones abiertas.
En macOS: el selector aparece en la barra de herramientas de la ventana, en la esquina superior izquierda. Muestra el nombre del servidor, la base de datos activa y la flecha desplegable.
En iPad: el selector aparece a la izquierda de la barra de pestañas, siempre visible en la parte superior del Espacio de Trabajo.
Opciones del menú:
- Toca o haz clic en el nombre de cualquier servidor para activar esa sesión.
- La sesión activa aparece marcada con un ✓.
- Añadir servidor abre el Gestor de Conexiones sobre el Espacio de Trabajo actual para conectar otro servidor sin perder las sesiones abiertas.
- Desconectar cierra la sesión del servidor activo.
Conecta a un servidor adicional sin abandonar el trabajo actual.
Dónde está: Espacio de Trabajo › Menú de servidor › Añadir servidor
Para añadir una nueva conexión mientras ya estás trabajando en otro servidor:
1. Abre el menú selector de servidor (en la barra de la ventana en macOS, en la barra de pestañas en iPad).
2. Elige Añadir servidor.
3. Se abre el Gestor de Conexiones: en una ventana propia en macOS, como hoja en iPad.
4. Selecciona un perfil existente o crea uno nuevo y pulsa Conectar.
5. El Gestor de Conexiones se cierra solo y la nueva sesión queda disponible en el selector.
Las sesiones previas permanecen abiertas e intactas durante todo el proceso.
Palabras clave: añadir servidor, nueva sesión, segunda conexión, agregar servidor, conectar otro
Cierra la sesión de un servidor sin afectar las demás conexiones activas.
Dónde está: Espacio de Trabajo › Desconectar
Cuando tienes varias sesiones abiertas, puedes cerrar cualquiera de ellas de forma independiente:
Servidor activo:
- Abre el menú selector de servidor y pulsa Desconectar, o usa el botón rojo de desconexión en la barra de herramientas.
Cualquier sesión (para cambiar primero):
1. Abre el menú selector de servidor.
2. Selecciona el servidor que quieres cerrar para activarlo.
3. Pulsa Desconectar.
Al cerrar una sesión, Calíope activa automáticamente la última sesión disponible. Si era la única sesión abierta, regresa al Gestor de Conexiones.
Cifra la conexión al servidor con certificados SSL.
Dónde está: Panel lateral › Formulario de perfil › SSL
En el formulario del perfil de conexión, activa el interruptor SSL en la sección Opciones del servidor. Aparecen tres campos opcionales para los certificados del cliente:
- Certificado CA — archivo del certificado de la Autoridad Certificadora (.pem o .crt). Con este archivo Calíope verifica la identidad del servidor.
- Certificado cliente — archivo del certificado del cliente para autenticación mutua.
- Clave cliente — clave privada correspondiente al certificado del cliente.
Si activas SSL sin especificar el certificado CA, Calíope verifica el certificado del servidor contra las autoridades certificadoras del sistema (comportamiento por defecto seguro). Si el servidor usa un certificado autofirmado, la conexión fallará a menos que proporciones el CA correspondiente.
Aceptar certificado sin verificar (inseguro): marca esta casilla solo si te conectas a un servidor de desarrollo con certificado autofirmado y no puedes proporcionar el CA. La conexión seguirá cifrada pero será vulnerable a ataques man-in-the-middle. No la actives para servidores de producción.
Dónde queda el archivo: al elegir un CA, un certificado o una clave de cliente —o pegarlo, en el iPad— Calíope guarda su propia copia en este aparato, nunca en iCloud Drive, y el perfil apunta a esa copia. Puedes mover o borrar el original después, y en el Mac se sigue leyendo tras relanzar. Para renovar un certificado, vuelve a elegirlo, aunque se llame igual. El archivo se queda en el aparato donde lo elegiste, y su ubicación también: un perfil configurado en otro aparato llega sin él. Antes de conectar, la lista de conexiones muestra Elige sus archivos en este aparato y el formulario dice «Este perfil usa un certificado elegido en otro aparato: elígelo aquí.»; elígelo allí, y desde entonces ese aparato guarda su propia copia.
Si un archivo no se puede leer, Calíope no conecta sin él: se detiene con «No se pudo leer un archivo TLS», que nombra el archivo y cuál de los tres es.
La conexión SSL se prueba al pulsar Probar conexión; el banner verde confirmará si el cifrado está activo.
Requiere Touch ID o Face ID antes de conectar a cualquier servidor.
Dónde está: Panel lateral › Preferencias › General › Seguridad
Calíope puede pedir Touch ID (Mac) o Face ID (iPad y iPhone) antes de abrir cualquier conexión. Es un interruptor de toda la app, no un ajuste de cada perfil.
Dónde se activa
- Preferencias › General › Seguridad › Requerir Touch ID para conectar (o Requerir Face ID para conectar), igual en el Mac que en el iPad. Solo aparece si el dispositivo tiene biometría disponible.
Con él activado, Conectar pregunta primero, y si la autenticación falla la conexión no procede. Probar un perfil no pregunta. Revisa los permisos en Ajustes del Sistema › Touch ID y contraseña (Mac) o Configuración › Face ID y código (iPad).
Cómo agrupar tus conexiones (Producción, Desarrollo, Cliente X, etc.) y mover perfiles entre grupos en macOS, iPad e iPhone.
Dónde está: Gestor de conexiones › clic derecho › Mover a grupo
Cuando la lista de conexiones crece, puedes agruparlas por entorno, cliente o cualquier otro criterio. Los grupos son plegables y persisten en connections.json como colecciones ordenables.
Crear un grupo
- macOS: clic derecho sobre cualquier grupo existente (o sobre la cabecera de la barra lateral) y elige Nuevo grupo. Se crea con el nombre por defecto Nuevo grupo y entra directamente en modo de edición para que lo renombres.
- iPad: desde el Gestor de conexiones, toca el menú ⋯ en la barra superior y elige Nuevo grupo, o edita los grupos desde la hoja Gestionar grupos.
Renombrar / eliminar
- macOS: clic derecho sobre el nombre del grupo → Renombrar grupo o Eliminar grupo.
- iPad: para renombrar, toca el lápiz de la fila en la hoja Gestionar grupos; para eliminar, desliza esa fila de derecha a izquierda. También puedes mantener pulsada la cabecera del grupo en la lista.
- Eliminar un grupo elimina también las conexiones que tiene dentro, con su contraseña guardada, su historial de consultas y el SQL que tuvieran guardado. Antes de borrar nada, Calíope pregunta y te dice cuántas conexiones se van y cómo se llaman. No se puede deshacer: si lo que quieres es deshacer la agrupación, saca antes los perfiles con Mover a grupo ▸ Sin grupo.
Mover un perfil
- macOS: clic derecho sobre el perfil → Mover a grupo ▸ → elige el grupo destino o Sin grupo para sacarlo de cualquier agrupación.
- iPad: desliza el perfil de izquierda a derecha para revelar la acción Mover (icono de carpeta, color índigo); se abre la hoja de selección de grupo.
Reordenar grupos (iPad)
- Abre Gestionar grupos y arrastra por el manillar ☰ para reordenar. El orden persiste en el campo sortOrder de cada grupo.
Expandir/plegar
- Cada grupo tiene un ▸ para plegar/expandir la lista de perfiles. El estado se guarda por grupo.
Persistencia
- Los grupos y su asignación viven en el archivo connections.json bajo el dispositivo actual. Si tienes activada la sincronización con iCloud, se comparten entre tus dispositivos.
Filtrar
- El campo de encima de la lista deja sólo las conexiones que coinciden; mientras tiene texto, todos los grupos se dibujan abiertos sin cambiar lo que guardaste (ver Filtrar la lista de conexiones).
Escribe en el campo de encima de la lista para dejar sólo las conexiones que coinciden, por nombre, servidor o grupo.
Cuando tienes treinta o cuarenta perfiles, abrir un grupo ya no basta. El campo de arriba de la barra lateral deja sólo las conexiones que coinciden con lo que escribes.
Qué busca: el nombre del perfil, su servidor y su servidor alternativo, la base de datos por omisión, el nombre de usuario, el nombre del motor y el nombre de su grupo. Escribir el nombre de un grupo lo enseña entero — es la forma de decir enséñame producción. Las tildes y las mayúsculas no importan.
Mientras filtras, los grupos se abren solos, también los que tenías plegados, para que nada que coincida se quede escondido dentro de un grupo cerrado. Esa apertura no se guarda: vacía el campo y cada grupo vuelve exactamente a como lo dejaste.
La selección no se mueve. Si el perfil que estabas editando queda fuera del filtro, el formulario de la derecha sigue enseñándolo: perder lo que estabas editando por teclear en un buscador sería peor que el problema que el buscador resuelve.
Pulsa Esc o la × para limpiar el campo. El filtro no se recuerda al cerrar la app.
Qué es la familia, qué es el producto, y cómo Calíope propone el producto que el servidor dice ser al probar la conexión.
Dónde está: Panel lateral › Gestor de conexiones
Calíope agrupa los servidores por familia, que es el protocolo con el que habla: MySQL / MariaDB, PostgreSQL, SQL Server y MongoDB. Dentro de cada familia eliges el producto: el nombre concreto de lo que tienes delante.
Familias y productos
- MySQL / MariaDB: MySQL, MariaDB, Amazon Aurora MySQL y «Otro compatible con MySQL».
- PostgreSQL: PostgreSQL, Amazon Aurora PostgreSQL y «Otro compatible con PostgreSQL».
- SQL Server: Microsoft SQL Server.
- MongoDB: MongoDB y «Otro compatible con MongoDB».
Qué decide cada uno. La familia decide con qué motor se conecta Calíope y qué herramientas se ofrecen. El producto pone el nombre, el prompt de la terminal y los fragmentos que se siembran; Aurora MySQL, por ejemplo, trae los suyos. Un producto que no es el de referencia de su familia enseña un aviso en el formulario que lo recuerda; puedes ocultarlo con No volver a mostrar.
Crear el perfil
1. En Servidor (Tipo en iPad y iPhone), elige la familia.
2. En Producto, que en el Mac es el menú de al lado, elige el producto. Si el tuyo no está, elige «Otro compatible con…».
3. Rellena host, puerto, usuario y contraseña como siempre. Con Aurora, pega el endpoint del clúster y activa SSL/TLS.
El servidor dice quién es. Al pulsar Probar conexión o al cargar la lista de bases, Calíope le pregunta al servidor y, si se identifica como otro producto de la misma familia, lo propone bajo el selector: pulsa Usar … para corregir el perfil, o ignóralo. Nunca lo cambia por su cuenta. En MongoDB no se pregunta.
Nota
Las funciones propias de un producto (autenticación IAM de Aurora, endpoints diferenciados, métricas aurora_%) no se tratan de forma especial: Calíope maneja el servidor como uno estándar de su familia.
SQL Server se conecta a la versión 2022 o posterior, siempre cifrado. Un perfil de SQL Server sincronizado con un aparato que todavía tiene Calíope 1.4 se enseña allí como MariaDB, porque esa versión no conoce la familia; abrirlo allí no funcionará hasta que ese aparato se actualice.
Palabras clave: familia, producto, aurora, amazon aurora, aws, rds, mysql, mariadb, postgresql, mongodb, compatible, protocolo, detectar, tipo de servidor
Cuando un perfil tiene Túnel SSH activado, Calíope envía notificaciones locales en dos momentos:
- Caída del túnel — al detectar un fallo de conexión antes de intentar reconectar.
- Reconexión exitosa — si la reconexión automática (opción Reconectar automáticamente del perfil) recupera el túnel con éxito.
Activar o desactivar:
Ve a Preferencias › Notificaciones y usa el toggle Túnel SSH caído / reconectado.
Si la reconexión automática falla, no se envía la notificación de reconexión; la caída ya fue notificada. El cooldown entre notificaciones del mismo host es de 60 s.