# Connecter Ondes PRO à Windsurf

> Ajoutez le serveur MCP d’Ondes PRO à Windsurf : mcp_config.json avec la clé serverUrl, connexion OAuth, et Cascade qui code avec la doc réelle de votre espace.

Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/clients/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.

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

1. **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/" }
  }
}
```
3. **Rafraîchissez la liste des serveurs** — Enregistrez le fichier et actualisez le panneau MCP : le serveur `ondes` apparaît, en attente d’autorisation.
4. **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.
5. **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.

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

**Connexion par OAuth (recommandée)** (mcp_config.json)

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

**Connexion par clé API** (mcp_config.json)

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

_Compatible MCP standard. Documentation de l’éditeur : https://docs.devin.ai/desktop/cascade/mcp_

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

_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.
>
> 🔧 `ondes_ressource` Fiche `inventory/composants` : champs de stock et de seuil, filtres et tris disponibles.
>
> 🔧 `ondes_guide` Section pagination : curseur conseillé pour les longues listes, paramètres `fields` et `page_size`.
>
> 🔧 `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.

> **Windsurf en équipe** — Dans une équipe Windsurf, un administrateur peut restreindre les serveurs MCP autorisés. Si le serveur `ondes` reste grisé, demandez qu’il soit ajouté à la liste. Côté Ondes PRO, chaque développeur s’autorise avec son propre compte : sa connexion apparaît sous son nom et le nom de sa machine dans l’onglet **MCP** de l’espace, révocable séparément.

## Pour aller plus loin

- [Gestion des stocks](https://ondes.pro/fr/integrations/mcp/modules/gestion-des-stocks) — Niveaux, réceptions, nomenclatures et ordres de production consultés et préparés par votre assistant.
- [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.
- [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.
- [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 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.