# Connecter Ondes PRO à Cursor

> Ajoutez le serveur MCP d’Ondes PRO à Cursor via .cursor/mcp.json, en OAuth ou par clé API : l’agent code avec la doc exacte de votre espace et le mode test.

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

Cursor sait joindre un **serveur MCP distant** déclaré dans un simple fichier JSON. Branchez-y celui de votre espace Ondes PRO et l’agent de Cursor écrit votre intégration — site de boutique, synchronisation de stock, tableau de bord — en lisant la documentation réelle de vos ressources, puis en essayant ses appels en mode test plutôt que sur vos vraies commandes.

## Ajouter le serveur MCP d’Ondes PRO dans Cursor

Comptez deux minutes. La connexion par défaut passe par OAuth : aucune clé à copier ni à cacher dans le dépôt.

1. **Choisissez la portée du fichier** — Pour un projet précis, créez `.cursor/mcp.json` à la racine du dépôt. Pour que tous vos projets voient Ondes PRO, utilisez `~/.cursor/mcp.json` dans votre dossier personnel. Les deux fichiers ont le même format.
2. **Déclarez le serveur** — Collez la configuration ci-dessous en remplaçant le sous-domaine (ou tapez-le dans le champ en haut de page, les extraits s’adaptent). Le nom `ondes` est libre : c’est celui que Cursor affichera.

```json
{
  "mcpServers": {
    "ondes": { "url": "https://votre-espace.ondes.pro/mcp/" }
  }
}
```
3. **Ouvrez la rubrique MCP des réglages** — Dans les réglages de Cursor, la rubrique consacrée aux outils et à MCP liste le serveur `ondes`. Tant qu’il n’est pas autorisé, Cursor propose de vous connecter.
4. **Autorisez la connexion** — Une fenêtre de votre espace Ondes PRO s’ouvre dans le navigateur. Connectez-vous, lisez l’écran de consentement, autorisez. De retour dans Cursor, les outils du serveur apparaissent, et la connexion figure dans votre espace sous le nom de la machine.
5. **Travaillez en mode agent** — Dans le chat de Cursor, en mode agent, demandez par exemple « Quels champs faut-il pour créer une commande ? ». L’agent appelle lui-même les outils utiles ; selon vos réglages, il vous demande l’accord avant chaque appel.

## Configuration Cursor prête à copier

La première forme suffit dans la plupart des cas. La seconde, par clé API, sert quand vous voulez une connexion restreinte — lecture seule sur la boutique, par exemple.

Où se règle la connexion : Le fichier `.cursor/mcp.json` du projet, ou `~/.cursor/mcp.json` pour toute la machine.

**Connexion par OAuth (recommandée)** (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ondes": {
      "url": "https://votre-espace.ondes.pro/mcp/"
    }
  }
}
```

**Connexion par clé API** (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ondes": {
      "url": "https://votre-espace.ondes.pro/mcp/",
      "headers": {
        "Authorization": "ApiKey opk_…"
      }
    }
  }
}
```

_Compatible MCP standard. Documentation de l’éditeur : https://cursor.com/docs/context/mcp_

## .cursor/mcp.json dans le projet ou ~/.cursor/mcp.json global ?

Le **fichier de projet** a un avantage net en équipe : avec la forme OAuth, il ne contient aucun secret, seulement l’adresse du serveur. Vous pouvez donc le versionner, et chaque développeur qui ouvre le dépôt se voit proposer Ondes PRO ; il s’autorise ensuite avec son propre compte, donc avec ses propres droits. Une agence qui travaille pour plusieurs clients y gagne aussi : chaque dépôt pointe vers l’espace du bon client, sans risque de confondre deux boutiques.

Le **fichier global** convient si vous n’avez qu’un espace Ondes PRO et que vous voulez y accéder depuis n’importe quel dossier — y compris pour une question rapide sans rapport avec un dépôt. Si un même nom de serveur figure dans les deux fichiers, gardez des noms distincts (`ondes-client-a`, `ondes-client-b`) pour savoir à quel espace parle l’agent.

> **Une clé API ne se versionne jamais** — Si vous choisissez la forme par clé, ne commitez pas `.cursor/mcp.json` tel quel. Cursor accepte de lire une variable d’environnement dans ce fichier (`"Authorization": "ApiKey ${env:ONDES_CLE}"`) : la clé reste alors sur votre machine. En cas de fuite, révoquez la clé dans **API & Développeurs → Clés API** ; elle cesse de fonctionner aussitôt.

## Exemple : coder le paiement du site d’Atelier Lumen

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

> **Vous** : Branche le bouton « Payer » de `checkout.tsx` sur Ondes PRO. Le panier contient une Suspension Laiton et deux Lampes Trépied.
>
> 🔧 `ondes_chercher` Terme « commande » : la ressource `shop/commandes` et la section du guide sur les paiements.
>
> 🔧 `ondes_ressource` Fiche `shop/commandes` : champs obligatoires, montant recalculé côté serveur, `paiement.client_secret` en réel, page de paiement simulée (`paiement.checkout_url`) en test.
>
> 🔧 `ondes_appeler` `POST shop/commandes` — mode **test** annoncé dans la réponse : commande d’essai créée, aucun encaissement réel.
>
> **Assistant** : J’ai écrit l’appel dans `checkout.tsx` et vérifié la forme de la réponse sur une commande de test. Le montant n’est jamais envoyé par le navigateur : le serveur le recalcule depuis les produits. En test, je redirige vers `paiement.checkout_url`, la page de paiement simulée ; en production, le même code monte Stripe.js avec `paiement.client_secret`. La commande d’essai est visible dans l’onglet « Test » de Boutique & Commandes.

## Pourquoi un serveur MCP plutôt qu’un fichier de doc dans le dépôt ?

L’ancienne méthode consistait à télécharger un fichier de documentation et à le déposer dans le dépôt pour que l’assistant le lise. Il pesait environ **44 000 tokens** : une bonne part de la fenêtre de contexte, et quand il ne tenait pas, l’outil le coupait — souvent au milieu de la section qui dit ce que l’API ne fait pas.

Avec le serveur MCP, Cursor ne garde en permanence qu’environ **2 700 tokens** : un court préambule et la description des huit outils. Le reste est lu à la demande, section par section, et engendré depuis les routes réelles de votre espace. Pas de copie qui vieillit dans le dépôt : si un champ change, l’agent le voit au prochain appel. Et l’outil `ondes_impossible` lui permet de vérifier qu’un endpoint n’existe pas avant de l’inventer. Plus de détails dans [MCP ou API REST](https://ondes.pro/fr/integrations/mcp/mcp-ou-api-rest).

## Ce que l’agent de Cursor peut faire avec votre espace

- Lire la fiche d’une ressource avant d’écrire le code qui l’appelle : champs typés, filtres, tri, permission exigée.
- Valider le corps d’une requête avec une simulation, sans rien écrire dans votre espace.
- Créer des commandes, des réunions visio ou des envois d’e-mails en mode test, sur les ressources qui ont un jumeau de test.
- Reprendre une recette complète déjà vérifiée contre l’API (créer, lire sans multiplier les appels, s’abonner aux événements).
- Répondre à une question sur vos données réelles pendant que vous codez : « combien de produits sans image ? ».

## Pour aller plus loin

- [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.
- [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.
- [Boutique en ligne](https://ondes.pro/fr/integrations/mcp/modules/boutique-en-ligne) — Commandes, catalogue, codes promo et expéditions pilotés par votre assistant, en mode test par défaut.
- [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.

## Questions fréquentes

### Comment ajouter un serveur MCP distant dans Cursor ?

Déclarez-le dans `.cursor/mcp.json` (projet) ou `~/.cursor/mcp.json` (toute la machine) sous la clé `mcpServers`, avec son adresse dans `url`. Pour Ondes PRO : `https://<votre-espace>.ondes.pro/mcp/`. Cursor propose ensuite de se connecter en OAuth.

### Puis-je versionner .cursor/mcp.json dans Git ?

Oui avec la forme OAuth, qui ne contient que l’adresse du serveur. Chaque développeur s’autorise avec son propre compte. Avec une clé API, ne versionnez pas la clé : lisez-la depuis une variable d’environnement.

### L’agent de Cursor peut-il passer de vraies commandes ?

Par défaut, non : sur `shop/commandes`, les écritures partent en mode test et la réponse annonce toujours le mode employé. Il faut demander explicitement une écriture réelle. Cursor vous demande en plus votre accord avant chaque appel d’outil, sauf si vous avez activé l’exécution automatique.

### Cursor voit-il tous les modules de mon espace ?

Il voit ceux que votre rôle ouvre, pas davantage. Les outils, le sommaire et la recherche sont filtrés par votre périmètre : l’agent ne se voit jamais documenter une ressource qui lui répondrait « accès refusé ».

### Cursor est-il testé par l’équipe Ondes PRO ?

Non. Cursor implémente le protocole MCP standard que notre serveur respecte, la connexion doit donc fonctionner. Seul Claude a été testé de bout en bout par notre équipe ; si l’interface de Cursor change, référez-vous à sa documentation.