Le serveur Capital.com MCP permet à votre assistant IA de communiquer directement avec votre compte de trading. Données de marché, consultation des positions, aperçus de trades – le tout en langage clair, sans quitter votre outil IA.
Ce dont vous aurez besoin
- Un compte Capital.com
- Votre clé API Capital.com
- Votre mot de passe API personnalisé
- 2FA activé
Remarque : vous pouvez gérer ces éléments depuis les paramètres de votre compte.
Le mobile n’est pas pris en charge pour le moment.
Qu’est-ce que le serveur Capital.com MCP ?
Le serveur MCP est un logiciel qui s’exécute en arrière-plan sur votre ordinateur. Il agit comme un pont sécurisé entre votre assistant IA et votre compte Capital.com.
Une fois connecté, votre assistant IA peut :
- Rechercher des marchés disponibles dans le forex, les actions, les matières premières et les indices
- Afficher vos positions ouvertes, vos ordres en attente et le solde de votre compte
- Récupérer les prix historiques et d’autres données de marché
- Prévisualiser et passer des trades – avec votre confirmation requise à chaque fois
Vous restez pleinement responsable de toute décision de trading prise via le serveur MCP. Veuillez toujours vérifier attentivement les aperçus des trades avant de confirmer.
Éléments à vérifier avant de commencer
Vérifiez que tout ce dont vous avez besoin est installé. Si la réponse à l’une des questions suivantes est « Non », vous devrez suivre le lien fourni avant de continuer.
| Vérifier | Oui | Non |
|---|---|---|
| Avez-vous un compte Capital.com ? | Continuez | Créer un compte |
| Avez-vous installé votre outil d'IA préféré ? | Continuez | Quelques suggestions: Claude Code, Claude Desktop, Codex, Cursor, Windsurf. |
| Êtes-vous sur Mac ou Windows ? | Continuez | Le mobile n’est pas pris en charge pour le moment |
Claude Desktop : Guide d’installation rapide.
Si vous n’avez pas besoin d’instructions détaillées, voici la version courte pour Claude Chat sur Desktop.
- Obtenez vos identifiants API
- Connectez-vous à la page des paramètres de votre compte capital.com et obtenez votre mot de passe API.
- Téléchargez le MCP depuis Github
- L'URL du site web est : https://github.com/capital-com-sv/capital-mcp
- Ouvrez le bundle MCPB
- Double-cliquez sur le bundle pour le lancer, ou faites simplement glisser le fichier dans votre fenêtre Claude Desktop.
- Saisissez vos identifiants API
- Claude Desktop demandera vos identifiants API Saisissez-les et sélectionnez « Installer » N'oubliez pas d'activer le MCP.
- Redémarrez Claude
- Fermez complètement et rouvrez l'application, puis testez le lien en demandant : « Liste mes comptes »
Guide d'installation complet
Étape 1 – Créez vos identifiants API
Depuis votre compte Capital.com :
- Activez la 2FA si vous ne l'avez pas déjà fait. Paramètres → Authentification à deux facteurs.
- Générez une nouvelle clé API. Rendez-vous dans Paramètres → Intégrations API → Générer une nouvelle clé.
- Attribuez un libellé à votre clé, par exemple : Serveur MCP.
- Définissez votre mot de passe API.
Lisez ceci avant de taper quoi que ce soit : Vous créez un tout nouveau mot de passe, spécifiquement pour l'accès à l'API. Ce n'est pas lié à votre mot de passe de connexion Capital.com. Il est préférable de choisir quelque chose que vous vous souviendrez et de l'écrire. Ne réutilisez pas votre mot de passe de connexion ici. Confondre votre mot de passe de connexion avec votre mot de passe API est une erreur de configuration courante.
- Saisissez votre code 2FA et cliquez sur Générer.
- Copiez votre clé API et reconfirmez votre mot de passe API. Les deux ne sont affichés qu'une seule fois. Vous en aurez besoin plus tard. Lorsque cet écran sera fermé, ils disparaîtront.
Gardez-les privés. Ne les collez pas dans des interfaces de chat, ne les partagez pas avec d'autres personnes et ne les stockez pas dans un document partagé. Toute personne disposant de ces valeurs peut accéder à votre compte de trading via l'API.
Étape 2 – Téléchargez le MCP
Le serveur MCP de Capital.com est open source et se trouve dans un dépôt public GitHub. Avant que votre outil IA puisse l'utiliser, vous devez disposer d'une copie du code sur votre machine.
Téléchargez le code MCP sur votre machine locale depuis https://github.com/capital-com-sv/capital-mcp
Étape 3 – Connectez votre MCP à votre outil d'IA
Chaque outil IA se connecte au MCP de manière légèrement différente. Nous avons expliqué la connexion à Claude Desktop ici, mais pour les connexions à d'autres plateformes, lisez ici.
Pour Claude Desktop, double-cliquez sur le fichier mcpb pour le lancer, ou faites simplement glisser le fichier dans votre fenêtre Claude Desktop.
Vous verrez la fenêtre contextuelle ci-dessous sur votre application Claude Desktop. Installez le MCP et activez-le.
Étape 4 – Saisissez vos identifiants et configurez votre environnement
Saisissez vos identifiants obtenus à l'étape 1 dans les champs de configuration
| Valeur | D'où provient-elle ? |
|---|---|
| Clé API | Votre clé API de l'étape 1 |
| CAP_IDENTIFIER | Votre adresse e-mail Capital.com |
| CAP_API_PASSWORD | Votre mot de passe API personnalisé de l'étape 1 |
Étape 5 – Redémarrez votre outil d'IA et testez la connexion
Redémarrez votre outil IA et essayez les invites ci-dessous individuellement pour vérifier que votre connexion fonctionne
Connectez-vous à mon compte Capital.com
Lister mes comptes
Rechercher des marchés bitcoin
Comment passer un ordre
Chaque trade via le serveur MCP suit 3 étapes obligatoires. Le serveur impose cela – vous ne pouvez pas passer outre.
1. Aperçu
Demandez à votre assistant IA de prévisualiser un trade :
Prévisualiser l’achat de 1,5 SILVER avec un stop à 24,50
L'assistant renvoie une proposition de trade complète et un preview_id unique. Lisez chaque détail avant de valider.
2. Revue
Avant de confirmer, vérifiez :
- L'instrument est-il correct ? (Les codes sont sensibles à la casse : ARGENT pas argent)
- La taille de la position est-elle ce que vous aviez défini ?
- Les niveaux de stop et de limite sont-ils corrects ?
- Le risque semble-t-il adapté à la taille de votre compte ?
Si quelque chose semble incorrect, arrêtez. Demandez un nouvel aperçu avec des paramètres corrigés.
3. Confirmer
Ne validez ceci que si vous êtes satisfait de l'aperçu :
Exécuter la position avec preview_id abc123 confirm=true
Un trade ne peut pas être placé sans un preview_id valide. Chaque ID ne peut être utilisé qu'une seule fois et expire après exécution.
Avant de passer à un compte réel.
Complétez d'abord cette liste de contrôle :
- Les 3 invites de test à l'étape 5 ont renvoyé des données valides
- Vous avez prévisualisé et confirmé avec succès au moins un trade en mode démo
- Vous comprenez ce que signifie chaque champ dans l'aperçu du trade
- Vous avez modifié CAP_ENV en live et CAP_ALLOW_TRADING en true intentionnellement
- Vous avez lu les Conditions Générales et les Conditions de Trading Électronique de Capital.com
To restrict which markets the server can trade, add instrument codes to CAP_ALLOWED_EPICS (for example: SILVER,GOLD,EURUSD). Laissez-le vide pour autoriser tous les marchés sur votre compte.
Que puis-je demander à mon assistant IA ?
Vérifier votre compte
Se connecter à mon compte
Lister mes comptes
Vérifier l'état de ma connexion Capital.com
Rechercher des marchés
Rechercher des marchés bitcoin
Afficher les détails du marché EURUSD
Obtenir les prix historiques sur 1 heure pour l'or
Examiner votre portefeuille
Afficher mes positions ouvertes
Lister mes ordres en attente
Examiner l’exposition de mon portefeuille
Placer un trade (mode démo d'abord)
Prévisualiser l’achat de 1,5 SILVER avec un stop à 24,50
Créer une proposition de trade sur GOLD avec un risque de 1%
Exécuter la position avec preview_id abc123 confirm=true
Clôturer la position DEAL_ID confirmer=true
Dépannage
Exécutez d'abord le contrôle d'état. Demandez à votre assistant IA : Vérifier l'état de ma connexion Capital.com. La réponse vous indiquera généralement ce qui ne va pas.
| Ce que vous voyez | Cause la plus probable | Corriger |
|---|---|---|
| « Échec de l'authentification » ou « Session expirée » | CAP_API_PASSWORD est défini sur votre mot de passe de connexion au lieu du mot de passe API personnalisé que vous avez créé à l'étape 1 | Utilisez le mot de passe que vous avez créé lors de la génération de la clé API, et non votre mot de passe de connexion au site. |
| « Limite de débit dépassée » | Trop de requêtes envoyées rapidement | Attendez 30 à 60 secondes, puis réessayez |
| zsh : événement non trouvé(Mac uniquement) | Votre mot de passe API contient un point d'exclamation (!) | Placez la valeur du mot de passe entre guillemets simples dans la config : 'votreMotDePasse!Ici' |
| « Serveur ne répond pas » / le serveur ne démarre pas | Mauvais chemin Python ou le serveur ne s'est pas installé correctement | Ouvrez le Terminal et exécutez python -m capital_mcp.server directement – le message d'erreur sera lisible |
| Moins de 36 outils affichés | Serveur démarré mais la configuration contient une erreur | Vérifiez : (1) tous les espaces réservés remplacés par des valeurs réelles, (2) pas de "{ } , manquants, (3) le chemin Python pointe vers le dossier venv, pas vers Python système |
| Aucune réponse à aucune invite | Fichier de config non enregistré ou assistant IA pas complètement redémarré | Fermez complètement et rouvrez votre assistant IA – ne vous contentez pas de fermer la fenêtre |
| « 401 Non autorisé » | Clé API expirée ou révoquée | Allez dans Paramètres → Intégrations API sur Capital.com et générez une nouvelle clé |
| « Incompatibilité d'environnement » | CAP_ENV défini sur live mais les identifiants sont pour un compte démo | Mettez à jour CAP_ENV dans votre fichier de config pour qu'il corresponde à votre type de compte |
Toujours bloqué ? Soumettez une demande d'assistance et incluez : quel assistant IA vous utilisez, votre système d'exploitation et le message d'erreur complet.
FAQ
Ai-je besoin d'un abonnement payant à un assistant IA ? Certains assistants IA nécessitent un abonnement payant pour utiliser les fonctionnalités MCP. Claude Desktop, par exemple, nécessite un plan payant pour activer les connecteurs MCP. Le serveur MCP de Capital.com est gratuit.
Avez-vous besoin d’un compte de trading réel ? Non Le serveur fonctionne avec un compte démo et c’est là que nous vous recommandons de commencer.
Votre mot de passe de connexion à Capital.com est-il le même que CAP_API_PASSWORD ? Non. Ils sont différents. CAP_API_PASSWORD est un nouveau mot de passe que vous créez spécifiquement lors de la génération de votre clé API. Utiliser votre mot de passe de connexion ici entraînera un échec de l'authentification.
L'IA peut-elle passer un ordre sans que je le sache ? Non. Chaque ordre nécessite une étape d'aperçu suivie d'un message de confirmation séparé contenant confirm=true. Le serveur ne peut pas exécuter un ordre sans les deux. L'ID d'aperçu est à usage unique et expire immédiatement après l'exécution.
Qu'est-ce que CAP_ALLOW_TRADING et dois-je le modifier ? C'est un interrupteur de sécurité. Lorsqu'il est défini sur false, le serveur peut afficher les données de marché et les informations de compte mais ne peut pas passer d'ordres. Ne le passez à true que lorsque vous avez tout testé en mode démo et que vous êtes prêt à trader avec de l'argent réel.
Que fait CAP_ALLOWED_EPICS ? Cela limite les instruments sur lesquels le serveur peut trader. Laissez-le vide pour autoriser tous les marchés sur votre compte. Ajoutez une liste séparée par des virgules (par exemple : SILVER,GOLD,EURUSD) pour la restreindre.
Je vois moins de 36 outils dans mon assistant IA. Qu'est-ce qui ne va pas ? Demandez à votre assistant IA : Vérifier l'état de ma connexion Capital.com. Les causes les plus courantes sont une erreur de formatage dans le fichier de configuration JSON, ou le chemin Python qui pointe vers l'installation système au lieu du dossier venv.
Vos données de trading sont-elles sécurisées ? Le serveur s'exécute en local sur votre ordinateur. Vos identifiants sont stockés uniquement dans votre fichier de configuration local et ne sont jamais envoyés à des tiers. Toute communication avec Capital.com utilise un chiffrement HTTPS.
Puis-je l'utiliser sur deux ordinateurs ? Oui. Répétez l'étape 2 sur la deuxième machine en utilisant les mêmes identifiants API de l'étape 1.
Puis-je me connecter à plus d'un compte Capital.com ? Le serveur se connecte à un compte à la fois. Pour changer, mettez à jour les 4 valeurs CAP_ dans votre fichier de configuration et redémarrez votre assistant IA.
Avertissement – Utilisation de l’API publique Capital.com avec des outils tiers
Intégration tierce
Cette page décrit comment les clients peuvent connecter l'API Public à des logiciels, outils ou intégrations tiers, y compris ceux alimentés par l'intelligence artificielle ou les grands modèles de langage ("LLM"). Tout logiciel, outil ou intégration tiers de ce type est indépendant et ne fait pas partie des services de Capital.com. Capital.com ne contrôle, ne développe, n'approuve ni n'accepte aucune responsabilité pour tout logiciel tiers, ses fonctionnalités, ses résultats ou toute conséquence découlant de son utilisation. Toute utilisation d'outils ou d'intégrations tiers en lien avec l'API Public se fait à vos propres risques. Il vous incombe de consulter les conditions, les politiques de confidentialité et les pratiques de traitement des données de tout outil tiers que vous choisissez d’utiliser.
Utilisation de l’API publique
Votre utilisation de l’API publique Capital.com se fait à votre seule discrétion et à vos propres risques. Capital.com met l’API publique à disposition à des fins d’information et de trading, mais ne recommande, n’approuve ni n’encourage aucune utilisation, intégration ou stratégie de trading particulière. Vous êtes seul responsable de la manière dont vous accédez à l’API et l’utilisez, y compris les paramètres de tout ordre soumis, la configuration de tout outil ou système connecté, et l’interprétation de toute donnée reçue. Capital.com décline toute responsabilité pour les pertes ou conséquences involontaires découlant de votre utilisation de l’API, que celle-ci soit effectuée directement ou via des outils tiers. La disponibilité, les fonctionnalités et les spécifications de l’API peuvent être modifiées, limitées en débit, suspendues ou interrompues à tout moment et sans préavis. Votre utilisation de l'API publique est soumise aux Conditions Générales et aux Conditions de Trading Électronique de Capital.com, que vous devez lire attentivement avant d'utiliser l'API.
Service d’exécution uniquement et absence de conseil en investissement.
Capital.com fournit ses services sur une base d’exécution uniquement. Le trading d’instruments financiers comporte un risque de perte important. Aucun élément de cette page, de l’API publique, ou de tout logiciel ou intégration tiers ne constitue un conseil en investissement, une recommandation personnalisée, ou une sollicitation d’achat ou de vente d’un instrument financier. Cela inclut toute sortie, signal, suggestion ou analyse générée par l’IA, les outils basés sur des LLM ou d’autres outils automatisés. Toutes les décisions de trading, y compris toute activité automatisée ou algorithmique, sont prises à vos propres risques et relèvent de votre seule responsabilité.
Risques du Trading Automatisé et Algorithmique
L'utilisation de l'API Public en lien avec des outils de trading automatisé ou algorithmique comporte des risques supplémentaires, notamment : l'exécution rapide d'ordres sans examen ni intervention humaine ; les erreurs système, les défaillances logicielles ou les problèmes de connectivité ; l'exécution à des prix sensiblement différents de ceux attendus ; et les ordres non intentionnels ou erronés résultant d'outils ou de paramètres mal configurés. Capital.com n’est pas responsable des pertes découlant de ces risques ou de l’interaction entre ses systèmes et des outils tiers. Les performances passées et les résultats générés par des outils automatisés ne préjugent pas des résultats futurs.
Utilisation interdite
L'API publique et tout outil connecté ne doivent pas être utilisés pour manipuler la plateforme, exploiter les prix ou la latence, se livrer à des abus de marché, ou obtenir un avantage injuste. Capital.com se réserve le droit de restreindre, suspendre ou résilier l’accès à l’API et/ou votre compte lorsqu’il estime raisonnablement qu’un tel usage abusif a eu lieu ou est susceptible de se produire. Les clients ne doivent pas permettre à un tiers d’exercer un contrôle discrétionnaire sur leur compte.
Vos Responsabilités
Vous êtes responsable de vous assurer que votre utilisation de la plateforme, de l'API Public et de tout outil ou intégration tiers est conforme aux Conditions Générales de Capital.com et à toutes les lois et réglementations applicables dans votre juridiction. Vous devez examiner attentivement si les outils de trading automatisé sont adaptés à votre situation, votre expérience et votre tolérance au risque avant de les utiliser. Capital.com vous recommande vivement de tester tout outil ou intégration automatisé de manière approfondie à l'aide d'un compte démo avant de les connecter à un environnement de trading réel.