Laat Claude Code je app deployen met de MCP-server van Nodion

Coding agents zoals Claude Code schrijven en testen je code al. Met de MCP-server van Nodion kunnen ze die ook live zetten: een project aanmaken, de app deployen, een database koppelen en de logs bekijken. Dankzij de toestemmingsverzoeken van Claude Code houd je zelf de controle.

Wat je nodig hebt

• Claude Code v1.2 of nieuwer
• Een Nodion-account, of de mogelijkheid om je via de agent te registreren (zie hieronder)
• Een persoonlijke sleutel uit Account → Security in het dashboard

Nog geen account?

Laat Claude Code je eerst registreren: vraag de agent om nodion.com/auth.md te volgen of nodion login in de shell uit te voeren. Je keurt de registratie goed in je browser en gaat daarna verder met stap 1.

Stap 1: maak een persoonlijke sleutel aan

Open in het Nodion-dashboard Account → Security en maak een persoonlijke sleutel aan. Geef de sleutel alleen de benodigde scopes, beperk hem desgewenst tot één project en stel een vervaldatum in. De sleutel wordt maar één keer getoond, dus kopieer hem meteen.

Stap 2: voeg de Nodion-server toe

claude mcp add nodion --transport http https://mcp.nodion.net/mcp \
  --header "Authorization: Bearer nodion_…"

Vervang nodion_… door je sleutel. Nodion host de MCP-server, dus je hoeft op je eigen machine niets te installeren of draaiende te houden.

Stap 3: vraag het in gewone taal

Zodra de verbinding er is, beschrijf je wat je wilt. Een paar prompts die goed werken:

• “Maak een Nodion-project met de naam shop aan en deploy deze repository.”
• “Deploy Twenty op Nodion in Frankfurt.”
• “Koppel een PostgreSQL-database aan de app en deploy opnieuw.”
• “Laat me de nieuwste fouten in de logs van de app zien.”

Claude Code vraagt om je toestemming voordat het een tool uitvoert, tenzij je die tool permanent hebt toegestaan. Controleer daarom je toestemmingsinstellingen. Voor persoonlijke sleutels vereist Nodion bovendien een expliciete bevestigingsvlag (confirm) bij schrijftools. De agent zet die vlag zelf, dus je moet de toolaanroep nog steeds zelf controleren.

Wat de agent achter de schermen doet

Voor een app die je met één klik deployt, vraagt de agent de catalogus op met presets.list, haalt hij de app op met presets.get en maakt hij die aan met apps.create en een preset_key. De eerste release start zodra de gekoppelde databases klaar zijn, dus de agent vraagt herhaaldelijk apps.get op en meldt daarna de URL.

Voor een map die geen Git-repository is, maakt de agent een app aan met door Nodion beheerde Git, vraagt hij een push-remote aan met apps.git_remote en pusht hij de code met GIT_ASKPASS. Zo komt het wachtwoord nooit in een URL, de shellgeschiedenis of de chat terecht. Daarna start hij de deployment.

Andere agents

• Cursor: met één klik verbinden via de koppelpagina, met een sleutel uit Account → Security.
• Claude Desktop: voeg een custom connector toe met de URL https://mcp.nodion.net/mcp en log in met OAuth. Geen sleutel nodig.
• ChatGPT en Codex: ook inloggen met OAuth.
• Windsurf, Zed, VS Code Copilot, OpenCode en eigen agents: laat ze naar https://mcp.nodion.net/mcp wijzen. In de MCP-documentatie staan configuratiefragmenten.

Beveiligingstips

• Gebruik voor elke agent een eigen sleutel en trek die in via Account → Security zodra je hem niet meer nodig hebt.
• Plak de sleutel of ~/.config/nodion/config.yml nooit in een chat.
• Bewaar secrets in het dashboard. De agent hoeft hun waarden niet te zien.
• Lees het toestemmingsverzoek van Claude Code voordat je een toolaanroep goedkeurt die iets wijzigt.

Wil je het met een echte app proberen? Vraag je agent om n8n te deployen of een app uit de catalogus met apps die je met één klik deployt.