# Ondes PRO Stockage & CDN : des fichiers en ligne pilotés par l’IA > Buckets publics ou privés, URLs immuables, miniatures à la volée : le stockage d’objets et CDN d’Ondes PRO se pilote par l’API et par votre IA via MCP. Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/modules/stockage-cdn Le **stockage d’objets d’Ondes PRO** range vos fichiers dans des **buckets**, publics ou privés, servis par un **CDN** sous `/cdn/`. Images de catalogue, fiches techniques en PDF, vidéos d’un site : votre assistant de code — Claude Code, Cursor, Visual Studio Code — crée les buckets par le **serveur MCP**, écrit le script de téléversement et produit des URLs **immuables** avec miniatures à la volée. Le tout dans le stockage de votre espace, sans service tiers à abonner. ## Sortir les photos du dépôt du site et les servir par le CDN _Exemple de conversation · données de démonstration (Atelier Lumen)_ > **Vous** : Crée un bucket public « visuels-catalogue » dans Ondes PRO, écris un script qui y téléverse public/img/collection, puis remplace les chemins des pages par les URLs du CDN, en miniatures de 640 px. > > 🔧 `ondes_ressource` Lit les fiches `stockage/buckets` et `stockage/objets` : champs, formats acceptés (multipart ou base64), paramètres d’image. > > 🔧 `ondes_guide` Lit la section du guide sur le stockage : formats d’envoi, URLs immuables, miniatures. > > 🔧 `ondes_appeler` `POST stockage/buckets` — bucket public « visuels-catalogue » créé. > > **Assistant** : Le bucket est prêt. J’ai écrit `scripts/televerser-visuels.mjs` : il envoie chaque image en multipart avec votre clé API, lue depuis `ONDES_API_KEY`, et garde la clé de chaque objet (`collection/suspension-petrole-1.jpg`…). Les pages utilisent maintenant l’URL renvoyée par l’API, avec son `?v=` immuable et `w=640` pour la miniature. Lancez le script, et je vérifie les 24 objets ensuite. > > **Vous** : C’est lancé. Tout est passé ? > > 🔧 `ondes_appeler` `GET stockage/objets?bucket=…` — 24 objets, 38 Mo ; 2 photos identiques n’ont été stockées qu’une fois. > > **Assistant** : Les 24 objets sont en ligne. Deux photos du Lampadaire Arc étaient identiques : elles partagent les mêmes octets, sans doublon dans votre espace de stockage. Vous pouvez retirer `public/img/collection` du dépôt. ## À quoi sert un stockage d’objets avec un serveur MCP ? Un **stockage d’objets** répond à un besoin simple : mettre des fichiers en ligne de façon fiable, avec une adresse stable, pour un site, une application ou un client. Le connecter à un **serveur MCP** permet à votre assistant de code de faire le travail d’intégration à votre place — créer les buckets, lire les quotas, écrire le script de téléversement, remplacer les chemins dans le code — en s’appuyant sur la documentation exacte de votre espace plutôt que sur des suppositions. Chaque objet est une **clé** dans un bucket (par exemple `collection/lampe-trepied.jpg`) qui pointe vers des octets identifiés par leur empreinte SHA-256. Cette séparation donne d’un coup la déduplication, la vérification d’intégrité et le cache longue durée. Le [hub du serveur MCP](https://ondes.pro/fr/integrations/mcp) présente les outils qui servent cette documentation. ## Ressources et actions de stockage dans l’API Le stockage d’objets accepte les clés API : téléverser depuis un script est son cas d’usage premier. | Ressource ou action | Rôle | | --- | --- | | `stockage/buckets` | Créer, lister et régler les buckets (public ou privé, quota facultatif). | | `stockage/objets` | Téléverser en multipart (`fichier`) ou en JSON (`contenu_base64` + `nom`), lister, renommer, supprimer. | | `…/buckets/{id}/usage/` | Ce que consomme un bucket, et le quota de sa société. | | `…/buckets/{id}/lien-televersement/` | Une adresse de dépôt direct, pour téléverser depuis un navigateur sans exposer de clé. | | `…/objets/{id}/lien-signe/` | Une URL de lecture temporaire pour un objet d’un bucket privé. | | `…/buckets/{id}/revoquer-liens/` | Invalide d’un coup tous les liens signés déjà distribués. | ## Les règles du CDN, pensées pour ne jamais servir un fichier périmé - **Deux formes d’URL** : avec `?v=` (huit caractères de l’empreinte), le fichier est mis en cache un an, car ce contenu-là ne changera jamais ; l’URL nue est mise en cache cinq minutes, car une clé peut être réécrite. - **Buckets privés** : pas d’URL permanente, seulement des liens signés, rendus avec leur date d’expiration pour qu’aucun client ne range en base une URL périssable sans le savoir. - **Miniatures à la volée, bornées** : largeur et hauteur de 16 à 4 096 pixels, arrondies au multiple de 16, qualité de 40 à 95. Ces bornes empêchent qu’une boucle sur des milliers de tailles ne remplisse votre stockage. Une image n’est jamais agrandie. - **Fichiers actifs neutralisés** : une page HTML ou un SVG téléversé est servi en téléchargement, jamais exécuté sur l’origine de votre administration. - **Modifier n’échange pas les octets** : renommer ou déplacer un objet ne change jamais son contenu, pour ne pas invalider en silence les URLs immuables déjà publiées. ## Servir les visuels d’un site par le CDN Ondes PRO 1. **Connectez votre assistant de code** — Ajoutez le serveur MCP de votre espace à Claude Code, Cursor ou VS Code. Il vous faut les modules **Stockage** et **API & Développeurs**. ``` https://votre-espace.ondes.pro/mcp/ ``` 2. **Créez une clé API pour le script** — Dans **API & Développeurs → Clés API**, créez une clé limitée au stockage. Votre script la lira dans une variable d’environnement, jamais dans le code. 3. **Laissez l’assistant créer le bucket et le script** — Décrivez le besoin : bucket public ou privé, dossier à envoyer, tailles de miniatures. L’assistant lit les fiches exactes et écrit le code. 4. **Téléversez, puis vérifiez** — Lancez le script ; demandez ensuite à l’assistant de compter les objets et de signaler toute erreur. Les URLs immuables sont prêtes pour la mise en production. > **Des octets hors de l’espace public, une déduplication cloisonnée** — Les fichiers du stockage d’objets sont rangés hors de l’espace des fichiers publics de l’instance : un bucket privé est réellement privé, pas seulement masqué. Avec plusieurs sociétés, la déduplication est cloisonnée par société — sans quoi téléverser un document et constater qu’il ne coûte rien révélerait qu’une société sœur le détient déjà. ## Combien de place, et à qui le compte-t-on ? Les objets puisent dans le **stockage de votre espace**, le même que celui du Drive et du courriel : 5 Go avec Essentiel, 50 Go avec Pro, davantage en Entreprise, et des Go supplémentaires se commandent si besoin. Un quota par bucket reste possible si vous voulez borner un usage précis. Quand l’espace est plein, un nouveau téléversement est refusé avec un message clair, à l’identique depuis l’API, l’explorateur de l’administration et un lien de dépôt direct. Pour une intégration robuste, la forme `contenu_base64` accepte un en-tête `Idempotency-Key` : un envoi rejoué après une coupure ne crée pas deux objets. Le [guide pour construire une intégration](https://ondes.pro/fr/integrations/mcp/guides/construire-une-integration) détaille ces conventions. ## Aller plus loin - [Drive chiffré](https://ondes.pro/fr/integrations/mcp/modules/drive) — Un Drive chiffré de bout en bout : votre IA aide à l’organiser, sans jamais pouvoir lire vos fichiers. - [Relier son site](https://ondes.pro/fr/integrations/mcp/guides/relier-son-site) — Afficher le catalogue et encaisser par Stripe depuis un site déjà en ligne, sans le reconstruire. - [Cursor](https://ondes.pro/fr/integrations/mcp/clients/cursor) — Un fichier `.cursor/mcp.json`, une connexion OAuth : l’agent de Cursor code contre votre vrai espace. - [API REST v1](https://ondes.pro/fr/integrations/api-rest) — Environ 135 ressources REST, des clés à portées, un schéma OpenAPI et des webhooks signés. ## Questions fréquentes ### Qu’est-ce que le stockage d’objets d’Ondes PRO ? Des buckets de fichiers, publics ou privés, servis par un CDN sous `/cdn/` de votre espace. Chaque objet a une clé lisible et une URL immuable ; les images peuvent être servies en miniature à la volée. Il se pilote depuis l’administration, l’API et votre assistant IA via MCP. ### Peut-on téléverser un fichier par le serveur MCP ? Le serveur MCP sert à créer et régler les buckets, lister les objets et écrire le code d’intégration. Pour envoyer les fichiers eux-mêmes, un script appelle l’API en HTTP direct, en multipart ou en base64 : c’est la voie fiable dès que les fichiers pèsent plusieurs mégaoctets. ### Quelle différence avec le Drive ? Le Drive est chiffré de bout en bout et sert à stocker des documents privés que le serveur ne peut pas lire. Le stockage d’objets sert à publier des fichiers : il les sert tels quels, en public ou par liens signés, avec cache et miniatures. ### Comment partager un fichier privé pour une durée limitée ? Avec l’action `lien-signe/` d’un objet d’un bucket privé : l’URL est temporaire, rendue avec sa date d’expiration. L’action `revoquer-liens/` du bucket invalide d’un coup tous les liens déjà distribués. ### Que se passe-t-il quand le stockage est plein ? Les nouveaux téléversements sont refusés avec un message explicite ; les fichiers déjà en ligne restent servis. Vous pouvez libérer de la place ou commander des Go supplémentaires depuis votre espace. ### Le stockage d’objets et le CDN sont-ils inclus ? Oui, dans toutes les offres Ondes PRO, avec le serveur MCP. Ils utilisent le stockage inclus dans votre offre. Voir [les tarifs](https://ondes.pro/fr/pricing).