Présentation
Le serveur MCP de Stoxiio est actuellement en préversion. Seul l'environnement de préversion (api-preview.stoxiio.com) est disponible pour le moment. Les fonctionnalités, outils et comportements peuvent évoluer avant la mise en production.
Le serveur MCP de Stoxiio vous permet de connecter des assistants IA — tels que GitHub Copilot, Claude, Cursor ou tout client compatible avec le Model Context Protocol — directement à votre compte Stoxiio. Une fois connecté, vous pouvez poser des questions en langage naturel sur vos portefeuilles, votre patrimoine, vos tableaux de bord, et bien plus encore. L'IA appellera automatiquement les bons outils Stoxiio en arrière‑plan.
Qu'est‑ce que le MCP ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux modèles d'IA d'interagir de manière sécurisée avec des sources de données externes via un ensemble d'outils déclarés. Au lieu de copier‑coller vos données dans une fenêtre de chat, le MCP permet à l'IA de lire vos données à la demande tout en gardant l'authentification et l'autorisation sous votre contrôle.
Comment ça fonctionne
┌─────────────────────┐ ┌──────────────────────────┐ ┌─────────────────┐
│ Assistant IA │ MCP │ API Stoxiio │ BDD │ Vos données │
│ (VS Code, Claude, │◄──────►│ endpoint /mcp │◄──────►│ Portefeuilles, │
│ Cursor, etc.) │ HTTP │ Auth par clé API (Read)│ │ Tableaux de… │
└─────────────────────┘ └──────────────────────────┘ └─────────────────┘
- Votre client IA se connecte à
https://api-preview.stoxiio.com/mcpà l'aide d'une clé API en lecture seule. - Le serveur MCP annonce un ensemble d'outils (ex.
list_portfolios,get_wealth_summary). - Lorsque vous posez une question, l'IA sélectionne le ou les outils appropriés et envoie les requêtes.
- Stoxiio renvoie les données et l'IA formule une réponse lisible.
Prérequis
| Prérequis | Détails |
|---|---|
| Compte Stoxiio | Créez un compte si vous n'en avez pas encore. |
| Clé API avec le scope Read | Accédez à Paramètres → Clés API dans l'application, ou voir Générer une clé API. |
| Client IA compatible MCP | VS Code (GitHub Copilot), Claude Code CLI, Cursor, Windsurf, etc. |
Point de terminaison
| Environnement | URL | Statut |
|---|---|---|
| Préversion | https://api-preview.stoxiio.com/mcp | ✅ Disponible |
| Production | https://api.stoxiio.com/mcp | 🚧 Bientôt disponible |
Le point de terminaison MCP utilise le transport Streamable HTTP avec un repli SSE (Server‑Sent Events).
Pendant la phase de préversion, toutes les configurations de ce guide pointent vers api-preview.stoxiio.com. Une fois la fonctionnalité disponible en version générale, l'URL de production sera activée et cette documentation sera mise à jour.
Modèle de sécurité
- Le point de terminaison MCP accepte uniquement l'authentification par clé API (en‑tête
X-Api-Key). - Les jetons JWT Bearer ne sont pas pris en charge sur le point de terminaison MCP.
- La clé API doit avoir au minimum le scope Read. Les clés avec le scope Write fonctionneront également, mais aucun outil en écriture n'est actuellement exposé.
- Les clés API sont liées à votre compte utilisateur — l'assistant IA voit exactement les mêmes données que vous dans l'application Stoxiio.
Utilisez toujours une clé API en lecture seule pour les intégrations MCP. Cela respecte le principe du moindre privilège et garantit qu'aucun assistant IA ne puisse modifier accidentellement vos données.