# Ondes PRO pour les agences web et les ESN

> Agences web et ESN : un serveur MCP par client final, la documentation de l’API servie à votre IA et un mode test pour intégrer sans risque.

Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/secteurs/agences-web

Vous intégrez, vous maintenez, vous faites évoluer le site et les outils de plusieurs clients. Chaque client équipé d’Ondes PRO a sa propre instance, donc **son propre serveur MCP** : votre assistant de code s’y connecte avec les droits que le client vous a donnés, lit la documentation de son API à la demande et teste ses écritures en mode test. Moins de recherche, moins d’allers-retours, et aucune commande réelle créée par erreur.

## Un serveur MCP par client final : comment ça s’organise ?

Chaque client Ondes PRO dispose d’une instance isolée, à son adresse : `galerie-ressac.ondes.pro`, `comptoir-des-marees.ondes.pro`… Son serveur MCP est à cette adresse suivie de `/mcp/`. Dans votre assistant, vous ajoutez donc **un connecteur par client**, nommé clairement. Aucune donnée ne circule d’une instance à l’autre : un jeton obtenu chez un client ne vaut rien chez un autre.

Côté client, l’administrateur vous invite avec un rôle adapté à votre mission — boutique et API, par exemple, sans la facturation — et la permission **API & Développeurs**, nécessaire pour se connecter. Il voit ensuite votre connexion listée par machine (« Claude Code, sur le portable de Karim ») et peut la révoquer à tout moment, avec effet immédiat. Votre client garde ainsi la main sur l’accès qu’il vous a confié.

Votre propre agence peut aussi tourner sur Ondes PRO. Si elle regroupe plusieurs sociétés, les **espaces de travail** les séparent (société mère et filiales) : l’assistant cible celle que vous désignez, et une filiale ne voit jamais les données d’une autre.

## Une journée en agence avec un assistant de code

**9 h.** Point projet. Vous demandez à votre assistant ce qui est en retard dans le tableau Kanban de chaque refonte en cours ; il répond projet par projet et vous propose les créneaux de rendez-vous à caler.

**10 h 30.** Développement. Votre développeur intègre le paiement sur le site d’un client. Plutôt que de chercher dans une documentation, son assistant interroge le serveur MCP du client : il trouve la bonne ressource, lit ses champs obligatoires, vérifie ce que l’API ne fait pas, puis fait un essai en mode test.

**15 h.** Recette. Le client veut voir le parcours d’achat. La page de paiement simulée du mode test permet de le dérouler de bout en bout, sans carte réelle et sans fausse commande dans ses chiffres.

**17 h.** Mise en ligne. Le site est relié au dépôt GitHub du client ; chaque `git push` le redéploie sur son domaine.

## Intégrer un paiement sans ouvrir la documentation

_Exemple de conversation · données de démonstration (Atelier Lumen)_

> **Vous** : Sur le site de Galerie Ressac, branche le bouton « Acheter » de la page tirage : création de commande et paiement par carte.
>
> 🔧 `ondes_chercher` « commande paiement » — ressource `shop/commandes` et section du guide sur les paiements.
>
> 🔧 `ondes_ressource` Fiche `shop/commandes` : champs obligatoires, montant recalculé par le serveur, jumeau de test disponible.
>
> 🔧 `ondes_impossible` Vérifie qu’aucune route ne renvoie un secret déjà émis : le `client_secret` du paiement n’est rendu qu’à la création.
>
> 🔧 `ondes_appeler` `POST shop/commandes` — mode test annoncé ; commande d’essai créée, avec une page de paiement simulée (`paiement.checkout_url`).
>
> **Assistant** : L’essai fonctionne en mode test. J’ai ajouté l’appel côté serveur du site, le montage du formulaire de carte avec Stripe.js chargé par balise `<script>` (aucune dépendance ajoutée), et la page de confirmation. Avant la mise en production, Galerie Ressac devra connecter son compte Stripe dans sa configuration : c’est un geste que seul leur administrateur peut faire, puisqu’il décide où arrive l’argent.

## Pourquoi les développeurs gagnent du temps

- **Une documentation toujours exacte** : elle est engendrée depuis les routes réelles de l’instance du client, à chaque appel, et ne décrit que les modules qui y sont ouverts.
- **Un contexte léger** : environ 2 700 tokens permanents pour les huit outils, contre 44 000 pour l’ancien fichier de documentation qu’on copiait dans chaque dépôt — et qui devenait faux dès sa copie.
- **Pas d’endpoint inventé** : l’outil `ondes_impossible` liste ce que l’API ne fait volontairement pas, et `ondes_exemple` donne des recettes vérifiées contre l’API réelle.
- **Des essais sans conséquence** : commandes, réunions, envois d’e-mails et invitations partent en mode test par défaut ; `simuler: true` valide un corps sans rien écrire.
- **Des refus lisibles** : un refus métier revient comme un résultat que l’assistant comprend et corrige, pas comme une panne.

## Le point projet du matin, sur deux instances

_Exemple de conversation · données de démonstration (Atelier Lumen)_

> **Vous** : Qu’est-ce qui est en retard sur la refonte de Galerie Ressac ? Et depuis la mise en ligne lundi, leur boutique a-t-elle pris des commandes ?
>
> 🔧 `ondes_appeler` Connecteur de l’agence — `GET kanban/cartes` du tableau « Refonte Galerie Ressac » : 2 cartes en retard.
>
> 🔧 `ondes_appeler` Connecteur Galerie Ressac — `GET shop/commandes` depuis lundi : 6 commandes réelles.
>
> **Assistant** : Deux cartes sont en retard : « Textes de la page À propos » (attendus du client depuis jeudi) et « Optimisation des images de la galerie » (assignée à Jules). Côté boutique, **6 commandes depuis lundi**, aucune en erreur de paiement. Voulez-vous une visio avec le client pour débloquer les textes ?
>
> **Vous** : Oui, jeudi 10 h, 30 minutes.
>
> 🔧 `ondes_appeler` Connecteur de l’agence — `POST visio/reunions` en mode test, puis réellement après accord : salle créée, lien prêt.

## Relier le site existant d’un client à sa boutique

Beaucoup de clients ont déjà un site et ne veulent pas le refaire. La fonction « Relier mon site », dans l’onglet **Mon site** de la boutique, relie le dépôt de code de ce site — sur GitHub ou dans Ondes GIT — et confie l’intégration à un agent IA. Il lit le code, pose ses questions avant d’écrire, propose les modifications à relire, et ne valide ni n’enregistre rien sur le dépôt sans décision explicite. Il ne force jamais un envoi : en cas de conflit, il propose une nouvelle branche.

Le mode d’emploi est dans le guide [relier son site](https://ondes.pro/fr/integrations/mcp/guides/relier-son-site). Pour héberger un site statique depuis GitHub, avec redéploiement à chaque `git push`, voyez la page [GitHub](https://ondes.pro/fr/integrations/github).

## Mettre en place l’accès à l’instance d’un client

Quatre étapes, à faire une fois par client.

1. **Se faire inviter** — L’administrateur du client vous envoie une invitation depuis **Équipe**, avec un rôle qui ouvre les modules de la mission et la permission **API & Développeurs**.
2. **Ajouter le connecteur** — Dans votre assistant, ajoutez un serveur MCP nommé d’après le client, avec l’adresse de son instance suivie de `/mcp/`.

```
https://votre-espace.ondes.pro/mcp/
```
3. **Autoriser la connexion** — Une fenêtre de l’instance s’ouvre : connectez-vous avec le compte créé par l’invitation et validez l’écran de consentement.
4. **Vérifier le périmètre** — Demandez à l’assistant « que puis-je faire ici ? » : l’outil `ondes_etat` liste les modules et permissions de la connexion. S’il manque un module, le rôle est à ajuster côté client.

## Pour une intégration en production : la clé API

Le serveur MCP sert à concevoir et tester. Un site ou un service qui tourne en production appelle l’API REST avec une **clé API à portées** : elle ne donne accès qu’aux modules et actions nécessaires, ne dépasse jamais les droits de la personne qui l’a créée, et son quota par minute est réglable. Les webhooks sortants signés préviennent votre code d’une commande payée ou d’une facture émise. Tout est détaillé dans le guide [construire une intégration](https://ondes.pro/fr/integrations/mcp/guides/construire-une-integration) et sur la page [API REST](https://ondes.pro/fr/integrations/api-rest).

## Pour aller plus loin

- [Construire une intégration](https://ondes.pro/fr/integrations/mcp/guides/construire-une-integration) — Clés à portées, webhooks signés, idempotence et mode test pour un back-office qui ne crée jamais de doublon.
- [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.
- [MCP ou API REST](https://ondes.pro/fr/integrations/mcp/mcp-ou-api-rest) — Ce qui les distingue vraiment, quand choisir l’un ou l’autre, et pourquoi chez Ondes PRO ils fonctionnent ensemble.

## Questions fréquentes

### Une agence peut-elle gérer plusieurs clients Ondes PRO depuis le même assistant ?

Oui : chaque client a son instance et son serveur MCP ; vous ajoutez un connecteur par client dans votre assistant. Les instances sont isolées et un jeton d’accès émis pour l’une est refusé par les autres.

### Le client peut-il couper l’accès de l’agence ?

Oui, à tout moment. Dans l’onglet MCP d’API & Développeurs, chaque connexion est listée par machine avec sa dernière activité, et la révocation est immédiate. Il peut aussi retirer le rôle ou désactiver le compte de l’agence.

### Quelle différence entre le serveur MCP et l’API REST pour une agence ?

Le serveur MCP est fait pour un assistant IA : il sert la documentation à la demande et exécute des appels avec l’identité de la personne connectée. L’API REST est faite pour votre code en production, avec une clé à portées limitées. Les deux reposent sur les mêmes ressources. Voir [MCP ou API REST](https://ondes.pro/fr/integrations/mcp/mcp-ou-api-rest).

### Peut-on tester un parcours de paiement sans encaisser ?

Oui. Les commandes de la boutique ont un mode test séparé, avec une page de paiement simulée et des webhooks de test distincts de ceux de production. Les commandes de test n’apparaissent pas dans les chiffres de la boutique.

### Combien coûte l’accès MCP pour l’agence ou pour son client ?

Rien de plus : le serveur MCP est inclus dans toutes les offres Ondes PRO. Le compte de l’agence occupe simplement une place d’utilisateur dans l’instance du client.