Cómo usar Ovenfo
De cero a tu primer proyecto instanciado: cuenta, integración con tu agente de IA, proyecto, infraestructura, módulos y prompts de ejemplo.
1. Crea tu cuenta
Tu cuenta Ovenfo es única para todos los productos y se crea en el portal de cuentas.
- Abre el enlace de registro y completa correo, nombre, apellido y contraseña, o usa Google.
- Si te registras con correo, recibirás un mensaje de verificación. La cuenta se activa al abrir el enlace.
- Al iniciar sesión por primera vez elige si usarás Ovenfo como persona individual o como empresa, y acepta los términos del sistema.
- Ovenfo te devuelve a la aplicación Builder con el plan Free activo: 5 proyectos, sin tarjeta.
2. Intégralo a tu agente de IA
El conector de Ovenfo es el único punto de entrada para tu agente. Al agregarlo inicias sesión y autorizas el acceso en una página de Ovenfo (OAuth): el agente nunca recibe tu contraseña ni una credencial de la plataforma, y puedes revocar el acceso cuando quieras. Elige tu agente:
https://app.builder.ovenfo.com/mcp Claude Code
- Ejecuta el comando en tu terminal.
- Dentro de Claude Code abre el gestor de conexiones con
/mcp, eligeovenfoy selecciona Authenticate. - Inicia sesión en Ovenfo en el navegador y pulsa Allow.
claude mcp add --transport http ovenfo https://app.builder.ovenfo.com/mcp claude mcp add --transport http --scope user ovenfo https://app.builder.ovenfo.com/mcp Si el navegador no abre, copia la URL que muestra Claude Code. Para revocar el acceso usa Clear authentication.
Documentación oficial: Claude Code: documentación de conectores
Claude Desktop y claude.ai
- Ve a Customize > Connectors, pulsa + Add y elige Add custom connector.
- Escribe el nombre
Ovenfo, pega la URL del conector y pulsa Continue. - Deja la autenticación en OAuth, pulsa Add y luego Connect para iniciar sesión en Ovenfo.
- En una conversación, abre + > Connectors y activa Ovenfo.
https://app.builder.ovenfo.com/mcp Los conectores remotos se configuran desde tu cuenta de Claude y requieren que el servidor sea accesible desde internet. En Team y Enterprise, un propietario de la organización lo agrega primero.
Documentación oficial: Claude: conectores personalizados
ChatGPT
- Abre Plugins (chatgpt.com/plugins), pulsa + y elige la opción de agregar un servidor personalizado.
- Escribe el nombre
Ovenfoy pega la URL del conector en Connection. - En Authentication elige OAuth, acepta la advertencia y pulsa Create as a plugin.
- Instala el plugin creado e inicia sesión en Ovenfo cuando se solicite.
https://app.builder.ovenfo.com/mcp OpenAI ha renombrado estas pantallas varias veces; la disponibilidad depende de tu plan y de los permisos de tu espacio de trabajo.
Documentación oficial: OpenAI: servidores personalizados · OpenAI Help: conectores personalizados en ChatGPT
Cursor
- Agrega Ovenfo en
~/.cursor/mcp.json(global) o en.cursor/mcp.jsondentro de tu proyecto. - Cursor detecta que requiere OAuth y abre el navegador para que inicies sesión en Ovenfo.
{
"mcpServers": {
"ovenfo": {
"url": "https://app.builder.ovenfo.com/mcp"
}
}
} Cursor registra su propio cliente OAuth automáticamente; no necesitas credenciales previas.
Documentación oficial: Cursor: documentación de conectores
VS Code y Copilot
- Crea
.vscode/mcp.jsonen tu espacio de trabajo (o usa el comando de agregar servidor de la paleta de comandos, elige HTTP y pega la URL). - Inicia desde el archivo y completa el inicio de sesión de Ovenfo en el navegador. Ovenfo queda disponible para Copilot en modo agente.
{
"servers": {
"ovenfo": {
"type": "http",
"url": "https://app.builder.ovenfo.com/mcp"
}
}
} VS Code usa la clave servers y "type": "http", distinto de mcpServers en otros clientes.
Documentación oficial: VS Code: configuración de conectores
Grok (xAI)
- Aplicación Grok: abre grok.com/connectors, pulsa New Connector, elige Custom, pega la URL del conector y completa la autenticación.
- Grok Build (CLI): ejecuta el comando; con OAuth se abre el navegador en el primer uso.
grok mcp add --transport http ovenfo https://app.builder.ovenfo.com/mcp La documentación de xAI no detalla si los conectores de la aplicación admiten OAuth con registro dinámico: si el inicio de sesión falla, usa otro agente o escríbenos a social@ovenfo.com.
Documentación oficial: xAI: Connectors · xAI: Grok Build
Instrucciones contrastadas con la documentación oficial de cada proveedor el 5 de noviembre de 2026. Las interfaces cambian con frecuencia: si un menú no coincide, sigue la documentación enlazada.
3. Instancia tu primer proyecto
Con Ovenfo conectado, pide el proyecto en lenguaje natural (ejemplos en la sección 6).
Qué ocurre
- Tu agente elige la herramienta de Ovenfo y completa los datos; si falta el alias de la empresa o el nombre del proyecto, te los pregunta.
- Instanciar un proyecto registra algo a tu nombre, por eso el agente te pide confirmación antes de ejecutarlo.
- El proyecto queda registrado en tu empresa y usuario, y cuenta contra el límite de tu plan.
- Repetir el mismo alias no crea un segundo proyecto: reconcilia el existente y regenera el código.
Lo que recibes
- Un enlace de descarga válido por 24 horas con un ZIP con los repositorios: API, bibliotecas compartidas, Shell web, módulo de administración, base de datos, caché y documentación, más los scripts del espacio de trabajo,
AGENTS.mdy su.env. - Extráelo en la carpeta donde guardas tus repositorios, manteniendo las carpetas de cada repositorio en la raíz, y ábrelo en tu IDE.
- El enlace es un secreto: quien lo tenga puede descargar el archivo hasta que caduque. No lo pegues en tickets ni chats.
Límites del plan
- El plan Free permite 5 proyectos. El panel del Builder muestra cuántos usaste.
- Al llegar al límite, el siguiente proyecto nuevo se rechaza con un mensaje de límite de plan. Módulos y contenedores no registran proyectos nuevos.
- Para más proyectos cambia de plan desde el panel del Builder o consulta los precios: https://builder.ovenfo.com/pricing/
4. Instancia la infraestructura
Al registrar el proyecto, Ovenfo inicia el aprovisionamiento de su infraestructura en la nube.
- La infraestructura se instancia en AWS. Google Cloud y Azure llegan en la Fase 2 (roadmap). Para elegir el entorno y la configuración de nube de tu empresa, usa el panel del Builder.
- El historial de Despliegues del panel muestra cada ejecución de aprovisionamiento de tus proyectos con su estado.
- Los archivos del proyecto pueden guardarse en disco local o en AWS, de forma independiente a dónde se despliega la aplicación. El almacenamiento en Azure y Google Cloud llega en la Fase 2.
- La infraestructura se basa en contenedores y estándares abiertos; también puedes llevar el código a tus propios servidores.
5. Instancia módulos
Un proyecto crece por módulos de negocio.
- Pide a tu agente un módulo nuevo (por ejemplo, Inventario) para tu proyecto: API, pantalla Angular o ambos, con puertos y almacenamiento propios.
- El resultado incluye lo que falta conectar: el remoto y la ruta del Shell, los archivos del espacio de trabajo y el menú en la base de datos.
- La descarga de módulos del catálogo ovnModule para integrarlos en tu proyecto llega en la Fase 2 (roadmap).
- Los catálogos de módulos y landing pages disponibles para tus agentes están en el roadmap, todavía no disponibles.
6. Prompts de ejemplo
Cópialos y adáptalos. Reemplaza ACME y Ventas por el alias de tu empresa y el nombre de tu proyecto.
Comprobar la conexión
Lista las herramientas de Ovenfo que tienes disponibles y explícame en una línea qué hace cada una. Instanciar un proyecto nuevo
Crea un proyecto nuevo de Ovenfo: empresa ACME, proyecto Ventas, base de datos PostgreSQL, scripts para Linux y archivos en AWS. Confírmame los datos antes de crearlo. Proyecto con datos regionales
Crea el proyecto ACME / Ventas sobre PostgreSQL, scripts para Windows, archivos en AWS, con datos iniciales solo para Perú, en soles y dólares. Agregar un módulo completo
Agrega un módulo Inventario (backend y web) al proyecto ACME Ventas. Módulo con puertos propios
Agrega un módulo Censo a este proyecto; usa los puertos 8820 y 4220 y guarda los archivos en AWS. Contenedor de base de datos
Necesito un contenedor PostgreSQL para ACME Ventas, solo México, en español e inglés, con pesos y dólares (el peso por defecto). Contenedor de caché
Necesito un contenedor Redis para ACME Ventas en el puerto 6390. Dile al agente en qué carpeta extraer el ZIP. Elige puertos libres si agregas varios módulos o contenedores, porque los valores por defecto chocan entre sí.
7. Siguientes pasos
- Abre el proyecto en tu IDE y deja que tu agente lea
AGENTS.mdy las especificaciones antes de pedirle cambios. - Agrega módulos de negocio con el mismo flujo de prompts y revisa tus despliegues en el panel.
- Revisa tu uso del plan en el panel del Builder y cambia de plan cuando lo necesites.
- Si tienes un sistema heredado, pide a tu agente que lo analice por partes: las propuestas las revisa y aprueba una persona en la aplicación.
- Mira el roadmap para saber qué viene.
Preguntas frecuentes
- ¿Es gratis?
- Sí: el plan Free incluye 5 proyectos y no requiere tarjeta. Los planes de pago están en la página de precios.
- ¿De quién es el código generado?
- Tuyo. Es código estándar que puedes alojar, modificar y mantener sin depender de Ovenfo.
- ¿Qué agentes funcionan?
- Claude, ChatGPT, Cursor, Copilot en VS Code y Grok, entre otros: cualquiera que admita conectores remotos por HTTP con OAuth.
- ¿Mi agente conoce mi contraseña?
- No. Inicias sesión y autorizas en una página de Ovenfo; el agente recibe un token que solo sirve para Ovenfo y puedes revocarlo cuando quieras.
- ¿Qué pasa si llego al límite de mi plan?
- Los proyectos nuevos se rechazan hasta que cambies de plan; tus proyectos existentes siguen funcionando.
- ¿Dónde pido ayuda?
- Escribe a social@ovenfo.com o usa el formulario de contacto de ovenfo.com.