Connecter un éditeur de code

Connecter Ondes PRO à Visual Studio Code (GitHub Copilot)

Dans Visual Studio Code, c’est le mode agent de GitHub Copilot qui utilise les serveurs MCP. Déclarez celui de votre espace Ondes PRO dans .vscode/mcp.json : Copilot peut alors consulter la documentation de vos ressources, valider une requête sans rien écrire et répondre sur vos vraies données, sans quitter l’éditeur.

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 le serveur MCP d’Ondes PRO dans VS Code

Il vous faut VS Code avec GitHub Copilot activé. Dans une organisation, l’administrateur Copilot peut avoir désactivé les serveurs MCP : si rien n’apparaît, c’est la première chose à vérifier.

Créez le fichier de l’espace de travail
À la racine du dossier ouvert, créez .vscode/mcp.json. Vous pouvez aussi passer par la palette de commandes (« MCP: Add Server ») et choisir un serveur HTTP : VS Code écrit le fichier pour vous.
2
Déclarez le serveur sous la clé servers
Attention, VS Code n’utilise pas la clé mcpServers des autres éditeurs mais servers, avec un champ type qui vaut http pour un serveur distant.
json
```
{
  "servers": {
    "ondes": { "type": "http", "url": "https://votre-espace.ondes.pro/mcp/" }
  }
}
```
Démarrez le serveur
Au-dessus de la déclaration, VS Code affiche une action « Start ». Au premier démarrage, il vous demande de confirmer que vous faites confiance à ce serveur, puis d’autoriser la connexion : une fenêtre de votre espace Ondes PRO s’ouvre, vous vous connectez et validez l’écran de consentement.
Passez le chat en mode agent
Ouvrez le chat de Copilot et choisissez le mode Agent. Le bouton des outils liste ceux du serveur ondes : vous pouvez en décocher certains, par exemple garder la documentation et retirer les outils qui écrivent.
Posez une question liée à votre code
Par exemple : « Quels événements puis-je recevoir quand une carte Kanban est créée ? ». Copilot vous montre chaque appel d’outil et attend votre accord avant de l’exécuter.

Configuration .vscode/mcp.json prête à copier

La forme OAuth ne contient aucun secret. La forme par clé met la clé en clair : préférez la variante avec inputs juste en dessous.

Visual Studio CodeCompatible MCP standard

Où se règle la connexion : Le fichier .vscode/mcp.json de l’espace de travail (mode agent de GitHub Copilot).

Connexion par OAuth (recommandée)

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

.vscode/mcp.json

{
  "servers": {
    "ondes": {
      "type": "http",
      "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.

.vscode/mcp.json

{
  "servers": {
    "ondes": {
      "type": "http",
      "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 : code.visualstudio.com

Masquer la clé API avec inputs

Si vous passez par une clé API — pour une connexion limitée à un module, en lecture seule par exemple —, ne l’écrivez pas dans le fichier. Le tableau inputs de VS Code demande la valeur au premier démarrage, la garde dans le stockage sécurisé de l’éditeur et l’injecte à la place de ${input:ondes-cle}. Le fichier peut alors être versionné sans risque.

json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ondes-cle",
      "description": "Clé API Ondes PRO (opk_…)",
      "password": true
    }
  ],
  "servers": {
    "ondes": {
      "type": "http",
      "url": "https://votre-espace.ondes.pro/mcp/",
      "headers": { "Authorization": "ApiKey ${input:ondes-cle}" }
    }
  }
}

Créez la clé dans API & Développeurs → Clés API : elle ne s’affiche qu’une fois.

Configuration d’espace de travail ou configuration utilisateur ?

.vscode/mcp.json vit dans le dossier du projet. C’est la bonne place pour un dépôt d’intégration : toute l’équipe partage la déclaration, et chacun s’autorise avec son propre compte Ondes PRO — donc ses propres droits, et sa propre ligne dans l’onglet MCP de l’espace.

Pour avoir Ondes PRO dans tous vos dossiers, VS Code propose aussi une configuration utilisateur (commande « MCP: Open User Configuration »), au même format. Elle suit votre profil VS Code et, si vous l’avez activée, la synchronisation des réglages entre vos machines. Chaque machine reste une connexion distincte côté Ondes PRO.

Exemple : abonner l’outil de production d’Atelier Lumen aux nouvelles cartes

Jules Perrin, développeur chez Atelier Lumen, veut que l’outil interne de l’atelier soit prévenu dès qu’une carte est ajoutée au tableau Fabrication.

GitHub Copilot (VS Code) · Exemple de conversation · données de démonstration (Atelier Lumen)

Vous : Écris le récepteur de webhook dans src/hooks.ts pour les cartes Kanban créées, et abonne https://atelier.lumen-interne.fr/hooks côté Ondes PRO.
Outil MCP : ondes_chercher Terme « webhook » : la ressource developer/abonnements et la section du guide sur la signature.
Outil MCP : ondes_appeler GET developer/abonnements/catalogue/ — l’événement kanban.cartes.cree existe.
Outil MCP : ondes_appeler POST developer/abonnements avec simuler: true — refus lisible : l’origine https://atelier.lumen-interne.fr n’est pas déclarée dans la configuration de l’espace.
Assistant : Le récepteur est écrit : il vérifie l’en-tête Ondes-Signature (HMAC-SHA256 de l’horodatage et du corps) avant toute chose, puis relit la carte par son id, car la charge utile ne contient que l’identité de l’objet. L’abonnement, lui, n’a pas été créé : un administrateur doit d’abord déclarer l’origine de votre outil dans la configuration de l’espace. Je relancerai la création ensuite — le secret de signature ne sera affiché qu’à ce moment-là.

Bonnes pratiques avec Copilot et Ondes PRO

Laissez actifs les six outils de documentation : ils ne lisent que le guide et l’inventaire de votre espace, rien n’est modifié.
Pour une écriture, demandez d’abord une simulation : ondes_appeler avec simuler: true valide le corps de la requête sans rien enregistrer.
Sur les ressources qui ont un jumeau de test (commandes, réunions visio, envois d’e-mails, invitations), l’écriture part en mode test par défaut, et la réponse le dit.
Ne versionnez jamais une clé : inputs ou OAuth, jamais une valeur en clair dans .vscode/mcp.json.
Si Copilot propose un endpoint inconnu, demandez-lui de vérifier avec ondes_impossible : l’outil liste ce que l’API ne fait pas volontairement.

Pour aller plus loin

Questions fréquentes

Comment ajouter un serveur MCP dans VS Code ?

Créez .vscode/mcp.json et déclarez le serveur sous la clé servers avec "type": "http" et son adresse dans url — pour Ondes PRO, https://<votre-espace>.ondes.pro/mcp/. La commande « MCP: Add Server » de la palette fait la même chose pas à pas.

Faut-il GitHub Copilot pour utiliser un serveur MCP dans VS Code ?

Oui : dans VS Code, ce sont les fonctions d’agent de GitHub Copilot qui appellent les outils MCP. Dans une organisation, la politique Copilot doit autoriser les serveurs MCP.

Comment éviter d’écrire ma clé API dans mcp.json ?

Utilisez OAuth, qui ne demande aucune clé. Si une clé est nécessaire, déclarez un input de type promptString avec "password": true et référencez-le par ${input:…} : VS Code demande la valeur une fois et la stocke de façon sécurisée.

Pourquoi VS Code ne trouve-t-il pas mon serveur avec mcpServers ?

Parce que VS Code attend la clé servers, pas mcpServers comme Cursor ou Cline. Copier une configuration d’un autre éditeur sans renommer cette clé est l’erreur la plus fréquente.

Copilot peut-il modifier les données de mon entreprise ?

Seulement avec vos droits et après votre accord, appel par appel. Côté Ondes PRO, les écritures partent en mode test quand la ressource en a un, une simulation permet de valider sans écrire, et l’assistant intégré propose ses changements sous forme de plan à confirmer.

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

Non. Le mode agent de GitHub Copilot parle le protocole MCP standard en HTTP, celui de notre serveur : la déclaration type: http doit donc suffire. Seul Claude a été vérifié de bout en bout par notre équipe ; les menus de VS Code évoluent d’une version à l’autre, 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