Deja que Claude Code despliegue tu app con el servidor MCP de Nodion
En resumen
- Nodion aloja un servidor MCP remoto en mcp.nodion.net/mcp, así que Claude Code no necesita ningún daemon local.
- Un comando y una clave personal de Account → Security conectan Claude Code con tu cuenta de Nodion.
- Tu agente puede crear proyectos, desplegar un repositorio o una app de un clic, vincular bases de datos, configurar variables de entorno y leer logs; Claude Code pregunta antes de ejecutar una herramienta, salvo que la hayas permitido de forma permanente.
- Cursor, Claude Desktop, ChatGPT y Codex también funcionan; consulta cómo conectar Nodion a tu agente.
Los agentes de programación como Claude Code ya escriben y prueban tu código. Con el servidor MCP de Nodion también pueden ponerlo en producción: crean un proyecto, despliegan la app, vinculan una base de datos y revisan los logs. Las solicitudes de permiso de Claude Code te mantienen al mando.
Qué necesitas
- Claude Code v1.2 o posterior
- Una cuenta de Nodion, o deja que el agente te ayude a registrarte (ver más abajo)
- Una clave personal de Account → Security en el dashboard
¿Aún no tienes cuenta?
Deja que Claude Code te ayude a registrarte: pídele que siga nodion.com/auth.md o que ejecute nodion login en su terminal. Aprueba el registro en tu navegador y continúa con el paso 1.
Paso 1: crea una clave personal
En el dashboard de Nodion, abre Account → Security y crea una clave personal. Dale solo los permisos que necesite, limítala a un proyecto si quieres y fija una fecha de caducidad. La clave solo se muestra una vez, así que cópiala enseguida.
Paso 2: añade el servidor de Nodion
claude mcp add nodion --transport http https://mcp.nodion.net/mcp \
--header "Authorization: Bearer nodion_…" Sustituye nodion_… por tu clave. Nodion aloja el servidor MCP, así que no tienes que instalar ni mantener nada en marcha en tu ordenador.
Paso 3: pídelo con tus palabras
Una vez conectado, describe lo que quieres. Algunos prompts que funcionan bien:
- “Crea un proyecto de Nodion llamado shop y despliega este repositorio.”
- “Despliega Twenty en Nodion en Fráncfort.”
- “Conecta una base de datos PostgreSQL a la app y vuelve a desplegarla.”
- “Muéstrame los últimos errores en los logs de la app.”
Claude Code te pide permiso antes de ejecutar una herramienta, salvo que la hayas permitido de forma permanente, así que vigila su configuración de permisos. Nodion además exige un flag de confirmación explícito en las herramientas de escritura para claves personales, pero ese flag lo pone el agente, así que no sustituye a tu propia revisión.
Qué hace el agente entre bastidores
Para una app de un clic, el agente consulta el catálogo con presets.list, carga el preset con presets.get y crea la app con apps.create y un preset_key. La primera release arranca cuando las bases de datos vinculadas están listas, así que el agente consulta apps.get periódicamente y después te da la URL.
Si la carpeta no es un repositorio Git, el agente crea una app con Git gestionado por Nodion, solicita un repositorio remoto para hacer push con apps.git_remote y sube el código con GIT_ASKPASS. Así, la contraseña nunca acaba en una URL, en el historial de la terminal ni en el chat. Después inicia el despliegue.
Otros agentes
- Cursor: instalación en un clic desde la página de conexión, con una clave de Account → Security.
- Claude Desktop: añade un conector personalizado con la URL
https://mcp.nodion.net/mcpe inicia sesión con OAuth. No necesitas clave. - ChatGPT y Codex: inicia sesión también con OAuth.
- Windsurf, Zed, VS Code Copilot, OpenCode y agentes propios: apúntalos a
https://mcp.nodion.net/mcp. En la documentación de MCP tienes snippets de configuración.
Consejos de seguridad
- Usa una clave distinta para cada agente y revócala en Account → Security cuando ya no la necesites.
- Nunca pegues la clave ni
~/.config/nodion/config.ymlen un chat. - Guarda los secretos en el dashboard. El agente no necesita ver sus valores.
- Lee la solicitud de permiso de Claude Code antes de aprobar una llamada a una herramienta que cambie algo.
¿Quieres probarlo con una app real? Pídele a tu agente que despliegue n8n o cualquier app del catálogo de un clic.
Preguntas frecuentes
¿Qué es MCP?
El Model Context Protocol es un estándar abierto que permite a los agentes de IA usar herramientas y servicios externos. Un servidor MCP describe las acciones que ofrece y el agente las ejecuta en tu nombre.
¿Cómo conecto Claude Code con Nodion?
Crea una clave personal en Account → Security y ejecuta: claude mcp add nodion --transport http https://mcp.nodion.net/mcp --header "Authorization: Bearer nodion_…". Necesitas Claude Code v1.2 o posterior.
¿Necesito antes una cuenta de Nodion?
No. Pídele a tu agente que siga nodion.com/auth.md o que ejecute nodion login. Después, aprueba el registro en tu navegador.
¿Es seguro dejar que un agente despliegue?
Claude Code pide permiso antes de ejecutar una herramienta, salvo que la hayas permitido de forma permanente, así que revisa su configuración de permisos. Guarda los secretos en el dashboard y nunca pegues tu clave de API ni el archivo de configuración de la CLI en el chat.