Skip to main content

Configurer Claude Code CLI

Préversion

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

Connectez Stoxiio à l'interface en ligne de commande Claude Code pour interroger vos données financières depuis le terminal.

Prérequis​

Configuration​

Claude Code lit les configurations de serveurs MCP depuis un fichier .mcp.json.

Option 1 — Configuration au niveau du projet​

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

{
  "mcpServers": {
    "stoxiio": {
      "type": "http",
      "url": "https://api-preview.stoxiio.com/mcp",
      "headers": {
        "X-Api-Key": "stx_votre_clé_api_ici"
      }
    }
  }
}
caution

Si vous utilisez un .mcp.json au niveau du projet, assurez‑vous de l'ajouter à votre .gitignore pour que votre clé API ne soit pas commitée dans le contrôle de version :

.mcp.json

Option 2 — Configuration globale​

Ajoutez le serveur à votre configuration globale Claude Code dans ~/.claude.json :

{
  "mcpServers": {
    "stoxiio": {
      "type": "http",
      "url": "https://api-preview.stoxiio.com/mcp",
      "headers": {
        "X-Api-Key": "stx_votre_clé_api_ici"
      }
    }
  }
}

Option 3 — Via la CLI​

Vous pouvez également ajouter le serveur de manière interactive :

claude mcp add stoxiio --transport http --url https://api-preview.stoxiio.com/mcp --header "X-Api-Key: stx_votre_clé_api_ici"

Pour l'ajouter globalement (disponible dans tous les projets) :

claude mcp add stoxiio --transport http --url https://api-preview.stoxiio.com/mcp --header "X-Api-Key: stx_votre_clé_api_ici" -s user

Stocker votre clé API en toute sécurité​

Les fichiers de configuration de Claude Code stockent la clé API en clair. Pour protéger votre clé à l'aide de variables d'environnement ou du gestionnaire de secrets de votre système, consultez :

👉 Stocker votre clé en toute sécurité

Vérifier la connexion​

Lancez Claude Code et posez une question :

claude
> Quel est mon patrimoine total ?

Claude devrait appeler l'outil get_wealth_summary et renvoyer la répartition de votre patrimoine.

Vous pouvez également vérifier que le serveur est bien enregistré :

claude mcp list

Dépannage​

ProblèmeSolution
Serveur non listéExécutez claude mcp list et vérifiez que l'entrée existe. Rajoutez‑la si nécessaire.
401 UnauthorizedVotre clé API est invalide ou n'a pas le scope Read. Générez‑en une nouvelle.
Erreur de connexionVérifiez votre connexion internet et que https://api-preview.stoxiio.com/mcp est accessible.
Outils non invoquésAssurez‑vous que Claude a l'utilisation des outils activée. Demandez explicitement : « Utilise les outils stoxiio pour… »