# Connecter Ondes PRO à Zed > Connectez Ondes PRO à l’éditeur Zed : une entrée context_servers dans settings.json, OAuth automatique, et le panneau Agent qui agit sur votre espace. Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/clients/zed Zed appelle les serveurs MCP des **serveurs de contexte**, et les déclare sous la clé `context_servers` de ses réglages. Pour Ondes PRO, une adresse suffit : sans en-tête d’authentification, Zed lance de lui-même la connexion OAuth avec votre espace. Le panneau Agent peut ensuite lire la documentation de vos ressources et agir sur vos données, à votre rythme. ## Déclarer Ondes PRO comme serveur de contexte dans Zed C’est la configuration la plus courte de tous les éditeurs : trois lignes utiles, aucune clé. 1. **Ouvrez les réglages de Zed** — Depuis la palette de commandes, ouvrez le fichier de réglages (`settings.json`). Une entrée ajoutée ici vaut pour tous vos projets. 2. **Ajoutez l’entrée context_servers** — Collez le bloc suivant au premier niveau du fichier, à côté de vos autres réglages. Remplacez le sous-domaine, ou tapez-le en haut de page. ```json { "context_servers": { "ondes": { "url": "https://votre-espace.ondes.pro/mcp/" } } } ``` 3. **Laissez Zed lancer l’autorisation** — Comme l’entrée ne porte aucun en-tête `Authorization`, Zed détecte que le serveur demande OAuth et ouvre une fenêtre de votre espace Ondes PRO. Connectez-vous et validez l’écran de consentement. 4. **Vérifiez l’état du serveur** — Dans les réglages du panneau Agent, le serveur `ondes` apparaît avec un indicateur d’état. Une fois actif, ses huit outils sont proposés à l’agent. 5. **Utilisez-le dans le panneau Agent** — Ouvrez le panneau Agent et demandez par exemple « Quelles colonnes a le tableau Site web ? ». Zed vous demande confirmation avant d’exécuter un outil, sauf si vous avez choisi de toujours autoriser. ## Configuration context_servers prête à copier Avec un en-tête `Authorization`, Zed n’engage pas OAuth : la seconde forme sert donc uniquement si vous voulez une clé API restreinte. Le fichier de réglages étant personnel, la clé ne part pas dans un dépôt. Où se règle la connexion : La clé `context_servers` du fichier de réglages de Zed. **Connexion par OAuth (recommandée)** (settings.json) ```json { "context_servers": { "ondes": { "url": "https://votre-espace.ondes.pro/mcp/" } } } ``` **Connexion par clé API** (settings.json) ```json { "context_servers": { "ondes": { "url": "https://votre-espace.ondes.pro/mcp/", "headers": { "Authorization": "ApiKey opk_…" } } } } ``` _Compatible MCP standard. Documentation de l’éditeur : https://zed.dev/docs/ai/mcp.html_ ## Choisir les outils Ondes PRO que l’agent de Zed peut utiliser Zed organise les outils de l’agent en **profils**. Vous pouvez en créer un qui n’autorise que les six outils de documentation du serveur Ondes PRO — `ondes_etat`, `ondes_guide`, `ondes_chercher`, `ondes_ressource`, `ondes_impossible`, `ondes_exemple` —, pour coder avec la doc exacte de votre espace sans aucune possibilité d’écrire. Pour les tâches où l’agent doit agir, un second profil ajoute `ondes_appeler` et `ondes_assistant`. Même là, plusieurs filets restent en place : la confirmation de Zed avant chaque outil, vos droits Ondes PRO qui bornent tout, la simulation possible sur n’importe quelle ressource et le mode test par défaut sur celles qui ont un jumeau de test. ## Les huit outils que Zed voit Ce sont toujours les mêmes, quel que soit le nombre de modules de votre espace : la richesse est derrière eux, pas dans leur liste. - `ondes_etat` (Lecture) — **État de la connexion** : Qui est connecté, quels modules sont accessibles, quelles permissions porte la connexion. L'assistant l'appelle une fois au début pour connaître son périmètre. - `ondes_guide` (Lecture) — **Guide de l'API** : Le guide de l'API, section par section : d'abord un sommaire résumé, puis seulement les sections utiles (pagination, idempotence, paiements…). - `ondes_chercher` (Lecture) — **Chercher** : Cherche un terme métier (« devis », « stock », « webhook ») à la fois dans l'inventaire des ressources et dans le guide. - `ondes_ressource` (Lecture) — **Fiche d'une ressource** : Tout pour appeler une ressource sans se tromper : URL, verbes, champs typés et obligatoires, filtres, tri, actions, permission exigée, jumeau de test. - `ondes_impossible` (Lecture) — **Ce que l'API ne fait pas** : La liste de ce qui n'existe pas volontairement. L'assistant la consulte avant d'inventer une URL : c'est ce qui l'empêche d'halluciner. - `ondes_exemple` (Lecture) — **Recettes complètes** : Des scénarios entiers déjà vérifiés contre l'API réelle : créer, lire sans multiplier les appels, facturer, s'abonner aux événements. - `ondes_appeler` (Écriture) — **Appeler l'API** : Exécute un vrai appel avec l'identité de l'utilisateur. Les écritures partent en mode test par défaut, et une simulation valide un envoi sans rien écrire. - `ondes_assistant` (Écriture) — **Demander à l'assistant Ondes PRO** : Pose une question métier à l'assistant intégré, qui agrège plusieurs modules. Ses écritures sont proposées sous forme de plan, exécuté seulement après accord. ## Exemple : transformer des TODO en cartes Kanban _Exemple de conversation · données de démonstration (Atelier Lumen)_ > **Vous** : Récupère les TODO de `src/`, et crée une carte par TODO dans la colonne « À faire » du tableau Site web, avec le fichier en description. > > 🔧 `ondes_ressource` Fiche `kanban/cartes` : `column` et `title` obligatoires, pas de jumeau de test — une création est réelle. > > 🔧 `ondes_appeler` `GET kanban/colonnes` filtré sur le tableau Site web — la colonne « À faire » est trouvée. > > 🔧 `ondes_appeler` `POST kanban/cartes` avec `simuler: true` sur la première carte — corps valide, rien n’est écrit. > > **Assistant** : J’ai trouvé 7 TODO, dont « compresser les photos de la Suspension Pétrole » et « traduire la page Livraison ». La simulation passe. Comme `kanban/cartes` n’a pas de mode test, la création sera réelle : je crée les 7 cartes ? > > **Vous** : Oui. > > 🔧 `ondes_appeler` 7 × `POST kanban/cartes` — « écriture réelle » annoncée dans chaque réponse, cartes créées. > > **Assistant** : C’est fait. Les cartes sont apparues en direct chez les collègues qui ont le tableau ouvert ; chacune indique le fichier et la ligne du TODO. > **Ce que la connexion de Zed vous laisse contrôler** — La connexion OAuth de Zed porte vos droits complets dans Ondes PRO, pas davantage. Elle apparaît dans l’onglet **MCP** de **API & Développeurs** sous le nom de votre machine ; « Révoquer » la coupe immédiatement. Le jeton d’accès ne dure qu’une heure et chaque appel est journalisé avec la mention « MCP ». Tous les détails : [sécurité du serveur MCP](https://ondes.pro/fr/integrations/mcp/securite). ## Pour aller plus loin - [Kanban](https://ondes.pro/fr/integrations/mcp/modules/kanban) — Votre assistant IA crée, déplace et commente les cartes de vos tableaux, et vos collègues le voient en direct. - [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. - [Qu’est-ce que MCP ?](https://ondes.pro/fr/integrations/mcp/qu-est-ce-que-mcp) — Le guide complet du Model Context Protocol : définition, fonctionnement, comparaisons, sécurité et adoption. - [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 Zed ? Ajoutez une entrée sous `context_servers` dans `settings.json`, avec l’adresse du serveur dans `url`. Pour Ondes PRO : `"ondes": { "url": "https://.ondes.pro/mcp/" }`. Zed lance ensuite l’autorisation OAuth. ### Faut-il une clé API pour connecter Zed à Ondes PRO ? Non. Sans en-tête d’authentification, Zed mène seul la connexion OAuth avec votre espace. La clé API n’est utile que si vous voulez une connexion limitée à certains modules ou à la lecture seule. ### Peut-on limiter Zed à la lecture de la documentation ? Oui, avec un profil d’agent qui n’active que les six outils de documentation. L’agent garde l’accès au guide et aux fiches des ressources de votre espace, sans `ondes_appeler` ni `ondes_assistant`. ### Une carte créée par Zed apparaît-elle tout de suite pour l’équipe ? Oui : les tableaux Kanban d’Ondes PRO sont en temps réel, quelle que soit l’origine de l’écriture. Une carte créée par l’agent apparaît en direct chez les collègues qui ont le tableau ouvert. ### Zed est-il testé par l’équipe Ondes PRO ? Non, Zed est classé « compatible MCP standard » : son entrée `context_servers` suit le protocole que respecte notre serveur, y compris la découverte OAuth, donc la connexion doit fonctionner. Seul Claude a été vérifié de bout en bout par notre équipe ; si un réglage de Zed change de nom, sa documentation fait foi.