Cómo desplegar una app desde Claude Code

Despliega una app desde Claude Code en una sola sesión: conecta Fine Structure por MCP o el plugin open source y obtén hosting, base de datos y dominio.

Para quién es esta guía

Personas que construyen en Claude Code y quieren ver en línea el proyecto que acaban de armar, con hosting, datos y autenticación resueltos.

Qué obtendrá

- Un camino de despliegue que funciona, de Claude Code a una URL en vivo en una sola sesión

- Una idea clara de lo que la plataforma aloja por ti: páginas, base de datos, autenticación y dominios

- Una prueba honesta para saber cuándo conviene más un host estático

¿Qué significa realmente desplegar desde Claude Code?

Para desplegar una app desde Claude Code necesitas conectar Claude a un runtime capaz de alojarla. Con Fine Structure hay dos entradas: agregar https://finestructure.ai/api/mcp como conector personalizado en la configuración de claude.ai y aprobar la pantalla de OAuth, o instalar el plugin open source con /plugin marketplace add finestructure-ai/claude-plugin y después /plugin install finestructure@finestructure. A partir de ahí Claude genera una aplicación completa con create_app o migra tu proyecto existente al runtime de la plataforma archivo por archivo, y el resultado corre como páginas React alojadas, con base de datos administrada, autenticación, dominio propio y restauración de versiones guardadas. El plan gratuito no pide tarjeta: la generación consume créditos, mientras que las ediciones, la publicación y los dominios son gratis.

Claude Code es muy bueno produciendo una aplicación y completamente incapaz de ejecutarla. Una sesión termina con una carpeta en el disco: componentes React, un modelo de datos que tomó forma mientras conversabas, un flujo de autenticación que da por hecho que existe un servidor. Desplegar es el momento en que esa carpeta recibe una URL, una base de datos y un inicio de sesión que también funciona para otras personas.

La respuesta habitual es plomería: subir a un repositorio, conectar CI, levantar una base de datos en otro lado, agregar un servicio de autenticación, apuntar el DNS y esperar los certificados. Cada pieza es razonable y la suma se lleva una tarde entera. La otra respuesta es darle a Claude Code acceso directo a un runtime que ya tiene esas piezas, para que desplegar sea una sola llamada de herramienta dentro de la misma conversación.

El planteo honesto: Nuestra plataforma no es un botón de deploy atornillado a tu stack actual. Es un runtime, y la aplicación se muda a vivir ahí. El intercambio es real: obtienes hosting, base de datos, autenticación y dominios sin armarlos, y cedes el control de la capa de servidor.

¿Cómo conectas Claude con Fine Structure?

Dos caminos, el mismo destino: la misma cuenta y las mismas aplicaciones. Elige el conector si la mayor parte de tu trabajo ocurre en claude.ai. Elige el plugin si vives en la terminal y quieres los comandos de despliegue junto a tu código.

Camino 1: el conector MCP: Abre la configuración en claude.ai, elige Add custom connector, pega https://finestructure.ai/api/mcp como URL y aprueba la pantalla de OAuth. Un clic, sin API key, sin variable de entorno viviendo en un dotfile. Claude pasa a ver alrededor de 70 herramientas: creación de apps, escritura de archivos, entities, publicación, dominios y analítica.

Camino 2: el plugin open source para Claude Code: Ejecuta /plugin marketplace add finestructure-ai/claude-plugin y luego /plugin install finestructure@finestructure. Eso agrega /deploy, /fs-status y /fs-domain a tu sesión. El código es público, así que puedes leer qué envía antes de instalarlo en lugar de confiar en una descripción.

Sobre los listados de directorios: Nuestras postulaciones a los directorios están en revisión. Hasta que eso termine no vamos a llamar al conector ni al plugin oficial, verificado ni listado. Instálalos porque la URL es pública y el código se puede leer, no por una insignia.

¿Conviene generar una app nueva o migrar el proyecto que ya tienes?

Hay dos modos de despliegue. Uno arranca de una frase: create_app toma un prompt y produce una aplicación completa con páginas, esquemas de entities, autenticación conectada y una URL que funciona. Es el camino rápido cuando la idea todavía es blanda y la forma más veloz de entenderla es mirarla. La generación consume créditos y es la única parte medida del flujo.

El segundo modo migra un proyecto que ya tienes. Claude lee tus archivos y los reescribe uno a uno dentro del runtime de la plataforma: las páginas se vuelven páginas de la plataforma, el modelo de datos se vuelve entities, las llamadas de autenticación pasan a la autenticación de la plataforma. Es una migración, no una subida a ciegas. Todo archivo que asumía un servidor bajo tu control se reescribe contra el runtime, y ahí es donde Claude Code se gana su lugar.

Cómo se ve una primera sesión realista: Pídele a Claude que cree la app, abre el preview y sigue editando archivos en la misma conversación hasta que las páginas se parezcan a lo que tenías en mente. Editar archivos y publicar no consume créditos, así que el ciclo posterior a la generación es gratis. Cuando se ve bien, publica, conecta un dominio y deja que el TLS se resuelva solo.

¿Cómo se compara esto con desplegar en un host estático?

Los hosts estáticos son muy buenos en lo suyo. Si tu resultado es un bundle de frontend y nada más, lo van a servir más rápido, más barato y con un ecosistema más grande que el nuestro. La comparación se pone interesante cuando la aplicación necesita estado, usuarios y un camino de regreso.

Qué necesita la app | Fine Structure | Destino de deploy estático

Hosting | Páginas React alojadas desde el runtime de la plataforma | La mejor velocidad de frontend en bruto y el ecosistema más amplio

Base de datos | Entities administradas, listas antes del primer despliegue | La traes tú, se aprovisiona por separado

Autenticación | Incluida, con sesiones y usuarios por aplicación | Traes tu propio servicio o proveedor

Dominios | Dominio propio con TLS automático | Dominio propio con TLS automático, flujo maduro

Rollback | Restaurar una versión guardada de la aplicación | Volver a desplegar un build anterior o revertir el commit

Agentes | Agentes de IA que siguen trabajando según un calendario | No incluidos, se ejecutan en otro lado

Cuándo somos la elección equivocada: Tres casos en los que otra herramienta es mejor, y lo decimos. Un runtime de servidor propio que tiene que ser tuyo, por ejemplo un binario en Go o un worker en Python con librerías de sistema específicas. Un monorepo con su propio backend que no vas a reescribir. Hosting puramente estático a gran escala, donde gana un CDN sin base de datos.

¿Qué obtienes después del primer despliegue?

El despliegue no es el final del trabajo. Es donde la aplicación empieza a producir hechos en lugar de opiniones. Se abren cuatro cosas, y ninguna te obliga a salir de la conversación.

Los agentes son la parte que sorprende. Un agente aquí no es un widget de chat pegado a una página. Es un trabajador conectado a la aplicación que sigue corriendo según un calendario después de que cierras la laptop, lee los datos de la propia app y puede escribirle a su dueño verificado por WhatsApp o por correo. La aplicación te avisa que pasó algo en lugar de esperar a que la revises.

Todo lo que sigue a la generación se queda en la misma sesión de Claude: cambiar un archivo, publicar, revisar el dominio, leer la analítica, ajustar un agente. El plan gratuito no pide tarjeta, así que la forma honesta de evaluar esto es apuntar Claude a una app real y pequeña y ver hasta dónde llega.

Preguntas frecuentes

¿Claude Code puede desplegar una app por sí solo?

Solo no. Claude Code escribe y edita archivos, y necesita un destino capaz de alojarlos. Agrega nuestro conector MCP o instala el plugin y desplegar se vuelve una llamada de herramienta: crear la app, escribir archivos, publicar y conectar un dominio.

¿Cuál es la URL del servidor MCP de Fine Structure?

https://finestructure.ai/api/mcp. En claude.ai abre la configuración, elige Add custom connector, pega esa URL y aprueba la pantalla de OAuth. No hay API key que copiar, y Claude pasa a ver alrededor de 70 herramientas.

¿Cómo instalo el plugin de despliegue de Claude Code?

Ejecuta /plugin marketplace add finestructure-ai/claude-plugin y luego /plugin install finestructure@finestructure. Obtienes /deploy, /fs-status y /fs-domain. El plugin es open source y nuestras postulaciones a directorios están en revisión, así que no reclamamos estatus oficial.

¿Hay un plan gratuito y hace falta tarjeta de crédito?

Hay un plan gratuito y no pide tarjeta. Generar una app consume créditos. Editar archivos, publicar y usar dominios propios, no.

¿Puedo desplegar un proyecto React existente en lugar de generar uno nuevo?

Sí. Claude lo migra al runtime de la plataforma archivo por archivo: las páginas se vuelven páginas de la plataforma, el modelo de datos se vuelve entities y las llamadas de autenticación se reescriben. Es una migración, no una subida, así que espera que los archivos cambien de forma.

¿La plataforma se encarga de HTTPS y dominios propios?

Sí. Agrega un dominio propio y el TLS se emite de forma automática. Usa /fs-domain desde la terminal o pídeselo a Claude a través del conector MCP.

¿Qué pasa si un despliegue rompe la aplicación?

Restaura una versión guardada. El rollback devuelve la app a un estado guardado anterior, que suele ser más rápido que diagnosticar un cambio en producción y te deja una base funcionando.

¿Cuándo es la herramienta equivocada?

Cuando necesitas un runtime de servidor propio que tiene que ser tuyo, por ejemplo un binario en Go o un worker en Python con librerías de sistema específicas. Cuando un monorepo conserva su propio backend. O cuando quieres hosting puramente estático a gran escala, donde gana un CDN sin base de datos.