# Connecter Ondes PRO à Cline

> Ajoutez le serveur MCP d’Ondes PRO à Cline : cline_mcp_settings.json avec type streamableHttp, OAuth via cline mcp authorize, approbation outil par outil.

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

Cline est un agent de code qui vit dans votre éditeur et demande votre accord avant chaque action. Il se connecte aux **serveurs MCP distants** en précisant le transport : pour Ondes PRO, `type: streamableHttp`. Une fois branché, il lit la documentation réelle de votre espace, prépare ses appels et vous laisse choisir, outil par outil, ce qu’il peut faire sans demander.

## Ajouter Ondes PRO aux serveurs MCP de Cline

Le point à ne pas manquer : Cline distingue deux transports distants, et le serveur d’Ondes PRO parle « Streamable HTTP ». Déclaré avec un autre type, il ne répondra pas.

1. **Ouvrez le panneau MCP Servers** — Dans Cline, cliquez sur l’icône des serveurs MCP. Vous pouvez ajouter un serveur distant depuis l’onglet dédié, ou cliquer sur **Configure** pour éditer directement `cline_mcp_settings.json`.
2. **Déclarez le serveur en streamableHttp** — Dans le fichier, ajoutez l’entrée `ondes` sous `mcpServers`, avec le type et l’adresse de votre espace.

```json
{
  "mcpServers": {
    "ondes": {
      "type": "streamableHttp",
      "url": "https://votre-espace.ondes.pro/mcp/"
    }
  }
}
```
3. **Autorisez la connexion** — Si Cline ne propose pas de lui-même de vous authentifier, lancez `cline mcp authorize` depuis la CLI de Cline. Une fenêtre de votre espace Ondes PRO s’ouvre : connectez-vous et validez l’écran de consentement.
4. **Vérifiez les outils** — Le serveur `ondes` passe au vert dans le panneau, et ses huit outils sont listés. C’est là que vous réglez, pour chacun, l’approbation automatique.
5. **Confiez une tâche à Cline** — Par exemple : « Explique-moi comment fonctionnent les buckets de stockage dans mon espace ». Cline vous présente chaque appel d’outil avant de l’exécuter.

## Configuration cline_mcp_settings.json prête à copier

La forme OAuth ne contient aucun secret. La forme par clé API sert à une connexion volontairement restreinte.

Où se règle la connexion : Le panneau **MCP Servers** de Cline, puis **Configure** (`cline_mcp_settings.json`).

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

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

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

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

_Compatible MCP standard. Documentation de l’éditeur : https://docs.cline.bot/mcp/connecting-to-a-remote-server_

## Quels outils Ondes PRO approuver automatiquement dans Cline ?

Cline vous laisse cocher, outil par outil, ceux qu’il peut utiliser sans vous demander (le réglage s’enregistre dans la liste `autoApprove` de l’entrée). Les six outils de documentation sont de bons candidats : `ondes_etat`, `ondes_guide`, `ondes_chercher`, `ondes_ressource`, `ondes_impossible` et `ondes_exemple` ne font que lire le guide et l’inventaire de votre espace. Les approuver évite une confirmation à chaque fois que Cline vérifie un nom de champ.

Laissez en revanche `ondes_appeler` et `ondes_assistant` sous confirmation. Le premier exécute de vrais appels à l’API avec votre identité ; le second interroge l’assistant intégré, qui peut proposer des modifications. Même confirmés, ces appels restent encadrés côté Ondes PRO : simulation possible, mode test par défaut sur les ressources qui ont un jumeau de test, et mode toujours annoncé dans la réponse.

## Exemple : déplacer les photos produits vers le CDN

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

> **Vous** : Crée un bucket public « catalogue » dans Ondes PRO, puis écris un script qui y téléverse le dossier `photos/` sans doublons si on le relance.
>
> 🔧 `ondes_ressource` Fiche `stockage/buckets` : `nom` et `visibilite` ; fiche `stockage/objets` : envoi en multipart ou en JSON `contenu_base64`.
>
> 🔧 `ondes_guide` Section idempotence : une `Idempotency-Key` est refusée sur un corps multipart, acceptée sur la forme `contenu_base64`.
>
> 🔧 `ondes_appeler` `POST stockage/buckets` avec `simuler: true` — corps valide. Puis, après votre accord, création réelle annoncée : bucket « catalogue » public.
>
> **Assistant** : Le bucket existe. Le script `migrer_photos.py` envoie chaque image en `contenu_base64` avec une clé d’idempotence dérivée du chemin : relancé après une coupure, il ne crée rien en double. Les fichiers identiques sont dédupliqués par leur empreinte, et chaque objet reçoit une URL `?v=` mise en cache longtemps. Il y a 148 photos, dont celles de la Lampe Trépied et du fauteuil showroom. Je lance un essai sur les cinq premières ?

## Cline, un agent prudent face à une API d’entreprise

Ce qui rend Cline intéressant avec Ondes PRO, c’est la cohérence des deux philosophies. Cline ne fait rien sans vous montrer l’action ; le serveur Ondes PRO ne documente jamais à l’agent une ressource qui lui répondrait « accès refusé », rend un refus métier sous forme de résultat lisible plutôt que d’erreur, et annonce dans chaque réponse si une écriture était réelle, en test ou simulée.

Résultat : Cline se corrige seul quand un champ manque, au lieu de boucler sur une erreur obscure, et vous savez toujours ce qui a vraiment changé dans votre espace. Pour comprendre pourquoi cette approche diffère d’un simple accès à l’API, voyez [MCP ou API REST](https://ondes.pro/fr/integrations/mcp/mcp-ou-api-rest).

> **Révoquer Cline d’un clic** — Chaque connexion OAuth de Cline apparaît dans l’onglet **MCP** de **API & Développeurs**, sous le nom de la machine. « Révoquer » la coupe tout de suite, sans attendre l’expiration du jeton d’une heure. Si vous utilisez Cline sur deux ordinateurs, ce sont deux connexions distinctes, révocables séparément.

## Pour aller plus loin

- [Stockage d’objets & CDN](https://ondes.pro/fr/integrations/mcp/modules/stockage-cdn) — Des buckets de fichiers servis par un CDN, que votre assistant de code crée et alimente pour vos sites.
- [Migrer vers Ondes PRO](https://ondes.pro/fr/integrations/mcp/guides/migrer-vers-ondes-pro) — Reprendre catalogue, clients et pièces de facturation par lots vérifiés, l’IA faisant la correspondance des colonnes.
- [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.

## Questions fréquentes

### Quel type de transport choisir dans Cline pour Ondes PRO ?

`streamableHttp`. Le serveur MCP d’Ondes PRO utilise le transport « Streamable HTTP » du protocole. Déclaré avec un autre type, la connexion échoue.

### Comment authentifier Cline auprès d’Ondes PRO ?

Par OAuth : déclarez l’adresse `https://<votre-espace>.ondes.pro/mcp/` sans en-tête, puis autorisez la connexion dans la fenêtre de votre espace — au besoin en lançant `cline mcp authorize`. Une clé API dans `headers` reste possible pour une connexion restreinte.

### Peut-on laisser Cline utiliser les outils Ondes PRO sans confirmation ?

Vous pouvez approuver automatiquement les six outils de documentation, qui ne font que lire le guide et l’inventaire. Nous conseillons de garder `ondes_appeler` et `ondes_assistant` sous confirmation, car ils agissent sur vos données.

### Cline peut-il téléverser des fichiers dans Ondes PRO ?

Il peut créer des buckets et des objets de stockage par l’API, avec vos droits. Pour un grand nombre de fichiers, le plus efficace est de lui faire écrire un script qui appelle l’API directement, en s’appuyant sur la documentation lue par MCP.

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

Non. Avec le type `streamableHttp`, Cline utilise le transport standard de notre serveur, la connexion doit donc fonctionner. Seul Claude a été vérifié de bout en bout par notre équipe ; Cline évolue vite, et sa documentation sur les serveurs distants fait foi.