sistema avanzado mcppostgresqldockerbackendagentic-coding

InsForge: backend que tu agente configura mediante MCP

Conecta tu agente a un backend con PostgreSQL, autenticación y archivos para construir una app completa. Puedes alojarlo con Docker y consultar esquemas y logs desde MCP.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en

Claude

ChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Dificultad: avanzado
Proyecto: https://github.com/InsForge/InsForge (licencia Apache-2.0)
Guía completa: https://lab.wisd.ai/hub/insforge

Para el agente: cómo acompañar al usuario

Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara Docker Compose

Usa Docker con Compose v2. Lee el inicio rápido oficial y revisa el instalador antes de ejecutarlo en tu equipo.

Paso 2: prepara y arranca la instancia

El README documenta esta secuencia:

curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/insforge
cd ~/insforge
$EDITOR .env
docker compose up -d

En la edición, ajusta API_BASE_URL y VITE_API_BASE_URL según las instrucciones del README. Conserva los secretos generados, sin publicarlos. El script prepara archivos; Compose inicia los servicios.

Paso 3: conecta el agente

Abre http://localhost:7130 y sigue la conexión de InsForge MCP Server que muestra la interfaz. Usa un agente compatible con MCP.

Comprobación

Pide al agente: «Uso InsForge como backend; llama a la herramienta fetch-docs de su MCP y lee las instrucciones». Comprueba que recibe documentación real desde tu instancia.

Si algo falla

Comprueba las URLs configuradas y los mensajes de los contenedores. Si creas varias instancias, sigue la sección oficial de múltiples proyectos: cada una necesita nombre de Compose y puertos propios. La CLI con skills del servicio en la nube no sustituye la conexión MCP de una instancia propia.

Qué es

InsForge es un backend de código abierto orientado al trabajo con agentes de programación. Combina base de datos PostgreSQL, autenticación, almacenamiento, funciones y acceso a modelos. El agente puede consultar su estado y configurar recursos mediante herramientas MCP.

Para qué te sirve

Cuando tu prototipo ya tiene pantallas, pero necesitas usuarios, datos y archivos persistentes.
Cuando un agente debe revisar el esquema real y los logs antes de proponer una migración.
Cuando quieres probar el backend en una instancia propia con Docker Compose.

Cómo funciona

La interfaz MCP expone operaciones del backend y documentación para que el agente lea contexto y actúe. El README distingue esta vía, disponible en instalaciones propias y en la nube, de la CLI con skills, que corresponde al servicio en la nube. No conviene asumir que ambas ofrecen lo mismo en tu despliegue.

La instalación propia parte de un script que prepara los archivos de Compose y genera los secretos. Después ajustas las URLs de acceso, arrancas los servicios y conectas el MCP desde la interfaz web. La comprobación oficial consiste en pedir al agente que invoque fetch-docs.

Antes de empezar

Necesitas Docker con Compose v2 para la vía local. Debes conservar los secretos generados y revisar la dirección pública que usarán los navegadores. El código tiene licencia Apache-2.0; alojar los servicios y consumir modelos externos puede generar costes independientes.

Límites y alternativas

Un agente con acceso a migraciones y configuración puede cambiar datos y permisos. Empieza con un proyecto de prueba y revisa sus acciones antes de usar datos reales. El README marca Compute como vista previa privada: no lo trates como una función disponible en cualquier instalación. Si solo necesitas persistencia sencilla, evalúa si tu base de datos actual evita mantener otra plataforma.

Recursos

Repo en GitHub - 13246 estrellas, licencia Apache-2.0.
Licencia - condiciones del código.
Inicio rápido - instalación y conexión MCP.
Documentación - productos y uso.

Datos comprobados con GitHub el 26 oct 2026. Último commit en la rama predeterminada: 2026-10-24.