Conectar tu IA

Hyperion mantiene el mismo proceso independientemente de la herramienta que realiza el trabajo. La conexión local aporta las herramientas o instrucciones necesarias para crear y actualizar el flujo.

Camino recomendado

Instala Desktop y abre Hyperion → Conectar con mi IA. El asistente configura:

Herramienta	Conexión
Codex	Servidor MCP local
Cursor	Servidor MCP local
Claude Desktop	Servidor MCP local
Claude Code	Skill administrada (+ MCP aparte; verifica con /mcp)
Antigravity	Servidor MCP local · Desktop 0.5.1-preview.1 o posterior

Después reinicia la herramienta y abre un chat nuevo. Las integraciones existentes no se sobreescriben a ciegas: el asistente informa conflictos y respalda los archivos que modifica.

Una conexión instalada no garantiza que un chat ya abierto haya cargado las herramientas. Tampoco basta mencionar «Hyperion» en una aplicación sin integración.

Claude Code (camino feliz para archivos locales)

Para actividades que leen o escriben en el disco o usan la terminal del proyecto, usa Claude Code con Hyperion:

1. En Desktop: Hyperion → Conectar con mi IA → Claude Code (instala la skill en ~/.claude/skills/hyperion).
2. Registra el servidor MCP de Hyperion en Code (setup claude desde fuentes, o claude mcp add con las rutas de Conexiones → Diagnóstico → Archivos del adaptador). Desktop no registra MCP automáticamente para Code.
3. Chat nuevo en el proyecto → ejecuta /mcp y confirma hyperion.
4. Pide «Usa Hyperion para…». Abre la URL del canvas en el navegador o en Desktop: Code no tiene un panel Hyperion nativo.
5. Decisiones y formularios solo en el canvas. Si el chat terminó sin espera, Copiar continuación.

Frente a…	Diferencia honesta
Claude Desktop	Mejor para chat MCP; peor camino para carpetas/shell; tampoco abre panel nativo.
Codex / Cursor	También locales vía MCP o skill; Code destaca en el contexto de proyecto/terminal.

Detalle técnico.

Revisar la configuración local

En las fuentes de desarrollo, Menú → Conexiones muestra una lista compacta de aplicaciones. El menú reúne Conexiones y Ajustes, las opciones de ayuda y las acciones de ventana (web) o actualizaciones (Desktop), seguidas de Acerca de Hyperion. Si hay un flujo abierto, Este flujo incluye Petición original, Actividad y Pausar o Reanudar cuando está permitido. La CalVer completa y el canal aparecen al pie del menú y en la cabecera de Conexiones.

Las filas muestran Configurada localmente, Sin configurar, Conflicto · sin cambios o No se pudo comprobar. Configuradas localmente cuenta archivos coincidentes del catálogo, no aplicaciones instaladas ni herramientas cargadas en un chat. Pulsa el nombre de una aplicación para desplegar su explicación, sus acciones y la ruta completa con Copiar ruta. Solo hay una aplicación desplegada; la selección se conserva al comprobar o cambiar de idioma. Mensaje de diagnóstico original permite desplegar el texto recibido, tanto reconocido como desconocido, sin traducirlo ni deducir causas. Solo se anuncia éxito si el portapapeles acepta la copia; un fallo muestra un error. Abrir detalles no modifica archivos ni respuestas del flujo. Una lista cargando o no disponible no se presenta como cero aplicaciones configuradas.

Las explicaciones conocidas de Hyperion sobre conflictos y fallos de configuración, y los avisos de éxito, siguen el idioma elegido aunque ya estén abiertos. Solo se reconocen las plantillas de conexión de Hyperion; las rutas y los diagnósticos no reconocidos conservan su texto original. Cambiar de idioma no reintenta la configuración ni altera el contenido del flujo.

Abre Diagnóstico, al pie de la lista, para ver la dirección del servicio, las sugerencias para investigar fallos y Archivos del adaptador. Este panel conserva la aplicación seleccionada. Solo se comprueba si Hyperion puede leer el ejecutable y el lanzador MCP esperados de esta instalación. No comprueba permiso de ejecución, dependencias, autenticación ni el entorno del cliente; no inicia MCP. Inicio MCP y llamada de herramienta: sin comprobar y Herramientas en este chat: desconocidas permanecen separados. Los archivos legibles no validan una entrada guardada en conflicto ni la skill de Claude Code.

Un aviso compartido distingue un archivo ausente, no regular, que Hyperion no pudo leer por permisos y una comprobación incompleta. No se pudo comprobar no demuestra que falte un archivo. Los servidores anteriores sin estos metadatos muestran Sin comprobar, sin inventar una hora. Ver diagnóstico abre la información de diagnóstico existente; Comprobar repite esta observación de lectura sin modificar archivos ni registrar credenciales. No hay reparación ni reemplazo automático. Este rediseño y estos diagnósticos aún no están en un instalador publicado.

Revisar un conflicto

En las fuentes de desarrollo, Menú → Conexiones → aplicación → Resolver conflicto… compara una vista previa limitada. Las URL muestran solo protocolo, host y puerto; se eliminan credenciales, rutas, parámetros y fragmentos. Los valores privados del entorno se omiten. Los argumentos se muestran solo mientras sigan los formatos admitidos; desde el primero no admitido o ambiguo, el resto aparece como ••••. La marca ámbar compara los valores visibles, incluidos los valores permitidos del entorno.

Esta vista previa no es un detector universal de secretos: los nombres de ejecutables, rutas locales, hosts e identificadores se consideran metadatos públicos. No pongas credenciales en ellos ni compartas archivos de configuración sin revisarlos. Reemplazar conexión requiere confirmación, crea un respaldo y conserva los demás servidores MCP. Esta corrección aún no está en un instalador publicado. Política exacta y límites.

En las fuentes de desarrollo, Cancelar, Escape o pulsar fuera de la confirmación vuelve al Resolver y enfoca Reemplazar conexión, sin escribir. Cerrar el Resolver devuelve el foco al control de la aplicación de origen; Volver al canvas o Escape desde Conexiones vuelve a su control de apertura. Solo el diálogo superior recibe teclado y clics. Durante el guardado, no se puede cerrar ni repetir la confirmación. Si falla, puedes leer el error, reintentar o cancelar; si termina, se cierran ambos diálogos y se actualiza la lista. Esta navegación aún no está en un instalador publicado.

Si no reconoce Hyperion

En las fuentes de desarrollo, si otro Hyperion rechaza las credenciales de esta instalación en la dirección solicitada, el lanzador MCP usa el puerto alternativo local elegido durante el arranque. No cambia la configuración guardada del cliente ni detiene la otra instancia. La corrección aún no está incluida en un instalador publicado. Comprueba una llamada de lectura, como hyperion_list_runs: que la configuración exista o se muestre la lista de herramientas no demuestra que las llamadas funcionen en ese chat.

1. Comprueba que elegiste la herramienta correcta en el asistente.
2. Si acabas de configurar, reinicia esa herramienta y abre un chat nuevo (no regenerues un hilo antiguo sin Hyperion). Si ya lo hiciste y siguen faltando herramientas, revisa el estado real del servidor Hyperion y su configuración en el cliente.
3. En Claude Desktop, confirma en herramientas cargadas que aparecen hyperion_* (p. ej. hyperion_create_run). En Claude Code, ejecuta /mcp y confirma hyperion.
4. Pide «Usa Hyperion para…» con un objetivo concreto.
5. Si sigue fallando, revisa el error del asistente o del servidor MCP de tu herramienta.

Claude Desktop no requiere Claude Code; la conexión de Desktop empaquetado tampoco necesita una instalación separada de Node. Conectar Claude Desktop también refresca la skill en ~/.claude/skills/hyperion. Tras una decisión en el canvas, el agente debe mantener hyperion_wait en el mismo turno; sin esa espera el chat no retoma solo. hyperion_open en modo split solo entrega la URL del navegador—no abre un panel Hyperion dentro de Claude. Los archivos del adaptador legibles no identifican la causa de herramientas ausentes en Windows. Todavía hacen falta los datos reales del cliente.

No compartas archivos de credenciales ni tokens al reportar un error.

Si el flujo no sigue tras guardar

Consulta Pausa y reanudación para distinguir conexión MCP de reactivación de sesiones.

Sin un conector de reanudación instalado, tu respuesta se guarda localmente. El agente puede recibirla mientras espera con la integración; un chat que terminó necesita un nuevo mensaje. Usa Copiar continuación en el canvas y envíalo en el chat. Tras un flujo completado, Copiar petición para el chat en «Un nuevo inicio» tampoco notifica al agente; el envío automático exige un conector de envío (MCP solo no despierta el chat). Más sobre la continuidad.

Antigravity

En Desktop 0.5.1-preview.1 o posterior, abre Hyperion → Conectar con mi IA → Antigravity. El asistente prepara mcpServers.hyperion en la configuración global documentada de Antigravity, conserva otros servidores y respalda el archivo anterior. El runtime incluido inicia Hyperion cuando el cliente carga MCP.

Reinicia Antigravity o recarga sus servidores MCP. Comprueba que aparecen las herramientas de Hyperion y pide: «Usa Hyperion para preparar una guía de bienvenida a mi proyecto».

Versión necesaria

El botón está incluido desde 0.5.1-preview.1. Si todavía tienes 0.4.0-preview.1, instala la nueva versión; la conexión técnica ofrece también setup antigravity para instalaciones desde fuentes. No necesitas editar JSON con el asistente nuevo.

Alcance verificado

Las pruebas cubren configuración, respaldo, conflictos y el protocolo MCP con identidad Antigravity. Falta validar una conversación en la aplicación de Google. El conector para reactivar automáticamente un chat terminado sigue pendiente.

Documentación MCP de Antigravity.

Otras aplicaciones

Un cliente compatible puede usar el servidor MCP, la CLI o la API local. Debe aportar un agente que planifique y ejecute: Hyperion no incluye un modelo de IA ni interpreta peticiones por sí solo. Hermes puede usar una conexión MCP stdio configurada a mano.

ChatGPT Desktop no usa el MCP stdio local de este equipo. Una integración remota autenticada sigue pendiente y no está incluida. Work mode de ChatGPT no es un requisito de Hyperion: para trabajar en local usa Cursor, Codex, Claude Desktop o Claude Code desde Menú → Conexiones.

La edición actual comunica aplicaciones en el mismo equipo. No expongas el servicio local como un servidor remoto para conectar otros equipos.

Para integradores: conexión técnica, protocolo y contrato del proceso.