Connecter VS Code à un serveur Voozeo MCP
Mis à jour le 24 octobre 2026
Pour connecter VS Code à votre serveur Voozeo MCP, collez un bloc dans .vscode/mcp.json : VS Code demande la clé au premier démarrage, sans la stocker dans le fichier.
Ce qu'il vous faut
- Un serveur Voozeo à l'état « active », c'est-à-dire avec au moins une source prête. Voir la prise en main.
- La clé MCP de ce serveur. Elle n'est affichée qu'une seule fois ; si vous l'avez perdue, régénérez-la.
- Si votre serveur utilise OAuth 2.0, aucune clé : ajoutez la seule URL du serveur, puis chaque personne se connecte avec son propre compte chez le fournisseur de l'API au premier appel. Voir serveurs en OAuth.
- Une version de VS Code qui prend en charge MCP.
Ajouter le serveur
- Dans Voozeo, ouvrez votre serveur, allez dans l'onglet « Connexion » et choisissez VS Code. L'URL réelle est déjà insérée. Si le bloc affiche
<YOUR_KEY>, remplacez-le par votre clé. - Créez le fichier
.vscode/mcp.jsondans votre projet et collez le bloc. - Démarrez le serveur depuis VS Code. Il demande la clé : collez votre clé MCP.
VS Code · .vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "voozeo-key",
"description": "Voozeo API key",
"password": true
}
],
"servers": {
"mon-serveur": {
"type": "http",
"url": "https://mcp.example.com/s/<id-du-serveur>/mcp",
"headers": {
"Authorization": "Bearer ${input:voozeo-key}"
}
}
}
}VS Code utilise l'URL avec la clé dans l'en-tête Authorization, et la clé vient d'une saisie masquée. Le fichier peut donc être versionné sans risque : il ne contient aucun secret. Voir les deux formes d'URL.
Installation en un clic
Juste après la création du serveur ou la régénération de sa clé, l'onglet Connexion affiche un bouton « Ajouter à VS Code ». Il ouvre VS Code avec le serveur déjà renseigné, clé comprise : utilisez-le seulement sur votre propre ordinateur. Le bouton n'est pas affiché dans l'application Android, ni quand la clé ne peut plus être affichée : copiez alors le bloc ci-dessus.
Vérifier la connexion
- Demandez à l'assistant de VS Code de lister les outils du serveur, ou posez-lui une question qui en nécessite un.
- Ouvrez l'onglet « Journal » du serveur dans Voozeo : chaque appel d'outil y apparaît.
- En cas de doute, essayez d'abord l'outil dans l'onglet « Test ». Voir tester dans le bac à sable.
Dépannage
| VS Code signale | Cause probable | Où regarder |
|---|---|---|
| Erreur d'authentification (401) | Clé absente, fausse, d'un autre serveur ou régénérée | 401 côté IA |
| Accès refusé (403) | Serveur pas « active », ou espace suspendu | 403 côté IA |
| Message de quota | La limite mensuelle d'appels de votre offre est atteinte | Quota atteint |
Consultez aussi la documentation officielle de VS Code sur la configuration MCP.
Pour aller plus loin
- Autres clients : Claude, ChatGPT, Cursor.
- Créez d'abord le serveur : OpenAPI vers MCP ou documents vers MCP.
- Référence complète : connecter son IA.