---
title: "Les fichiers de votre appli dans un bucket S3 en 2026, en France"
url: https://while.sh/fr/guides/stocker-des-fichiers/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-19
---

# Stocker les fichiers de votre appli dans un bucket S3, avec votre IA (2026)

Les personnes qui se servent de votre appli envoient des photos ou des PDF ? Demandez un bucket à votre IA : connectée à while par MCP, elle le déclare en deux lignes, et votre appli s'y connecte avec le SDK d'AWS.

> **Ce qu'il faut retenir.** Par MCP, votre IA ajoute un bucket S3 à votre appli en deux lignes : chiffré, versionné, hébergé en France. Votre IA ne voit jamais ses identifiants. Ce qui compte, comme supprimer une base, attend la validation d'une personne.

## Prérequis

- Une appli Node.js, Python ou Go.
- 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 appli, et collez-lui cette phrase :

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

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 « Une nouvelle appli », puis cliquez sur Autoriser.

## Étape 2 : Ouvrez votre appli

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

## Ce que fait votre IA

Elle ajoute deux lignes à while.yaml :

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

Le nom du bucket arrive à votre appli dans `S3_BUCKET_UPLOADS`, l'adresse du stockage dans `S3_ENDPOINT` et sa région dans `S3_REGION`. Ses identifiants arrivent là où le SDK d'AWS les cherche de lui-même (source 1) :

```js titre="server.js"
import { S3Client } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  forcePathStyle: true,
});
```

<figure class="illus"><img src="/illustrations/guide-fonction-garde-1200.webp" srcset="/illustrations/guide-fonction-garde-768.webp 768w, /illustrations/guide-fonction-garde-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="Un bucket S3 pour les fichiers avec while : les identifiants gardés hors de portée de l'IA, chaque appel noté dans l'historique, la validation d'une personne pour ce qui compte et la sauvegarde de chaque jour, en France" /><figcaption>Autour de chaque appli, while garde les identifiants, l'historique, les validations et les sauvegardes.</figcaption></figure>

## Récupérer un fichier effacé par erreur

> Vous, à votre IA : Remets la facture effacée hier.

Le bucket garde l'ancien contenu d'un fichier remplacé ou effacé pendant 30 jours, et votre IA le remet en place.

## Garder les identifiants du bucket secrets

> Vous, à votre IA : Donne-moi la clé du bucket.

Votre IA ne la voit jamais : elle n'arrive qu'à votre appli, dans ses variables.

## Ajouter une base de données

> Vous, à votre IA : Ajoute une base PostgreSQL.

Votre IA déclare la base dans while.yaml, et son adresse arrive à votre code dans `DATABASE_URL`. La base est sauvegardée chaque jour, avec un retour possible à un instant précis sur 14 jours.

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

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

Votre IA rend le service interne :

```yaml titre="while.yaml"
    access: internal
```

Puis elle demande le rôle Accès pour votre domaine, @acme.fr, sur cette appli, et une personne de votre organisation le valide.

Une fois votre Google Workspace ou Microsoft 365 relié à while, avec l'offre Pro, vos collègues s'y connectent avec le compte de leurs mails, et votre code reçoit leur nom et leur adresse électronique, sans page de connexion à écrire.

## Revenir à la version d'avant

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

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

## Prochaines étapes

- [Mettre en production une API Node.js et sa base PostgreSQL](/fr/guides/api-node-postgresql/)
- [Ajouter un cache compatible Redis](/fr/guides/cache-redis/)
- [Comparer les hébergeurs qui ont un serveur MCP](/fr/comparatifs/hebergement-appli-claude-code/)

## Sources

1. [AWS SDK pour JavaScript v3, où le SDK cherche sa clé en Node.js (les variables d'environnement d'abord)](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html), 2026-11-02

## Questions

### Combien coûte le stockage ?

0,25 € les 10 Gio par mois, requêtes comprises.

### Mes fichiers sont-ils chiffrés ?

Oui, et chaque bucket est propre à votre organisation.

### Avec quel SDK ?

Le SDK S3 d'AWS, ou tout client compatible S3.

### Où tournent mon appli et ses données ?

En France, chez Nextmap. La base est sauvegardée chaque jour, avec un retour possible sur 14 jours, une fois qu'une personne a validé.

### Mon IA voit-elle mes identifiants ?

Non. Vous les collez dans while, l'appli s'en sert, et votre IA ne les voit jamais. Chaque appel est noté.
