# Guides pas à pas : le serveur MCP et l’API d’Ondes PRO en pratique

> Quatre guides pas à pas pour brancher votre site, construire une intégration, migrer vos données ou automatiser vos relances avec le serveur MCP d’Ondes PRO.

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

Ces guides partent d’un objectif réel — vendre depuis un site déjà en ligne, synchroniser un back-office, quitter un ancien logiciel, déléguer les relances — et déroulent chaque étape avec des **requêtes API exactes**, des extraits prêts à adapter et le rôle que joue votre **assistant IA connecté par MCP**. Trois s’adressent aux développeurs, le quatrième aux dirigeants.

## Quel guide choisir selon votre projet ?

| Guide | Pour qui | Vous obtenez |
| --- | --- | --- |
| [Relier son site à la boutique](https://ondes.pro/fr/integrations/mcp/guides/relier-son-site) | Développeur d’un site existant | Catalogue affiché, panier et paiement Stripe encaissés par Ondes PRO, sans refaire le site |
| [Construire une intégration](https://ondes.pro/fr/integrations/mcp/guides/construire-une-integration) | Développeur back-office, intégrateur | Un service qui lit et écrit par l’API REST, reçoit des webhooks signés et ne crée jamais de doublon |
| [Migrer vers Ondes PRO](https://ondes.pro/fr/integrations/mcp/guides/migrer-vers-ondes-pro) | Développeur ou responsable technique | Catalogue, clients et pièces de facturation repris par lots vérifiés, l’IA faisant la correspondance des colonnes |
| [Automatiser avec l’IA](https://ondes.pro/fr/integrations/mcp/guides/automatiser-avec-l-ia) | Dirigeant, gérant | Relances, rapports et automatisations décrits en langage naturel, toujours relus avant d’agir |

## Pourquoi des guides orientés MCP, et pas une simple référence d’API ?

La référence complète de l’API existe déjà dans votre espace, engendrée à partir des routes réelles. Ce qui manque à un développeur, c’est l’enchaînement : dans quel ordre créer les objets, où placer la clé d’idempotence, comment tester sans encaisser. Chaque guide répond à ces questions sur un cas complet.

Le serveur MCP change aussi la façon de travailler. Votre assistant de code n’a plus besoin d’un fichier de documentation recopié dans le dépôt : il interroge l’espace avec `ondes_ressource` ou `ondes_exemple` au moment où il écrit le code, et vérifie avec `ondes_impossible` qu’il n’invente pas une route. Les guides montrent ce duo à l’œuvre, sans le rendre obligatoire : tout ce qui y figure fonctionne aussi avec `curl`.

## Avant de commencer : ce qu’il vous faut

- Un espace Ondes PRO actif (`https://<votre-espace>.ondes.pro`), sur n’importe quelle offre : l’API et le serveur MCP sont inclus dans toutes. Pas encore d’espace ? [Créez-le](https://ondes.pro/fr/signup) ou [essayez la démo](https://ondes.pro/fr/demo).
- Un rôle qui ouvre **API & Développeurs** : c’est la permission exigée pour créer une clé et pour connecter un assistant.
- Pour un script ou un serveur, une **clé API** à portées (`billing:read`, `shop:write`…) ; pour un assistant, une connexion **OAuth** suffit.
- Le réflexe du **mode test** : les ressources qui ont un jumeau s’appellent sous `/api/v1/test/…`, et un assistant connecté y écrit par défaut.

## Brancher votre assistant de code avant de suivre un guide

Facultatif mais recommandé : avec la connexion ci-dessous, votre assistant lit la documentation de votre propre espace pendant que vous avancez. Tapez votre sous-domaine en haut de page pour personnaliser la commande.

Où se règle la connexion : Une commande dans le terminal, puis `/mcp` dans Claude Code pour se connecter.

**Connexion par OAuth (recommandée)** (Terminal)

```bash
claude mcp add --transport http ondes https://votre-espace.ondes.pro/mcp/
```

**Connexion par clé API** (Terminal)

```bash
claude mcp add --transport http ondes https://votre-espace.ondes.pro/mcp/ \
  --header "Authorization: ApiKey opk_…"
```

_Testé par notre équipe. Documentation de l’éditeur : https://code.claude.com/docs/en/mcp_

> **Un guide décrit l’API, votre espace décrit vos droits** — Les exemples citent des ressources réelles — `shop/produits`, `billing/factures`, `developer/abonnements`. Si votre rôle n’ouvre pas un module, ses ressources n’apparaissent ni dans la documentation servie à votre assistant ni dans vos réponses d’API. Demandez à l’administrateur d’ajuster votre rôle plutôt que de chercher une route alternative.

## Les références qui accompagnent ces guides

- [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.
- [Sécurité du serveur MCP](https://ondes.pro/fr/integrations/mcp/securite) — OAuth 2.1, jetons courts, révocation immédiate et garde-fous d’écriture : ce que votre DSI doit savoir.
- [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.
- [Stripe](https://ondes.pro/fr/integrations/stripe) — Encaissez les commandes de votre boutique sur votre propre compte Stripe, société par société.

## Questions fréquentes

### Faut-il connecter un assistant IA pour suivre ces guides ?

Non. Toutes les étapes reposent sur l’API REST d’Ondes PRO et fonctionnent avec n’importe quel client HTTP. Le serveur MCP accélère le travail en servant la documentation exacte de votre espace à votre assistant de code, mais il reste un compagnon, pas un prérequis.

### Les guides fonctionnent-ils sur l’offre Essentiel ?

Oui. L’API REST, les webhooks, le mode test et le serveur MCP sont inclus dans toutes les offres Ondes PRO, Essentiel comprise. Seules changent les limites d’utilisateurs et de stockage, détaillées sur la page [tarifs](https://ondes.pro/fr/pricing).

### Où trouver la référence complète de l’API ?

Dans votre espace, rubrique **API & Développeurs** : un guide par sections, un explorateur et un schéma OpenAPI 3.1, tous engendrés à partir des routes réelles. Votre assistant y accède par les outils `ondes_guide` et `ondes_ressource` du serveur MCP.

### Peut-on tester sans risquer de vraies commandes ou de vrais envois ?

Oui. Les commandes de la boutique, les réunions visio, les envois d’e-mails et les invitations ont un jumeau de test sous `/api/v1/test/`. Pour les autres ressources, un assistant connecté par MCP peut valider un corps de requête avec `simuler: true` sans rien enregistrer.

### Les guides parlent-ils de sociétés multiples ?

Oui, quand c’est utile : un espace Ondes PRO peut porter une société mère et des filiales. Une clé ou une connexion n’atteint que les sociétés de son porteur, et chaque guide signale où le choix de la société intervient.