# Connecter VS Code à Nodary

L’agent de GitHub Copilot dans VS Code peut lire les spécifications et décisions de votre équipe dans Nodary et y écrire, avec vos droits.

Vérifié d’après la documentation de chaque éditeur le 22 octobre 2026.

## Avant de commencer

- VS Code avec GitHub Copilot. Sur Copilot Free, Pro, Pro+ et Max, aucune règle d’organisation ne régit les serveurs MCP.
- Sur Copilot Business et Enterprise, la règle « MCP servers in Copilot » de l’organisation doit être activée ; elle est désactivée par défaut. Une liste d’autorisation d’entreprise peut aussi limiter les serveurs que vous ajoutez.
- Un compte Nodary. Le serveur MCP est inclus dans toutes les offres ; sur Free, tant que l’espace reste dans les limites de l’offre : 1 projet, 10 documents et dossiers, 2 membres. Copilot ne dépense aucune Comète : il utilise son propre modèle.

Pas encore d’espace ? Créez-en un, puis revenez vous connecter. [Créer un espace gratuit](https://nodary.ai/sign-up)

## Ajouter Nodary

1. Ouvrez la palette de commandes (Ctrl+Maj+P, ou Cmd+Maj+P sur Mac) et lancez « MCP: Add Server ».
2. Choisissez « HTTP (HTTP or Server-Sent Events) » et saisissez l’adresse du serveur :

   ```
   https://nodary.ai/api/mcp
   ```
3. Saisissez nodary comme identifiant du serveur.
4. Choisissez « Global », puis « Copilot Global », pour utiliser Nodary dans tous vos espaces de travail. VS Code l’écrit dans ~/.copilot/mcp-config.json :

   ```
   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }
   ```
5. Au démarrage du serveur, acceptez les demandes de confiance et de connexion : la page de consentement de Nodary s’ouvre dans votre navigateur.

**Anciennes configurations :** VS Code lit encore .vscode/mcp.json et le mcp.json de votre profil utilisateur, qui utilisent servers au lieu de mcpServers, et les signale comme obsolètes.

## Se connecter et choisir les espaces

La page de consentement de Nodary indique l’application qui demande l’accès et l’adresse vers laquelle elle sera renvoyée. Connectez-vous si ce n’est pas déjà fait, puis choisissez les espaces que Copilot pourra atteindre : avec un seul espace, vous le sélectionnez ; avec plusieurs, aucun n’est coché d’avance, cochez donc chacun de ceux que Copilot pourra utiliser. Si vous vous êtes connecté il y a plus de 10 minutes, Nodary vous redemande votre mot de passe. Approuvez, et le navigateur vous ramène à Copilot.

Copilot agit alors en votre nom : il voit et modifie seulement ce que votre rôle permet, dans les espaces cochés. Son accès dure 60 minutes à la fois et Copilot le renouvelle seul.

## Utiliser Nodary dans Copilot Chat

Dans Copilot Chat, vérifiez que les outils de Nodary sont activés (« Configure Tools », ou « Chat: Open Customizations », puis « Tools »), puis formulez votre demande simplement. Quelques demandes pour commencer :

- Lis le document de conception de l’API dans Nodary et vérifie ce point d’accès par rapport à lui.
- Rédige un enregistrement de décision pour le passage à Postgres, range-le dans Architecture et relie-le à la spécification.
- Quels documents du projet Backend sont encore des brouillons, et qui en est responsable ?

## Avec une clé d’API à la place

Ajoutez l’en-tête à ~/.copilot/mcp-config.json, un fichier de votre dossier personnel que vous ne versionnez jamais :

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}
```

**En clair :** VS Code ne lit dans ce fichier aucune variable demandée à l’utilisateur : la clé y reste écrite telle quelle. Donnez-lui une expiration de 30 ou 90 jours, et révoquez-la dans Nodary si l’ordinateur est perdu.

Créez la clé dans Nodary, sous « Profil », « Clés d’API et MCP ». Elle commence par gdc_, ne s’affiche qu’une fois, agit avec vos droits, peut être limitée à un projet et expire après 30, 90 ou 365 jours, ou jamais, selon votre choix.

![La section Clés d’API et MCP d’un profil Nodary : l’adresse du serveur MCP à coller dans un client IA, et une clé d’agent avec sa portée.](https://nodary.ai/marketing/mcp-connect.webp)

## Si quelque chose ne fonctionne pas

- VS Code indique qu’une restriction d’entreprise bloque le serveur : interrogez votre administrateur sur la règle « MCP servers in Copilot » et la liste d’autorisation de l’entreprise.
- Aucune connexion ne s’affiche : lancez « MCP: List Servers », redémarrez nodary et acceptez les demandes. Si la connexion n’aboutit toujours pas, utilisez une clé d’API.
- Une première requête qui reçoit une réponse 401 est normale : elle indique au client où se connecter.
- quota_locked : l’espace dépasse l’offre Free après son essai et reste bloqué jusqu’à ce que le propriétaire s’abonne. Tout refonctionne dès l’abonnement.
- billing_locked : un paiement a échoué, l’espace reste donc bloqué jusqu’à ce que le propriétaire le règle dans la facturation de l’espace. Tout refonctionne dès que le paiement passe.
- workspace_suspended : Nodary a suspendu l’espace, plus rien ne l’atteint, agents compris. Le propriétaire peut écrire à support@nodary.ai.
- workspace_required : la connexion atteint plusieurs espaces, nommez donc celui où travailler, ou reconnectez-vous en ne cochant qu’un espace.

## Questions

### Connecter Copilot coûte-t-il quelque chose ?

Pas du côté de Nodary. Le serveur MCP est inclus dans toutes les offres, Free compris dans ses limites, et Copilot ne dépense aucune Comète : les Comètes ne comptent que Studio AI. Votre offre Copilot décide si vous pouvez ajouter le serveur.

### Copilot Business indique que les serveurs MCP sont désactivés. Que faire ?

Un administrateur de l’organisation ou de l’entreprise active la règle « MCP servers in Copilot », désactivée par défaut. Copilot Free, Pro, Pro+ et Max n’en dépendent pas.

### Faut-il installer Node.js ou autre chose ?

Non. Nodary est un serveur distant : VS Code lui parle en HTTPS et rien ne tourne sur votre ordinateur.

### Copilot peut-il supprimer ou écraser mes documents ?

Seulement là où votre rôle le permet, et une modification peut être annulée : chaque session d’édition de dix minutes au plus forme une version, comme chaque écriture d’agent. Un document garde ses 50 versions les plus récentes faites par des personnes et ses 50 plus récentes faites par des agents (celles des agents ne chassent jamais celles des personnes), que vous comparez et restaurez, et un document supprimé revient pendant 30 jours. Les liens de partage, les accès, les membres, les rôles, les clés, la facturation et la suppression d’un projet restent des décisions humaines : aucun agent ne peut les prendre.

### Comment le déconnecter ?

Dans Nodary, ouvrez « Profil », « Sécurité », « Applications connectées » et déconnectez-le : il s’arrête aussitôt. Dans VS Code, retirez nodary de ~/.copilot/mcp-config.json ou arrêtez-le depuis « MCP: List Servers ». Une clé se révoque sous « Profil », « Clés d’API et MCP », et les propriétaires et administrateurs peuvent révoquer toute clé de l’espace dans ses paramètres, rubrique MCP.

### Nodary utilise-t-il mes documents pour entraîner une IA ?

Non. Nodary n’utilise pas le contenu des espaces pour entraîner des modèles d’IA. Ce que Copilot fait de ce qu’il lit relève des conditions de son éditeur.

## À lire ensuite

- [Connecter Cursor à Nodary](https://nodary.ai/fr/docs/mcp/cursor): Ajoutez Nodary au fichier mcp.json de Cursor, puis connectez-vous depuis Cursor.
- [Connecter Claude Code à Nodary](https://nodary.ai/fr/docs/mcp/claude-code): Une commande ajoute Nodary à Claude Code, puis /mcp vous connecte.
- [Le serveur MCP de Nodary](https://nodary.ai/fr/docs/mcp): Le serveur, la connexion, les 98 outils, la sécurité et tous les clients en un coup d’œil.
- [MCP (Model Context Protocol)](https://nodary.ai/fr/glossary/model-context-protocol): Le Model Context Protocol (MCP) est un standard ouvert qui relie les applications d’IA à des outils et des données externes par une interface commune.
- [OAuth](https://nodary.ai/fr/glossary/oauth): OAuth est une norme qui permet à une application d’agir pour vous dans un autre service, avec l’accès que vous approuvez, sans jamais voir votre mot de passe.

https://nodary.ai/fr/docs/mcp/vs-code