Skip to main content

Configurer VS Code (GitHub Copilot)

Préversion

Le serveur MCP est actuellement en préversion. Les configurations ci‑dessous pointent vers api-preview.stoxiio.com.

Connectez Stoxiio à GitHub Copilot dans VS Code grâce au support MCP intégré. Cela vous permet de poser des questions à Copilot Chat sur vos portefeuilles, votre patrimoine et vos tableaux de bord directement depuis votre éditeur.

Prérequis​

  • VS Code 1.99+ (le support MCP a été ajouté dans la version 1.99)
  • Extension GitHub Copilot installée et active
  • Une clé API Stoxiio en lecture seule — voir Générer une clé API

Configuration​

Option 1 — Configuration au niveau du workspace (recommandé pour les équipes)​

Créez un fichier .vscode/mcp.json à la racine de votre projet :

{
  "inputs": [
    {
      "id": "stoxiio-api-key",
      "type": "promptString",
      "description": "Clé API Stoxiio (commence par stx_)",
      "password": true
    }
  ],
  "servers": {
    "stoxiio": {
      "type": "http",
      "url": "https://api-preview.stoxiio.com/mcp",
      "headers": {
        "X-Api-Key": "${input:stoxiio-api-key}"
      }
    }
  }
}

Ce fichier peut être commité en toute sécurité dans le contrôle de version — la clé API elle‑même n'est jamais stockée dans le fichier. VS Code vous demandera la clé lors de la première utilisation puis la conservera de manière sécurisée dans son stockage de secrets intégré. La clé persiste entre les redémarrages — vous n'avez besoin de la saisir qu'une seule fois.

Option 2 — Configuration utilisateur (globale)​

Ouvrez vos Paramètres utilisateur VS Code (settings.json) et ajoutez :

{
  "mcp": {
    "inputs": [
      {
        "id": "stoxiio-api-key",
        "type": "promptString",
        "description": "Clé API Stoxiio (commence par stx_)",
        "password": true
      }
    ],
    "servers": {
      "stoxiio": {
        "type": "http",
        "url": "https://api-preview.stoxiio.com/mcp",
        "headers": {
          "X-Api-Key": "${input:stoxiio-api-key}"
        }
      }
    }
  }
}

Connexion​

  1. Ouvrez le panneau Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I).
  2. Cliquez sur le sélecteur de mode Agent (ou utilisez @ pour changer de mode).
  3. Assurez‑vous d'être en mode Agent — les outils MCP ne sont disponibles qu'en mode Agent.
  4. Lors de la première utilisation, VS Code vous demandera votre clé API. Saisissez votre clé stx_… — elle est stockée dans le stockage sécurisé de VS Code et persiste entre les redémarrages.
  5. Vous devriez voir une icône 🔧 ou la liste des outils indiquant que les outils Stoxiio sont disponibles.

Indicateur d'outils MCP dans VS Code

Vérifier la connexion​

Dans Copilot Chat (mode Agent), tapez :

Quels sont mes portefeuilles ?

Copilot devrait appeler l'outil list_portfolios et renvoyer vos données de portefeuille.

Dépannage​

ProblèmeSolution
Aucun outil affichéVérifiez que vous êtes en mode Agent, pas en mode Ask ou Edit.
401 UnauthorizedVérifiez que votre clé API est correcte et possède le scope Read.
Délai de connexion dépasséVérifiez que votre réseau peut atteindre https://api-preview.stoxiio.com/mcp.
« Serveur MCP introuvable »Assurez‑vous que le fichier mcp.json est dans .vscode/ à la racine de votre workspace.
Ressaisir la cléOuvrez la palette de commandes → « MCP: Reset Cached Input » pour effacer la clé stockée et être invité à la ressaisir.
tip

Vous pouvez vérifier l'état du serveur MCP dans le panneau Sortie → sélectionnez MCP dans le menu déroulant.