Connecter un éditeur de code

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

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.

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

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

ZedCompatible MCP standard

Où se règle la connexion : La clé context_servers du fichier de réglages de Zed.

Connexion par OAuth (recommandée)

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

settings.json

{
  "context_servers": {
    "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.

settings.json

{
  "context_servers": {
    "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 : zed.dev

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_etatLecture
É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_guideLecture
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_chercherLecture
Chercher
Cherche un terme métier (« devis », « stock », « webhook ») à la fois dans l'inventaire des ressources et dans le guide.
ondes_ressourceLecture
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_impossibleLecture
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_exempleLecture
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

Léa termine la refonte du site d’Atelier Lumen. Il reste des TODO éparpillés dans le code ; elle veut les retrouver dans le tableau « Site web » de l’équipe.

Zed (panneau Agent) · 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.
Outil MCP : ondes_ressource Fiche kanban/cartes : column et title obligatoires, pas de jumeau de test — une création est réelle.
Outil MCP : ondes_appeler GET kanban/colonnes filtré sur le tableau Site web — la colonne « À faire » est trouvée.
Outil MCP : 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.
Outil MCP : 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.

Pour aller plus loin

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://<votre-espace>.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.

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