Connecter un éditeur de code

Connecter Ondes PRO à 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.

Compatible MCP standardMis à jour le 21 octobre 2026

Votre espace Ondes PRO

https://.ondes.pro/mcp/

Tapez le nom de votre espace : les configurations de cette page s’adaptent. Il est retenu dans ce navigateur seulement.

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.

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/" }
  }
}
```
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.
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.
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.

CursorCompatible MCP standard

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)

Aucune clé à copier : une fenêtre de votre espace Ondes PRO s’ouvre pour autoriser la connexion.

.cursor/mcp.json

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

Connexion par clé API

Créez une clé dans API & Développeurs → Clés API, puis remplacez opk_… par sa valeur.

.cursor/mcp.json

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

Ce client suit le protocole MCP ouvert. Notre équipe n’a pas encore validé la connexion de bout en bout : la procédure ci-dessous suit la documentation de son éditeur.

Documentation de l’éditeur : cursor.com

.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.

Exemple : coder le paiement du site d’Atelier Lumen

Un développeur intègre le panier du site d’Atelier Lumen. Il ne connaît pas l’API ; l’agent la découvre dans l’espace, puis essaie sans risque.

Cursor · 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.
Outil MCP : ondes_chercher Terme « commande » : la ressource shop/commandes et la section du guide sur les paiements.
Outil MCP : 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.
Outil MCP : 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.

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

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.

Branchez votre IA sur votre entreprise

Le serveur MCP est inclus dans toutes les offres, sans option ni supplément.

Créer mon espace Voir les tarifs