Connecter un éditeur de code

Connecter Ondes PRO à Windsurf

Dans Windsurf, c’est Cascade, l’agent de l’éditeur, qui utilise les serveurs MCP. Déclarez celui de votre espace Ondes PRO dans mcp_config.json et Cascade dispose de huit outils pour comprendre votre API, valider ses requêtes et interroger vos données — un ensemble fixe et léger, qui ne vient pas encombrer sa liste d’outils.

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 Ondes PRO aux serveurs MCP de Cascade

La particularité de Windsurf tient en un mot : l’adresse d’un serveur distant se déclare sous la clé serverUrl, et non url comme ailleurs. C’est la première chose à corriger si vous recopiez la configuration d’un autre éditeur.

Ouvrez le panneau MCP de Cascade
Dans le panneau Cascade, ouvrez la gestion des serveurs MCP, puis l’option qui permet de modifier la configuration brute. Windsurf ouvre son fichier mcp_config.json, rangé dans votre dossier personnel (sous ~/.codeium/windsurf/ dans les versions actuelles).
2
Déclarez le serveur avec serverUrl
Ajoutez l’entrée ondes sous mcpServers. Tapez votre sous-domaine en haut de page pour que l’adresse soit la bonne.
json
```
{
  "mcpServers": {
    "ondes": { "serverUrl": "https://votre-espace.ondes.pro/mcp/" }
  }
}
```
Rafraîchissez la liste des serveurs
Enregistrez le fichier et actualisez le panneau MCP : le serveur ondes apparaît, en attente d’autorisation.
Autorisez la connexion dans votre espace
Une fenêtre de votre espace Ondes PRO s’ouvre. Connectez-vous et validez l’écran de consentement, qui dit en clair ce que la connexion permettra. Les huit outils deviennent disponibles pour Cascade.
Demandez à Cascade
Par exemple : « Quelle ressource de l’API sert aux mouvements de stock, et quels champs exige-t-elle ? ». Cascade choisit les outils et affiche chaque appel.

Configuration mcp_config.json prête à copier

Le fichier est personnel, il ne vit pas dans votre dépôt : la forme par clé API y est donc moins exposée qu’ailleurs. Préférez tout de même OAuth, qui ne laisse aucun secret sur le disque.

WindsurfCompatible MCP standard

Où se règle la connexion : Le fichier mcp_config.json de Windsurf (panneau MCP de Cascade → Configurer).

Connexion par OAuth (recommandée)

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

mcp_config.json

{
  "mcpServers": {
    "ondes": {
      "serverUrl": "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.

mcp_config.json

{
  "mcpServers": {
    "ondes": {
      "serverUrl": "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 : docs.devin.ai

Huit outils, pas cent trente-cinq : pourquoi c’est important dans Windsurf

Windsurf limite le nombre total d’outils que Cascade peut avoir actifs, tous serveurs confondus. Un serveur qui exposerait chaque ressource de l’API comme un outil — l’API v1 d’Ondes PRO en compte environ 135, avec plusieurs verbes chacune — saturerait cette limite à lui seul, et les définitions d’outils occuperaient le contexte en permanence.

Le serveur d’Ondes PRO fait l’inverse : huit outils fixes, environ 2 700 tokens de contexte permanent, et toute la richesse derrière eux. Cascade découvre les ressources avec ondes_chercher et ondes_ressource au moment où il en a besoin, et appelle n’importe laquelle par ondes_appeler. Vous gardez de la place pour vos autres serveurs MCP.

Exemple : un tableau de bord de stock pour l’atelier

Thomas construit pour Atelier Lumen un petit écran interne qui affiche les composants à recommander. Il demande à Cascade de partir des données réelles.

Windsurf (Cascade) · Exemple de conversation · données de démonstration (Atelier Lumen)

Vous : Crée une page stock.tsx qui liste les composants sous leur seuil d’alerte, du plus urgent au moins urgent. Ne charge que les colonnes utiles.
Outil MCP : ondes_ressource Fiche inventory/composants : champs de stock et de seuil, filtres et tris disponibles.
Outil MCP : ondes_guide Section pagination : curseur conseillé pour les longues listes, paramètres fields et page_size.
Outil MCP : ondes_appeler GET inventory/composants avec fields restreint — 212 composants, réponse paginée par curseur.
Assistant : La page est prête. Elle demande seulement la référence, le nom, le stock et le seuil, et suit le curseur jusqu’au bout. Sur vos données actuelles, 9 composants sont sous leur seuil ; le plus urgent est la douille E27 laiton utilisée par la Suspension Laiton et le Lampadaire Arc. Voulez-vous que j’ajoute un lien vers la nomenclature de chaque produit concerné ?

Ce que Cascade apporte en plus avec Ondes PRO

Une documentation à jour par construction : elle est engendrée depuis les routes réelles de votre espace à chaque appel, pas copiée une fois pour toutes.
Une documentation à votre mesure : Cascade ne voit que les modules que votre rôle ouvre.
Des recettes complètes, vérifiées contre l’API, via ondes_exemple : lire sans multiplier les appels, facturer, s’abonner aux événements.
Des écritures prudentes : simulation possible sur toute ressource, mode test par défaut quand la ressource a un jumeau de test, mode toujours annoncé dans la réponse.

Pour aller plus loin

Questions fréquentes

Comment ajouter un serveur MCP distant dans Windsurf ?

Depuis le panneau MCP de Cascade, ouvrez la configuration brute mcp_config.json et déclarez le serveur sous mcpServers avec la clé serverUrl. Pour Ondes PRO : https://<votre-espace>.ondes.pro/mcp/, puis actualisez et autorisez la connexion.

Pourquoi Windsurf ne trouve-t-il pas mon serveur déclaré avec url ?

Pour un serveur distant, Windsurf documente la clé serverUrl. Une configuration copiée depuis Cursor ou Zed, qui utilisent url, doit être renommée.

Le serveur Ondes PRO consomme-t-il beaucoup d’outils dans Windsurf ?

Non : il en expose huit, toujours les mêmes, pour environ 2 700 tokens de contexte permanent. Les quelque 135 ressources de l’API sont découvertes et appelées à travers ces huit outils.

Cascade peut-il écrire dans mon espace sans que je le voie ?

Chaque appel d’outil est affiché dans Cascade, et les écritures passent par vos droits uniquement. Côté Ondes PRO, la réponse annonce toujours si l’écriture était réelle, en mode test ou simulée, et tous les appels MCP sont journalisés dans votre espace.

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

Non. Cascade joint les serveurs distants selon le protocole MCP standard que respecte notre serveur : avec la clé serverUrl, la connexion doit fonctionner. Seul Claude a été vérifié de bout en bout par notre équipe, et le panneau MCP de Windsurf change parfois de place.

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