Aller au contenu

Mettre une API Node.js et sa base PostgreSQL en production avec votre IA, par MCP (2026)

Votre IA sait déjà écrire votre API Node.js. Connectée à while par MCP, elle la met aussi en production, avec sa base PostgreSQL sauvegardée chaque jour, et vous ne touchez à aucun serveur.

Par Aloïs Oddon, cofondateur de Nextmap. Faits relevés le 19 novembre 2026.

Voir en Markdown

Mettre une API Node.js et sa base PostgreSQL en production avec votre IA, par MCP : héberger une API Node.js et sa base PostgreSQL en France, mise en production par Claude Code, Cursor ou Codex en HTTPS, avec la base sauvegardée chaque jour

Ce qu’il faut retenir. Par MCP, votre IA met votre API Node.js et sa base PostgreSQL en production avec while. Puis elle gère Prisma, les sauvegardes et la taille de la base. Ce qui compte, comme supprimer une base, attend la validation d’une personne.

Prérequis

  • Une API Node.js.
  • Une IA qui travaille dans un terminal : Claude Code, Codex, Cursor ou Gemini CLI.

Étape 1 : Donnez cette phrase à votre IA

Ouvrez votre IA dans le dossier de votre API, et collez-lui cette phrase :

La phrase à donner à votre IA
Connecte-toi à while avec mon compte (while.sh/agents), puis mets mon appli sur while.

Sans compte, votre IA met votre API en production à l’essai, en une demande. Pour la garder, ouvrez le lien qu’elle vous donne et créez votre compte.

Avec votre compte, votre IA ajoute elle-même le serveur MCP de while. Si elle vous le demande, relancez-la. Au premier appel à while, une page s’ouvre dans votre navigateur. Dans Claude Code, si elle ne s’ouvre pas, tapez /mcp, choisissez while, puis Authenticate. Sur cette page, choisissez votre appli, ou « Une nouvelle appli », puis cliquez sur Autoriser.

Étape 2 : Ouvrez votre API

Votre IA vous donne l’adresse de votre API, par exemple https://mon-api.while.cloud.

Ce que fait votre IA

Elle lit les règles d’une appli sur while, comme écouter sur PORT et répondre 200 sur /health, puis écrit while.yaml à la racine de votre API :

while.yaml
apiVersion: while/v1
project: mon-api
services:
  - name: web
    port: 3000
databases:
  - name: main

Les deux dernières lignes ajoutent une base PostgreSQL. Son adresse, mot de passe compris, arrive à votre API dans DATABASE_URL. node-postgres la lit telle quelle1, comme dans cette API Express essayée sur while :

server.js
import express from 'express';
import pg from 'pg';

const db = new pg.Pool({ connectionString: process.env.DATABASE_URL });
await db.query('CREATE TABLE IF NOT EXISTS visites (id serial PRIMARY KEY, cree_le timestamptz DEFAULT now())');

const app = express();
app.get('/health', (_req, res) => res.send('ok'));
app.get('/', async (_req, res) => {
  await db.query('INSERT INTO visites DEFAULT VALUES');
  const { rows } = await db.query('SELECT count(*)::int AS n FROM visites');
  res.send(`visites : ${rows[0].n}`);
});
app.listen(process.env.PORT || 3000, '0.0.0.0');

Elle envoie ensuite le code, qui est construit, testé, puis mis en production.

Ce que fait votre IA pour mettre une API Node.js et sa base PostgreSQL en production sur while : le fichier while.yaml, la construction et les tests, l'adresse en HTTPS, la base PostgreSQL sauvegardée chaque jour et la validation d'une personne, en France
Votre IA écrit while.yaml, while construit et met l'appli en HTTPS, et la version d'avant reste prête.

Choisir la version de PostgreSQL

Vous, à votre IA : Crée la base sous PostgreSQL 18.

La version se choisit à la création : PostgreSQL 17 par défaut, la 16 ou la 18 avec version dans while.yaml :

while.yaml
databases:
  - name: main
    version: "18"

Prévoir l’espace disque

Vous, à votre IA : Crée la base avec 10 Gio de disque.

Le disque se choisit à la création de la base, avec size : 1 Gio par défaut. Demandez-le avant la première mise en production.

while.yaml
databases:
  - name: main
    size: 10Gi

Utiliser Prisma avec PostgreSQL

Vous, à votre IA : Utilise Prisma pour créer et migrer les tables.

Votre IA écrit le schéma et fait jouer la migration au démarrage de l’API. Prisma lit l’adresse de la base dans DATABASE_URL :

prisma/schema.prisma
generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}
package.json (extrait)
"type": "module",
"scripts": {
  "build": "prisma generate",
  "start": "prisma migrate deploy && node server.js"
},
"dependencies": {
  "@prisma/client": "^6.1.0",
  "prisma": "^6.1.0"
}

Prisma va dans dependencies : l’API en production est installée sans les devDependencies. Inutile d’ajouter ?pgbouncer=true à l’adresse : PgBouncer suit les requêtes préparées.

Votre IA ne déclare pas de directUrl : l’adresse directe de la base n’est donnée qu’aux tâches, et Prisma s’arrêterait au démarrage avec l’erreur P1012.

Interroger PostgreSQL depuis votre IA, par MCP

Vous, à votre IA : Combien de visites aujourd’hui ?

Votre IA lit votre base en SQL par le serveur MCP de while, avec vos droits sur les données, sans pouvoir y écrire. Chaque requête est notée dans l’historique de while, ses valeurs remplacées par $1, $2…

Exporter une table en CSV

Vous, à votre IA : Exporte la table visites en CSV.

Votre IA écrit la table dans un fichier CSV, avec les mêmes droits que pour la lire.

Trouver les requêtes lentes

Vous, à votre IA : Quelles requêtes ralentissent la base ?

Votre IA lit les requêtes les plus fréquentes et les plus lentes de votre base, relevées par pg_stat_statements.

Changer la taille de la base

Vous, à votre IA : Passe la base en taille M.

Votre IA change compute dans while.yaml. Avant le changement, elle voit ce qu’il coûte en plus par mois. La base redémarre ensuite, en une quinzaine de secondes.

Taille (compute)ProcesseurMémoireClients en même tempsPrix, hors taxes
S, par défaut0,1 vCPU256 Mo, jusqu’à 1 Go2005 € par mois
M0,5 vCPU1 Go40017 € par mois
L1 vCPU4 Go60065 € par mois
XL2 vCPU8 Go800150 € par mois
while.yaml
databases:
  - name: main
    compute: M

Ajouter une instance de secours

Vous, à votre IA : Ajoute une instance de secours à la base.

Avec instances: 2, une seconde instance est tenue à jour en continu, sur son propre disque, et prend le relais si la première tombe. Avec l’offre Entreprise, une base de production a deux instances par défaut.

Sauvegarder avant un changement

Vous, à votre IA : Fais une sauvegarde avant la migration.

Votre IA lance une sauvegarde, aussitôt suivie d’un essai : une base jetable en naît, et ses tables sont relues. Chaque base est aussi sauvegardée tous les jours, et ses changements sont archivés en continu.

Revenir à une sauvegarde ou à une heure précise

Vous, à votre IA : Remets la base comme hier à 18 h.

Votre base revient à une sauvegarde ou à un instant précis, dans la limite de leur conservation : 14 jours. En production, votre IA vous donne un lien : la base ne revient qu’une fois la restauration validée, par vous ou par un administrateur selon vos droits. Une sauvegarde de sûreté part avant, puis la base restaurée prend la place de l’ancienne.

Comprendre une mise en production qui échoue

Vous, à votre IA : Pourquoi la mise en production a échoué ?

Votre IA reçoit l’erreur et les dernières lignes des logs de construction. Vos tests tournent pendant la construction : s’ils échouent, votre API garde sa version d’avant.

Par exemple, connect ECONNREFUSED 127.0.0.1:5432 : vos tests cherchent une base, qui n’est pas connectée pendant la construction. Votre IA les écrit pour qu’ils passent sans elle, ou les coupe :

while.yaml
services:
  - name: web
    port: 3000
    build:
      skip_tests: true

Régler la session derrière PgBouncer

DATABASE_URL passe par PgBouncer en mode transaction : chaque transaction peut prendre une autre connexion. Un SET hors transaction ne dure que sa requête. Pour régler la session, utilisez SET LOCAL dans une transaction :

server.js
const client = await db.connect();
try {
  await client.query('BEGIN');
  await client.query("SET LOCAL statement_timeout = '5s'");
  await client.query('SELECT count(*) FROM visites');
  await client.query('COMMIT');
} catch (e) {
  await client.query('ROLLBACK');
  throw e;
} finally {
  client.release();
}

Ce qui a besoin de la session entière, comme pg_restore ou une migration qui fait des SET, tourne dans une automatisation, que votre IA lance aussi à la demande. La tâche reçoit l’adresse directe de la base dans DB_MAIN_DIRECT_URL.

Dans la doc : Bases PostgreSQL, Services web, Cache Valkey (Redis) et Versions et retour arrière.

Prochaines étapes

Sources

  1. node-postgres, se connecter avec une adresse de connexion (connectionString), consulté le 1er novembre 2026

Questions

Combien coûte une API Node.js avec sa base sur while ?

Avec l’offre Libre, vous ne payez que les ressources, hors taxes : 5 € par mois pour une base S, plus 0,25 € par Gio de disque, et pour l’API, 17 € par vCPU et 8,50 € par Gio de mémoire, par mois, selon sa consommation. Une API qui utilise au plus 0,25 vCPU et 0,5 Gio de mémoire paie au plus 8,50 € par mois, et 13,75 € avec une base S et son disque de 1 Gio.

Où est hébergée mon API ?

En France, par Nextmap, une entreprise française.

Mon API s’endort-elle quand personne ne l’appelle ?

Non, en production elle reste éveillée. Avec sleep: 30m dans while.yaml, elle s’endort après 30 minutes sans requête, et la première requête la réveille en quelques secondes.

Puis-je mettre mon API sur mon propre domaine ?

Oui. Votre IA déclare le domaine, vous ajoutez les deux enregistrements DNS qu’elle vous donne, et le certificat HTTPS est obtenu à la première visite.

Où mettre les identifiants d’API et les mots de passe de mon API ?

Jamais dans le code. L’identifiant d’une API externe se saisit dans while et s’ajoute à chaque appel : ni votre API ni votre IA ne le voient. Les autres secrets vont au coffre de while.

Puis-je faire tourner des traitements en fond ?

Oui. Demandez à votre IA un worker, pour un traitement qui tourne sans arrêt, ou une automatisation, pour un travail à heure fixe.

Je suis sur Heroku ou Render : comment venir ?

Votre IA reprend le code, recopie la base depuis un export (pg_dump) de Heroku ou de Render, restauré par une tâche, et reporte vos variables d’environnement.

Puis-je utiliser Express, Fastify ou NestJS ?

Oui, tout serveur Node.js qui démarre par un script de son package.json : start, ou start:prod pour NestJS. Express et NestJS ont déjà été mis en production en production sur while.

Puis-je ouvrir ma base dans pgAdmin ou avec psql ?

Non, la base ne s’ouvre pas depuis votre poste : votre IA la lit et l’exporte pour vous.

Faut-il régler SSL dans l’adresse de la base ?

Non, l’adresse de DATABASE_URL fonctionne telle quelle, sans sslmode.

Faut-il écrire un Dockerfile ?

Non. Sans Dockerfile dans votre dépôt, while en génère un pour votre API.

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh