# Connecter Ondes PRO à Visual Studio Code (GitHub Copilot)

> Connectez Ondes PRO à Visual Studio Code et au mode agent de GitHub Copilot : fichier .vscode/mcp.json, OAuth ou clé masquée par inputs, exemples concrets.

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

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.

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

1. **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/" }
  }
}
```
3. **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.
4. **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.
5. **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.

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)** (.vscode/mcp.json)

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

**Connexion par clé API** (.vscode/mcp.json)

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

_Compatible MCP standard. Documentation de l’éditeur : https://code.visualstudio.com/docs/agents/reference/mcp-configuration_

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

_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.
>
> 🔧 `ondes_chercher` Terme « webhook » : la ressource `developer/abonnements` et la section du guide sur la signature.
>
> 🔧 `ondes_appeler` `GET developer/abonnements/catalogue/` — l’événement `kanban.cartes.cree` existe.
>
> 🔧 `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

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