---
title: "Stockage S3 par MCP pour votre appli, avec while.sh"
url: https://while.sh/fr/guides/stocker-des-fichiers/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-02
---

# Stocker les fichiers de votre appli dans un bucket S3, depuis votre agent IA

Vos utilisateurs envoient des photos ou des PDF ? Demandez un bucket à votre agent : branché à while par MCP, il le déclare en deux lignes, et votre appli s'y branche avec le SDK d'AWS.

## Prérequis

- Une appli Node.js, Python ou Go.
- 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.
```

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 « 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 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`. Sa clé arrive là où le SDK d'AWS la 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,
});
```

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

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

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

## Garder la clé du bucket secrète

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

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

## Ajouter une base de données

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

Votre agent déclare la base dans while.yaml, et son adresse arrive à votre code dans `DATABASE_URL`. Elle est sauvegardée chaque jour, et revient à un instant précis si besoin.

## Réserver votre 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 code reçoit leur nom et leur adresse électronique, sans page de connexion à écrire.

## 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/)
- [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.