forja

Usar Forja desde Lovable, Bolt, Replit y v0

Herramientas como Lovable, Bolt, Replit o v0 generan una app a partir de lo que les pedís. Forja puede ser el backend de esa app, porque ofrece una API HTTP estándar que cualquiera de ellas puede llamar.

Honestidad primero. Forja no tiene una integración oficial con esas plataformas, ni un botón de conectar con un clic. Lo que hay es una API que ellas pueden usar si les das los datos de conexión. No probamos esta guía con cada plataforma y los resultados varían según la herramienta y el modelo que use.

Qué podés hacer hoy

  • Mostrar datos en la app (un catálogo, una lista de servicios): con una llave pública de solo lectura.
  • Guardar datos desde la app (una reserva, un formulario): con una función pública, porque una página no puede llevar una llave de escritura.
  • Pedirle a la herramienta que use la API, pasándole el openapi.json del proyecto.

Preparar Forja

  1. Creá el proyecto y las tablas (Empezar en 10 minutos) y activá la API de las tablas que la app va a leer.
  2. En Staging y API keys creá una llave pública: elegí las tablas y las columnas que se pueden leer, y los sitios desde los que se va a usar. Agregá la dirección donde publicás la app y también la de la vista previa de la herramienta, que suele ser otra. Para probar en tu computadora, localhost funciona con cualquier puerto.
  3. En la pestaña Conectar copiá el ID del proyecto y, si querés, descargá el openapi.json.

Prompt para mostrar datos

Pegalo en la herramienta, completando el ID, la llave pública y tu tabla:

Prompt
Quiero que la app lea sus datos de Forja, un backend con API REST.

- URL base de la API: https://api.getforja.site
- ID del proyecto: <ID_DEL_PROYECTO>
- Para leer una tabla: GET https://api.getforja.site/v1/tables/<ID_DEL_PROYECTO>/<tabla>?limit=50
  con el encabezado Authorization: Bearer <LLAVE_PUBLICA>
- La respuesta es: { "records": [...], "total": n, "limit": n, "offset": n }.
  Cada registro trae id, created_at, updated_at y las columnas de la tabla.
- Se puede filtrar por igualdad con ?filter[columna]=valor y paginar con limit (máximo 100) y offset.

Tabla "productos": nombre (texto), precio (decimal), disponible (booleano).

Reglas:
- La llave pública (empieza con fk_pub_) es solo de lectura: no intentes crear, editar ni borrar con ella.
- Guardala en una variable de entorno del proyecto, no escrita en el código.
- Nunca uses en el navegador una llave que empiece con fk_live_.
- Mostrá un mensaje claro si la API devuelve un error.

Cómo guardar datos

Una llave con permiso de escritura no puede ir en una página, porque cualquiera que la abra la ve. La forma de que una app guarde datos hoy es crear en Forja una función pública, por ejemplo reservar-turno: la función valida lo que recibe y escribe por dentro. Pedile al asistente de Forja que la arme, y después usá este texto en la herramienta:

Prompt
Para guardar un turno, la app llama a una función pública de Forja (no a la API de tablas):

POST https://api.getforja.site/v1/functions/<ID_DEL_PROYECTO>/reservar-turno
Content-Type: application/json
Cuerpo: { "cliente": "Ana", "dia": "2026-11-03" }

No lleva llave: es una función pública. Mostrá el mensaje de error que devuelva si los datos no son válidos.

Una función pública la puede llamar cualquiera. Validá todo lo que recibe y, en los planes que lo incluyen, activá el límite de pedidos por función. Mirá Qué no hace todavía: por ahora no hay login de usuarios finales ni reglas del tipo "cada visitante ve solo sus datos".

Con una herramienta que soporta MCP

Si la herramienta que usás habla MCP con encabezados personalizados, podés conectarla al servidor MCP del proyecto y que lea y modifique tus tablas directamente. Mirá Servidor MCP.

Información revisada el 2026-10-24.