---
title: "Déployer Next.js par MCP, avec while.sh"
url: https://while.sh/fr/guides/mettre-en-ligne-nextjs/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-02
---

# Mettre en ligne une appli Next.js depuis votre agent IA, par MCP

Votre agent IA a écrit votre appli Next.js. Branché à while par MCP, il la met aussi en ligne, en HTTPS, et vous choisissez qui l'ouvre : tout le monde, vos clients ou vos collègues.

## Prérequis

- Une appli Next.js.
- Un agent IA qui travaille dans un terminal : Claude Code, Codex, Cursor ou Gemini CLI.

## Étape 1 : Donnez ces instructions à votre agent

Ouvrez votre agent dans le dossier de votre appli, et collez-lui ces instructions :

```text titre="Instructions"
Connecte-toi à while avec mon compte (while.sh/agents), puis mets mon appli en ligne.
```

Sans compte, votre agent met votre appli en ligne à l'essai, en une demande. Pour la garder, ouvrez le lien qu'il vous donne et créez votre compte.

Avec votre compte, votre agent ajoute lui-même le serveur MCP de while. S'il vous le demande, relancez-le. 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 appli

Votre agent vous donne l'adresse de votre appli, par exemple `https://mon-appli.while.cloud`, en HTTPS.

## Ce que fait votre agent

Il écrit while.yaml à la racine de votre appli :

```yaml titre="while.yaml"
apiVersion: while/v1
project: mon-appli
services:
  - name: web
    port: 3000
    health:
      path: /
```

Le port 3000 est celui de `next start`, qui lit la variable `PORT` (source 1). Votre appli est construite, ses tests tournent, puis elle démarre. Elle ne reçoit des visiteurs qu'une fois sa page d'accueil prête.

## Réserver l'appli à vos collègues

> Vous, à votre agent : Réserve l'appli aux personnes de l'entreprise.

Votre agent ajoute deux lignes au service :

```yaml titre="while.yaml"
    access: internal
    email_domains: [acme.fr]
```

Une fois votre Google Workspace ou Microsoft 365 relié à while, avec l'offre Pro, vos collègues l'ouvrent avec leur compte habituel, et votre appli reçoit leur nom et leur adresse électronique, sans page de connexion à écrire.

## Montrer votre appli à un client, avec un mot de passe

> Vous, à votre agent : Ouvre l'appli à notre client, avec un mot de passe.

Votre agent réserve l'appli, puis, sur la page de l'appli dans while, vous créez un lien de 1, 7 ou 30 jours, avec un mot de passe que votre agent ne verra jamais.

## Ajouter une base de données

> Vous, à votre agent : Ajoute une base PostgreSQL pour les réservations.

Votre agent déclare la base dans while.yaml, et son adresse arrive à votre appli dans `DATABASE_URL`. Elle est sauvegardée chaque jour. Le détail est dans la recette de l'API Node.js et de sa base PostgreSQL.

## Mettre l'appli sur votre domaine

> Vous, à votre agent : Mets l'appli sur planning.acme.fr.

Votre agent déclare le domaine, vous ajoutez les enregistrements DNS qu'il vous donne, et le certificat HTTPS suit.

## Voir une nouvelle version avant de la mettre en ligne

> Vous, à votre agent : Montre-moi la nouvelle page avant de la mettre en ligne.

Votre agent ouvre une prévisualisation, à son adresse à elle, avec ses propres données. Vous la regardez, puis il la met en production.

## Revenir à la version d'avant

> Vous, à votre agent : Reviens à la version d'avant.

Dans les 30 minutes qui suivent une mise en ligne, la version d'avant revient en une seconde. Ensuite, en quelques secondes. Une fois la version d'avant revenue, votre agent lit ce qui a cassé dans les journaux de while, corrige et remet en ligne.

## Prochaines étapes

- [Mettre en ligne une API Node.js et sa base PostgreSQL](/fr/guides/api-node-postgresql/)
- [Réserver votre appli aux personnes de votre entreprise](/fr/guides/outil-interne-compte-entreprise/)
- [Comparer les hébergeurs qui ont un serveur MCP](/fr/comparatifs/hebergement-appli-claude-code/)

## Sources

1. [Next.js, la commande next et ses options (next start, PORT)](https://nextjs.org/docs/app/api-reference/cli/next), 2026-11-01

## Questions

### Faut-il changer mon code pour quitter Vercel ?

Non. Une appli Next.js qui démarre avec next start passe telle quelle, et votre agent reporte vos variables d'environnement.

### Faut-il écrire un Dockerfile ?

Non. Votre appli Next.js est reconnue comme une appli Node, construite et démarrée sans Dockerfile. Si votre projet en a un, il sert à construire l'image.

### Mon appli Next.js reçoit-elle le nom de la personne connectée ?

Oui. Réservée à votre entreprise, elle reçoit le nom et l'adresse électronique de la personne connectée, sans écrire de page de connexion.

### Et si mon appli n'est pas en Next.js ?

Express, NestJS, Nuxt, Vite avec React, un site Astro et un serveur Go se mettent en ligne de la même façon.