Cómo usar Insforge en Zeabur

Recientemente anunciamos una alianza estratégica con InsForge, el Backend-as-a-Service (BaaS) líder diseñado específicamente para agentes de programación con IA.

Puedes generar un frontend en React precioso en segundos, pero pedirle a una IA que "configure una base de datos segura, configure la autenticación y despliegue una API" a menudo resulta en un desastre de Dockerfiles y archivos de configuración rotos. Esto rompe tu flujo de trabajo (flow).

Aquí es donde Insforge en Zeabur cambia las reglas del juego.

Insforge es un backend nativo de IA diseñado para ser gestionado por agentes (vía MCP), y Zeabur es la plataforma de despliegue nativa de IA que maneja la infraestructura. Juntos, te permiten pasar de "Idea" a "Despliegue Full-Stack" sin salir de tu editor de código.

En esta guía, te mostraremos cómo desplegar Insforge en Zeabur con un solo clic y conectarlo a tu editor de código IA.

Requisitos Previos

• Una Cuenta de Zeabur (Puedes empezar gratis).
• Un Editor de Código IA que soporte MCP (como Cursor o Antigravity).

---

Paso 1: Despliegue desde la Integración de Zeabur

El mayor dolor de cabeza en el desarrollo backend es la configuración inicial. Zeabur elimina esto con su Integración preconfigurada.

1. Inicia sesión en tu Panel de Zeabur.
2. Crea un Nuevo Proyecto (o selecciona uno existente).
3. Haz clic en Add Integration (Añadir Integración) → Insforge.
4. Haz clic en Enable Insforge.

Aquí está la parte de la "Mejor Experiencia de Desarrollador": Cuando haces clic en instalar, Zeabur no solo despliega el contenedor de Insforge. Crea automáticamente un servicio PostgreSQL nuevo y lo vincula a Insforge internamente. No necesitas copiar cadenas de conexión manualmente ni configurar puertos de red. Zeabur maneja la orquestación por ti.

Espera unos segundos hasta que los servicios se pongan en verde (Running).

---

Paso 2: Conecta tu Agente de IA (Configuración MCP)

Una vez que tu servicio Insforge esté desplegado, necesitas los detalles de conexión para vincularlo a tu editor de IA (MCP) o a tu aplicación frontend. Zeabur crea una página de información dedicada para esto.

Hay dos formas sencillas de acceder a esta información:

Método 1: El Enlace Directo al Servicio (Recomendado)

En la vista de tu Proyecto en Zeabur, busca el icono de Insforge ubicado justo debajo del botón "Add Service".

Al hacer clic en este icono, serás redirigido a una Página de Información de Insforge dedicada. Esta página es tu centro de comando, conteniendo:

• Información del Proyecto: Estado de tu instancia y detalles básicos.
• Guía de Conexión MCP: El comando exacto que necesitas copiar y pegar en Cursor o Windsurf.
• Cadenas de Conexión: La URL de la base de datos y los endpoints de la API para tu frontend.

Método 2: La Página de Integración

Alternativamente, puedes acceder a estos detalles a través de la configuración del servicio:

1. Haz clic en el servicio Insforge en el mapa de tu proyecto.
2. Navega a la pestaña Integrations (o página de Instrucciones dependiendo de la versión de la plantilla).
3. Aquí encontrarás el mismo conjunto de credenciales y guías de conexión.

Configurar Cursor / Antigravity

Para Despliegue MCP en un Clic:

Para Cursor: Haz clic en el botón Add to Cursor.

Para Configuración Manual: → Abre la configuración de tu editor.

• Para Cursor: Ve a Cursor Settings > Features > MCP Servers > + Add New.
• Para Antigravity: Ve a la Terminal e inserta (puedes encontrar esto en el Panel de Insforge).

npx @insforge/install 
--client antigravity 
--env API_KEY=ik_xxxxxxxxxxxxxx
--env API_BASE_URL=https://xxxxx.ap-southeast.insforge.app`.

Selecciona "SSE" (Server-Sent Events) o modo Comando según tu preferencia, pero la forma más fácil de conectar es usando el puente npx proporcionado por Insforge.

Añade esta configuración a tu archivo de configuración MCP:

Puedes encontrar esta página en el Panel de Insforge o en la página de Integración de Insforge en Zeabur.

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@latest"
      ],
      "env": {
        "API_KEY": "tu_api_key_de_insforge",
        "API_BASE_URL": "https://API_BASE_URL.insforge.app"
      }
    }
  }
}

Reemplaza la URL y la API Key con los detalles reales de tu despliegue en Zeabur.

Por qué esto mejora la Experiencia de Desarrollador: Zeabur expone el Comando de Instalación MCP directamente en estas páginas. No necesitas construir el JSON manualmente ni adivinar la URL, simplemente copia el comando proporcionado en la pantalla.

---

Paso 3: Acceder a Detalles de Conexión y Credenciales (Opcional)

Este es el paso mágico. Los backends estándar requieren que leas documentación y escribas SQL. Insforge expone un servidor Model Context Protocol (MCP), que permite a tu editor de IA (Cursor/Windsurf) "hablar" directamente con tu base de datos.

Forma Recomendada: Sigue Nuestra Guía Paso a Paso

Para simplificar el proceso, hemos creado una guía de instalación paso a paso adaptada para cada agente de IA. Puedes encontrar esta guía en nuestra documentación (el enlace se actualizará una vez disponible).

¡Mantente atento a las actualizaciones en nuestra comunidad de Discord!

Obtén tus Credenciales

1. En el Panel de Zeabur, ve a la pestaña Integration de tu servicio Insforge.

2. Anota tu URL de Dominio (ej. https://xxxxx.ap-southeast.insforge.app).

   

3. Dentro de tu Panel de Administrador de Insforge, ve a Project Settings -> Connect y adquiere la Cadena de Conexión (Connection String).

   

---

Paso 4: La Prueba "Hola Mundo"

Ahora que tu agente está conectado a tu infraestructura en Zeabur, probemos la conexión. El poder de Insforge reside en que tu IA puede leer el manual por sí misma.

Abre tu Chat de IA (Command+L / Ctrl+L) y escribe:

"I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions."

Observa lo que sucede:

1. Activación de Herramienta: La IA verificará que tiene acceso al servidor MCP de insforge y activará la herramienta fetch-docs.
2. Ingestión de Contexto: Descargará y leerá la documentación de Insforge directamente desde tu instancia en Zeabur, aprendiendo exactamente cómo crear tablas, gestionar autenticación y manejar datos.
3. Confirmación: La IA confirmará que entiende la API de Insforge y está lista para construir.

Ahora estás en modo "Vibe Coding". Tu agente ha leído la documentación por ti. Ahora puedes continuar con un comando como "Crea una tabla de 'Todos'" y sabrá exactamente cómo ejecutarlo en tu base de datos en Zeabur.

---

Por qué Zeabur es el Mejor Hogar para Insforge

Podrías preguntar, "¿Por qué no ejecutar esto localmente?" o "¿Por qué Zeabur?".

1. Integración Backend Sin Esfuerzo: Al conectar Insforge a Zeabur, todo el backend se maneja por ti. Tu agente de IA se convierte en un constructor full-stack.
2. De Idea a Lanzamiento con un Prompt: Zeabur se encarga de todo, incluido el despliegue del sitio. Es una verdadera experiencia de "idea a lanzamiento" sin intervención manual.
3. Red Cero-Configuración: Insforge necesita una base de datos. En Zeabur, la comunicación entre Insforge y Postgres ocurre a través de una red interna privada. Es segura, ultrarrápida y requiere cero configuración.
4. Persistente y Escalable: Localhost funciona para prototipos, pero no puedes compartirlo. Al desplegar en Zeabur, tu agente de IA construye sobre infraestructura de producción desde el primer día.
5. Rentable: El modelo de precios basado en uso de Zeabur significa que no pagas $20/mes por un VPS solo para probar una idea. Pagas por la CPU/RAM que realmente usas.
6. Sin Dolores de Cabeza DevOps: Si el servidor se cae, Zeabur lo reinicia. Si necesitas actualizar Insforge, simplemente redespliegas. Sigues siendo un desarrollador, no un administrador de sistemas.

Preguntas Frecuentes

1. ¿En qué se diferencia Insforge de Supabase o Firebase? Mientras que Supabase y Firebase son excelentes, Insforge es "Agent-First" (Primero el Agente). Los backends estándar están diseñados para humanos. Insforge está diseñado con MCP en su núcleo, permitiendo a los agentes de IA entender y ejecutar tareas autónomamente.

2. ¿Cuánto cuesta ejecutarlo en Zeabur? Zeabur utiliza un modelo de precios basado en uso. Solo pagas por la CPU y Memoria que tu contenedor usa realmente. Para un proyecto inicial típico, el costo es muy bajo (a menudo solo unos pocos dólares al mes).

3. ¿Puedo conectarme a la Base de Datos directamente? Sí. Cuando despliegas Insforge en Zeabur, estás aprovisionando un PostgreSQL estándar. Puedes encontrar la cadena de conexión externa en Zeabur y usar herramientas como TablePlus o Prisma.

4. ¿Necesito usar un Editor de IA para usar Insforge? No. Insforge viene con un Panel de Administrador GUI completo. Puedes crear tablas y gestionar usuarios manualmente a través de tu navegador.

5. ¿Están seguros mis datos? Sí. Zeabur aísla tus servicios dentro de una red privada. Por defecto, la comunicación entre Insforge y PostgreSQL ocurre internamente.

6. ¿Puedo migrar mis datos más tarde? Absolutamente. Como Zeabur te proporciona un PostgreSQL estándar, puedes realizar un pg_dump para exportar tus datos en cualquier momento.

Conclusión

La combinación de Insforge (Backend Nativo de IA) y Zeabur (Despliegue Nativo de IA) elimina la fricción del desarrollo de aplicaciones moderno.

Siguiendo esta guía, has configurado un stack donde:

• Zeabur gestiona los servidores.
• Insforge gestiona la lógica de la base de datos.
• Tu Agente de IA escribe el código.

Ahora eres libre de concentrarte completamente en construir un gran producto.

Despliega Insforge en Zeabur Ahora