Despliega y gestiona apps de Orbit con un agente de IA

Qué hace el servidor MCP de Orbit

Model Context Protocol, comúnmente llamado MCP, da a los clientes de IA una forma estándar de descubrir y llamar herramientas. El servidor MCP de Orbit expone las mismas capacidades de despliegue y gestión que usa la interfaz de Orbit a través de un endpoint HTTP sin estado en https://runonflux.com/apps/mcp.

• Inspecciona: lista planes y apps propias, analiza repositorios, inspecciona especificaciones saneadas de apps, consulta instancias y el estado de los despliegues, mide la capacidad de la red y lee registros acotados.
• Despliega: valida una especificación de app, registra un despliegue, prueba la instalación y crea un pago de Stripe autorizado cuando se requiera pago.
• Opera: lanza compilaciones y ejecuta acciones aprobadas de iniciar, detener, reiniciar, pausar, reanudar, redesplegar o eliminar sobre instancias asignadas.
• Mantener: actualiza los ajustes admitidos de la app, conserva el periodo de suscripción restante y renueva una app por una duración aprobada.

Conecta tu agente

Necesitas una cuenta de Orbit con inicio de sesión con Google o correo y un cliente MCP que admita Streamable HTTP y cabeceras de autorización personalizadas. Las sesiones solo con monedero de ZelCore y SSP no pueden crear por ahora una conexión de agente.

• Inicia sesión en Orbit con Google o correo.
• Abre Panel y luego Conectar un agente.
• Selecciona Generar configuración de conexión.
• Copia el JSON generado en la configuración de tu cliente MCP.
• Vuelve a conectar con una configuración recién generada cuando caduque la credencial.

{
  "mcpServers": {
    "orbit": {
      "type": "http",
      "url": "https://runonflux.com/apps/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FIREBASE_ID_TOKEN"
      }
    }
  }
}

Trata la configuración generada como una contraseña. No la subas al repositorio, no la incluyas en mensajes de soporte, no la pegues en prompts ni la compartas con otra persona. Genera la configuración directamente en tu propio panel.

Herramientas de agente disponibles

Un flujo de despliegue seguro

• Empieza por el análisis. Pide al agente que analice el repositorio y explique el runtime, el puerto, la rama y el directorio del proyecto detectados.
• Valida antes del despliegue. Usa validate_deployment para revisar la especificación generada, los recursos necesarios y el precio de red autorizado, sin registrar nada.
• Revisa las llamadas que modifican datos. Exige confirmación en tu cliente MCP para deploy_app, trigger_build, control_instance, update_app y renew_app.
• Guarda el identificador de transacción. Guarda el ID de transacción que devuelve un despliegue, una actualización o una renovación. Identifica la operación de Flux enviada y puede usarse para consultar el estado y el pago.
• Comprueba el resultado. Pide el estado del despliegue y las instancias después del registro. Lee un fragmento acotado del registro si la aplicación no está sana.

Autenticación, propiedad y almacenamiento de datos

Cada petición verifica el token bearer de Firebase, deriva la identidad de Flux del usuario mediante FluxCore y crea una sesión limitada a la petición. El transporte MCP es sin estado. Orbit no crea una base de datos de usuarios MCP separada ni guarda una sesión de agente de larga duración.

Firebase, FluxCore, la blockchain de Flux y el puente de pagos de Stripe siguen siendo los sistemas de registro. Orbit comprueba la propiedad de la app antes de devolver sus detalles o de contactar con un nodo asignado. Las credenciales de repositorios, los secretos de gestión, el texto plano de Enterprise y las URL con credenciales se eliminan de los resultados de las herramientas.

Un token de ID de Firebase es de corta duración. El flujo de conexión actual no incluye credenciales de renovación, así que el agente no puede ampliar el acceso en silencio. Genera una configuración nueva desde el panel cuando el token caduque.

Solución de problemas

• No autorizado: genera una configuración nueva, confirma que copiaste todo el encabezado Authorization y asegúrate de que la cuenta use inicio de sesión con Google o con correo.
• Herramienta no encontrada: vuelve a conectar el cliente MCP para que haga el descubrimiento de herramientas con la versión actual del servidor.
• App no listada: confirma que la app pertenece a la identidad de Flux vinculada a la cuenta de Firebase con la que iniciaste sesión y que es un despliegue de Orbit.
• No se puede analizar el repositorio: verifica la URL del repositorio, la rama, el subdirectorio y la credencial del repositorio privado.
• Pago requerido: usa el ID de transacción que devuelve la llamada de modificación para crear un pago de Stripe autorizado.
• Tiempo de espera: reintenta una llamada de solo lectura una vez. No repitas una llamada que modifica datos a menos que antes compruebes su ID de transacción devuelto o el estado del despliegue.