Lascia che Claude Code faccia il deploy della tua app con il server MCP di Nodion
In breve
- Nodion ospita un server MCP remoto su mcp.nodion.net/mcp, quindi Claude Code non ha bisogno di un daemon locale.
- Un solo comando e una chiave personale da Account → Security collegano Claude Code al tuo account Nodion.
- Il tuo agente può creare progetti, fare il deploy di un repository o di un'app con un clic, collegare database, impostare variabili d'ambiente e leggere i log; Claude Code chiede conferma prima di eseguire un tool, a meno che tu non l'abbia autorizzato in modo permanente.
- Funzionano anche Cursor, Claude Desktop, ChatGPT e Codex; vedi Collega Nodion al tuo agente.
I coding agent come Claude Code scrivono e testano già il tuo codice. Con il server MCP di Nodion possono anche metterlo online: creare un progetto, fare il deploy dell'app, collegare un database e controllare i log, mentre le richieste di autorizzazione di Claude Code ti permettono di mantenere il controllo.
Cosa ti serve
- Claude Code v1.2 o successivo
- Un account Nodion, oppure chiedi all'agente di aiutarti a registrarti (vedi sotto)
- Una chiave personale da Account → Security nella dashboard
Non hai ancora un account?
Per registrarti con Claude Code, chiedigli di seguire nodion.com/auth.md o di eseguire nodion login nella sua shell. Conferma la registrazione nel browser, poi prosegui con il passo 1.
Passo 1: crea una chiave personale
Nella dashboard di Nodion apri Account → Security e crea una chiave personale. Assegnale solo gli scope che le servono, limitala a un progetto se vuoi e imposta una data di scadenza. La chiave viene mostrata una sola volta, quindi copiala subito.
Passo 2: aggiungi il server Nodion
claude mcp add nodion --transport http https://mcp.nodion.net/mcp \
--header "Authorization: Bearer nodion_…" Sostituisci nodion_… con la tua chiave. Il server MCP è ospitato da Nodion, quindi sulla tua macchina non c'è nulla da installare né da tenere in esecuzione.
Passo 3: scrivi la tua richiesta in linguaggio naturale
Una volta connesso, descrivi cosa vuoi ottenere. Alcuni prompt che funzionano bene:
- “Crea un progetto Nodion chiamato shop e fai il deploy di questo repository.”
- “Fai il deploy di Twenty su Nodion a Francoforte.”
- “Collega un database PostgreSQL all'app e rifai il deploy.”
- “Mostrami gli ultimi errori nei log dell'app.”
Claude Code ti chiede l'autorizzazione prima di eseguire un tool, a meno che tu non l'abbia autorizzato in modo permanente, quindi tieni d'occhio le sue impostazioni dei permessi. Per le chiavi personali Nodion richiede inoltre un flag di conferma esplicito sui tool di scrittura, ma è l'agente a impostare quel flag, quindi non sostituisce la tua verifica.
Cosa fa l'agente dietro le quinte
Per un'app del catalogo con deploy in un clic, l'agente elenca il catalogo con presets.list, carica l'app con presets.get e la crea con apps.create e il parametro preset_key. La prima release parte quando i database collegati sono pronti, quindi l'agente consulta periodicamente apps.get e poi ti comunica l'URL.
Per una cartella che non è un repository Git, l'agente crea un'app con Git gestito da Nodion, richiede un indirizzo remoto per il push con apps.git_remote e fa il push del codice con GIT_ASKPASS. Così la password non finisce mai in un URL, nella cronologia della shell o nella chat. Poi avvia il deploy.
Altri agenti
- Cursor: installazione in un clic dalla pagina di connessione, con una chiave da Account → Security.
- Claude Desktop: aggiungi un connettore personalizzato con l'URL
https://mcp.nodion.net/mcpe accedi con OAuth. Nessuna chiave necessaria. - ChatGPT e Codex: accedi con OAuth anche da questi client.
- Windsurf, Zed, VS Code Copilot, OpenCode e agenti personalizzati: puntali su
https://mcp.nodion.net/mcp. La documentazione MCP contiene snippet di configurazione.
Consigli di sicurezza
- Usa una chiave dedicata per ogni agente e revocala in Account → Security quando non ti serve più.
- Non incollare mai la chiave o
~/.config/nodion/config.ymlin una chat. - Conserva i secret nella dashboard. L'agente non ha bisogno di vederne i valori.
- Leggi la richiesta di autorizzazione di Claude Code prima di approvare una chiamata a un tool che modifica qualcosa.
Vuoi provarlo con un'app vera? Chiedi al tuo agente di fare il deploy di n8n o di qualsiasi app del catalogo con un clic.
Domande frequenti
Che cos'è MCP?
Il Model Context Protocol è uno standard aperto che permette agli agenti AI di usare strumenti e servizi esterni. Un server MCP descrive le azioni che offre e l'agente le richiama per conto tuo.
Come collego Claude Code a Nodion?
Crea una chiave personale in Account → Security, poi esegui: claude mcp add nodion --transport http https://mcp.nodion.net/mcp --header "Authorization: Bearer nodion_…". Serve Claude Code v1.2 o successivo.
Mi serve prima un account Nodion?
No. Chiedi al tuo agente di seguire nodion.com/auth.md o di eseguire nodion login, poi approva la registrazione nel browser.
È sicuro lasciare il deploy a un agente?
Claude Code chiede l'autorizzazione prima di eseguire un tool, a meno che tu non l'abbia autorizzato in modo permanente, quindi controlla le sue impostazioni dei permessi. Tieni i secret nella dashboard e non incollare mai la tua chiave API o il file di configurazione della CLI nella chat.