---
title: "Déployer Astro avec rendu serveur par MCP, avec while.sh"
url: https://while.sh/fr/guides/appli-astro-serveur/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-02
---

# Mettre en ligne un site Astro avec rendu serveur depuis votre agent IA, par MCP

Votre site Astro rend certaines pages à la demande. Branché à while par MCP, votre agent IA le met en ligne en France avec l'adaptateur Node, sans Dockerfile, et vous choisissez qui l'ouvre.

## Prérequis

- Un site Astro qui rend des pages à la demande : votre agent ajoute l'adaptateur Node s'il manque.
- 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 site, 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 site en ligne à l'essai, en une demande. Pour le 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 site

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

## Ce que fait votre agent

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

```yaml titre="while.yaml"
apiVersion: while/v1
project: mon-site
services:
  - name: web
    port: 4321
    health:
      path: /
    env:
      HOST: 0.0.0.0
```

Votre site est construit, puis démarré par le serveur autonome d'Astro, qui lit `HOST` et le port reçu dans `PORT` (source 1). Votre agent vérifie aussi que le script `start` de votre package.json lance bien `node ./dist/server/entry.mjs`, et pas le serveur de développement.

## Réserver votre site à vos collègues

> Vous, à votre agent : Réserve le site 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 code reçoit leur nom et leur adresse électronique, sans page de connexion à écrire.

## Partager avec un client, protégé par un mot de passe

> Vous, à votre agent : Ouvre le site à 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.

## Passer sur votre propre domaine

> Vous, à votre agent : Mets le site sur app.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 version 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 un site statique](/fr/guides/site-statique/)
- [Mettre en ligne une appli SvelteKit](/fr/guides/appli-sveltekit/)
- [Mettre votre appli sur votre nom de domaine](/fr/guides/nom-de-domaine/)

## Sources

1. [Astro, l'adaptateur Node (mode autonome, HOST et PORT)](https://docs.astro.build/en/guides/integrations-guide/node/), 2026-11-02

## Questions

### Faut-il écrire un Dockerfile ?

Non. Astro avec son adaptateur Node est reconnu, construit et démarré par son serveur autonome.

### Et un site Astro tout statique ?

Il se met en ligne comme un site statique : son dossier dist est servi avec un cache HTTP.

### Où est hébergé mon site ?

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