Comment configurer le serveur Capital.com AI MCP

Le serveur Capital.com MCP vous permet de connecter un assistant IA – tel que Claude Code, Codex, Claude Desktop, Cursor ou Windsurf – à votre compte de trading. Une fois configuré, vous pouvez utiliser le langage naturel pour analyser les marchés, consulter les informations de votre compte, examiner les positions ouvertes et les ordres en attente, ainsi que prévisualiser et placer des trades directement depuis votre assistant IA.

Ce guide vous accompagne à chaque étape, depuis la création de vos identifiants API et l’installation du serveur, jusqu’à la connexion de l’assistant IA de votre choix, ainsi que l’examen et la confirmation de chaque trade avant son exécution. Vous n’avez pas besoin d’être développeur, mais vous devez être à l’aise avec le suivi d’instructions techniques. Nous vous recommandons de commencer en mode démo avant de passer à un compte réel.

Qu’est-ce que le serveur MCP Capital.com ?

Le serveur MCP Capital.com (Model Context Protocol) est un outil gratuit et open-source qui vous permet de connecter un assistant IA à votre compte de trading à l’aide de vos identifiants API Capital.com et de votre authentification à deux facteurs (2FA). Il agit comme un pont entre votre compte et l’IA, permettant à l’assistant d’accéder aux données de marché et de compte, et de répondre à vos instructions en temps réel.

Une fois connecté, votre assistant IA peut :

• Rechercher des marchés disponibles (tels que le forex, les actions, les matières premières et les indices).
• Afficher vos positions ouvertes, vos ordres en attente et les informations de votre compte.
• Récupérer les données historiques de prix et les données de sentiment des clients.
• Prévisualiser et exécuter des trades, avec confirmation explicite requise avant exécution.

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.

Quels assistants IA puis-je utiliser ?

Ce guide couvre l’installation pour Claude Code, Codex, Claude Desktop, Cursor et Windsurf.

Si vous ne savez pas par où commencer, Claude Code peut être une option pratique si vous êtes à l’aise avec l’utilisation du terminal. Claude Desktop peut mieux vous convenir si vous préférez modifier un fichier de configuration.

Étape 1. Créez vos identifiants API

Tout d'abord, générez des identifiants API dans votre compte Capital.com. Cela peut prendre environ deux minutes.

1. Connectez-vous à votre compte Capital.com.
2. Activez l'authentification à deux facteurs (2FA).
3. Rendez-vous dans Paramètres → Intégrations API → Générer une nouvelle clé.
4. Attribuez un libellé à votre clé, par exemple : Serveur MCP.
5. Créez un mot de passe API personnalisé. Celui-ci est distinct de votre mot de passe habituel de connexion à Capital.com.
6. Entrez votre code 2FA et générez la clé.
7. Copiez la clé API immédiatement. Elle ne sera plus affichée.

Vous aurez besoin des valeurs suivantes dans les étapes suivantes :

*Entraînez-vous sur un compte démo avant de passer au trading réel.

Important: ces identifiants donnent accès à votre compte de trading. Gardez-les privés. Ne les partagez pas et ne les collez pas dans des interfaces de chat, et ne les stockez pas dans des documents publics. Toute personne ayant accès à ces informations peut être en mesure d’accéder à votre compte via l’API.

Étape 2. Installez le serveur MCP Capital.com

Ceci est une installation unique. Vous avez deux options – l'option A est recommandée pour la plupart des utilisateurs.

Option A. Installation rapide (recommandée)

Le serveur MCP inclut un fichier bundle qui permet à Claude Desktop de gérer l’installation pour vous — sans besoin de terminal ni de modification de fichier de configuration.

Avant de commencer : assurez-vous que uv est installé (par exemple, via brew install uv sur Mac) et que Node.js est installé pour la commande pack.

1. Dans votre terminal, clonez le dépôt et générez le bundle :

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

2. Ouvrez capital-mcp.mcpb en double-cliquant dessus, ou glissez-le dans Claude Desktop.
3. Claude Desktop vous demandera vos identifiants API. Saisissez-les, puis cliquez sur « Installer ».
4. Redémarrez Claude Desktop et vérifiez la connexion en demandant : « Quels outils Capital.com sont disponibles ? »

Option B. Installation manuelle.

Utilisez cette option si vous préférez ne pas utiliser le bundle, ou si vous vous connectez à Codex, Cursor ou Windsurf.

Terminal (Mac)

1. Téléchargez les fichiers du serveur

cd ~/Desktop

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

2. Créez un environnement Python isolé et installez les dépendances

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. Trouvez votre chemin Python

Vous aurez besoin de cela à l'étape suivante :

quel python

Cela devrait renvoyer un chemin de fichier similaire à :

/Users/you/Desktop/capital-mcp/venv/bin/python

Copiez et enregistrez ce chemin. Vous le collerez dans les paramètres de votre assistant IA à l'étape 3.

Astuce: Sur Mac, vous pouvez faire glisser un fichier depuis le Finder dans la fenêtre du Terminal pour afficher son chemin complet.

4. Vérifiez que le serveur démarre correctement

python -m capital_mcp.server

S'il n'y a pas d'erreurs, l'installation est terminée. Si vous voyez une erreur, résolvez-la maintenant – les messages d’erreur sont généralement plus faciles à diagnostiquer à ce stade que depuis l’interface d’un assistant IA.

Invite de commandes (Windows)

1. Téléchargez les fichiers du serveur.

cd %USERPROFILE%\Desktop

git clone  https://github.com/capital-com-sv/capital-mcp

cd capital.com-public-api-mcp

Cela télécharge le dépôt sur votre bureau et ouvre le dossier du projet.

2. Créez un environnement virtuel et installez les dépendances.

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

Cela crée un environnement virtuel pour garder les dépendances du projet séparées du reste de votre système. L'activer garantit que les paquets sont installés dans cet environnement.

3. Trouvez le chemin de votre Python.

Vous aurez besoin de cela à l'étape suivante :

où est python

Vous devriez voir quelque chose comme :

C:\Users\you\Desktop\capital.com-public-api-mcp\venv\Scripts\python.exe

Copiez et enregistrez ce chemin. Vous le collerez dans les paramètres de votre assistant IA à l'étape 3.

4. Vérifiez que le serveur démarre correctement.

python -m capital_mcp.server

S'il n'y a pas d'erreurs, l'installation est terminée. Si vous voyez une erreur, résolvez-la maintenant avant de continuer.

Étape 3. Connectez votre assistant IA

Les trois assistants IA ont besoin des mêmes informations essentielles. Rassemblez les éléments suivants avant de commencer :

Configuration de Claude Code 

Dans votre terminal, exécutez :

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Remplacez /path/to/capital-mcp/venv/bin/python par le chemin Python que vous avez copié à l'étape 2.

Pour confirmer la connexion, demandez à Claude : « Quels outils Capital.com sont disponibles ? » Vous devriez voir 36 outils listés.

Configuration de Codex 

Allez à Codex → Paramètres → Serveurs MCP → Ajouter un serveur et complétez les champs ci-dessous.

Commande

Collez votre chemin venv Python, par exemple :

/Users/you/Desktop/capital.com-public-api-mcp/venv/bin/python

Arguments

Ajoutez-les sous forme de deux entrées distinctes — ne les combinez pas :

1. -m
2. capital_mcp.server

Variables d'environnement

Ajoutez chaque variable individuellement :

Répertoire de travail

Définissez le répertoire de travail sur ~/code.

Enregistrez vos paramètres et redémarrez Codex.

Tapez /mcp dans le chat – vous devriez voir capital-com répertorié.

Pour confirmer la connexion, envoyez ces trois messages :

Vérifier l’état de ma session Capital.com

Se connecter à mon compte Capital.com

Lister mes comptes

Si les trois renvoient des réponses valides, le serveur est correctement connecté.

Installation de Claude Desktop.

Terminal (Mac)

Ouvrez le Terminal et exécutez les commandes suivantes pour créer le fichier de configuration :

mkdir -p ~/Library/Application\ Support/Claude

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Invite de commandes (Windows)

Ouvrez l'invite de commandes (CMD) et exécutez :

mkdir "%APPDATA%\Claude"

notepad "%APPDATA%\Claude\claude_desktop_config.json"

Terminal (Mac) et Invite de commandes (Windows)

Collez le modèle ci-dessous dans le fichier et remplacez chaque espace réservé EN MAJUSCULES par vos véritables valeurs :

{

  "mcpServers": {

"capital-com": {

   "command": "/PASTE/YOUR/VENV/PYTHON/PATH",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "PASTE_API_KEY",

     "CAP_IDENTIFIER": "PASTE_YOUR_EMAIL",

     "CAP_API_PASSWORD": "PASTE_API_PASSWORD",

     "CAP_ALLOW_TRADING": "false",

     "CAP_ALLOWED_EPICS": ""

   }

    }

  }

}

Enregistrez le fichier : appuyez sur Ctrl + O, puis Entrée, puis Ctrl + X. Redémarrer Claude Desktop.

Pour confirmer la connexion, demandez à Claude : « Quels outils Capital.com sont disponibles ? »

Vous devriez voir 36 outils répertoriés. Si moins d’outils apparaissent, consultez la section de dépannage ci-dessous.

Configuration de Cursor

Allez dans Paramètres → Outils et MCP, puis ajoutez :

{

  "capital-com": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "capital_mcp.server"],

"env": {

   "CAP_ENV": "demo",

   "CAP_API_KEY": "your_api_key",

   "CAP_IDENTIFIER": "your_email",

   "CAP_API_PASSWORD": "your_password",

   "CAP_ALLOW_TRADING": "false"

}

  }

}

Redémarrez Cursor et testez la connexion avec :

Lister mes comptes

Si la commande renvoie les informations de votre compte, l'intégration fonctionne comme prévu.

Configuration de Windsurf 

Créez ou modifiez le fichier à ~/.windsurf/mcp/servers.json et ajoutez :

{

  "mcpServers": {

"capital-com": {

   "command": "/path/to/capital-mcp/venv/bin/python",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "your_api_key_here",

     "CAP_IDENTIFIER": "your_email@example.com",

     "CAP_API_PASSWORD": "your_custom_password"

     "CAP_ALLOW_TRADING": "false"

   }

    }

  }

}

Remplacez toutes les valeurs des espaces réservés par vos véritables identifiants de l’étape 1.

Redémarrez Windsurf et testez la connexion avec : « Lister mes comptes ».

Comment trader avec le serveur MCP

Chaque trade passé via le serveur MCP suit un processus obligatoire en trois étapes. Le serveur impose ce processus et ne vous permet pas de le contourner.

Étape 1 – Prévisualisez votre trade

Demandez à votre assistant IA de prévisualiser un trade. Il renverra une proposition et un preview_id unique.

Exemple :

Prévisualiser l’achat de 1,5 [instrument]avec un stop à 24,50

Étape 2 –  Examinez la proposition

Lisez attentivement les détails renvoyés par l’IA avant de passer à toute autre action. Vérifiez l’instrument, la taille, le sens et les paramètres de risque pour vous assurer qu’ils correspondent à votre intention.

Si la taille que vous avez demandée est inférieure au minimum du broker ou supérieure au maximum pour cet instrument, le serveur renverra une erreur. Ajustez la taille et créez un nouvel aperçu.

Étape 3 – Confirmez l’exécution.

Si vous souhaitez poursuivre, envoyez un deuxième message pour confirmer :

Exécuter la position avec preview_id abc123 confirm=true

Un trade ne peut être passé sans un preview_id valide provenant d’un aperçu préalable. Le serveur exige ces deux étapes avant l’exécution.

Chaque ID d’aperçu ne peut être utilisé qu’une seule fois. Une fois le trade confirmé et exécuté, l’aperçu expire immédiatement. Pour passer un autre trade, commencez un nouvel aperçu.

Avant de passer à un compte réel.

Confirmez l’ensemble des points suivants :

• Tous les tests effectués en mode démo (CAP_ENV = demo).
• CAP_ALLOW_TRADING est resté  désactivé (false)  pendant toute l’installation.
• La connexion à la session, l’affichage des comptes et les données de marché fonctionnent tous correctement.
• L’intégralité du flux d’aperçu et d’exécution a été testée avec succès sur un compte démo.
• Vous avez consciemment décidé de passer CAP_ENV à live et CAP_ALLOW_TRADING à true.

Pour restreindre les marchés sur lesquels le serveur peut trader, ajoutez une liste d’épics (codes instruments) séparés par des virgules à CAP_ALLOWED_EPICS. Laissez ce champ vide pour autoriser l’accès à tous les marchés disponibles sur votre compte.

Troubleshooting: common errors and fixes {#errors}

Que puis-je demander à mon assistant IA ? 

Une fois connecté, vous pouvez commencer avec quelques exemples de consignes :

Vérifier votre compte

Vérifier l’état de ma session

Se connecter à mon compte

Lister mes comptes

Rechercher des marchés

Rechercher des marchés bitcoin

Afficher [instrument] les détails d’un marché

Obtenir les prix historiques sur 1 heure pour [instrument]

Quel est le sentiment des clients sur [instrument] ?

Examiner votre portefeuille

Afficher mes positions ouvertes

Lister mes ordres en attente

Examiner l’exposition de mon portefeuille

Passer un trade (commencer en mode démo)

Créer une proposition de trade pour [instrument] avec un risque de 1 %.

Prévisualiser l’achat de 1,5 [instrument]avec un stop à 24,50

Exécuter la position avec preview_id abc123 confirm=true

Fermer la position DEAL_ID confirmer=true

Les codes d'instrument sont sensibles à la casse. Utilisez les épics en majuscules (ex : SILVER, pas silver) pour éviter des erreurs.

Examinez toujours attentivement les aperçus des trades avant de confirmer l’exécution. Les résultats générés par l’IA sont des outils pour vous aider dans votre analyse. Ils ne remplacent pas votre jugement ni ne suppriment les risques associés au trading de CFD.

FAQ

Ai-je besoin d’un compte Capital.com réel pour utiliser le serveur MCP ?

Non. Le serveur MCP fonctionne avec un compte démo. Vous pouvez configurer et tester le serveur en mode démo avant de le connecter à un compte réel.

Mon mot de passe de connexion Capital.com est-il identique à CAP_API_PASSWORD ?

Non. Il s’agit de deux mots de passe distincts. CAP_API_PASSWORD est un mot de passe personnalisé que vous créez lors de la génération de votre clé API. Utiliser votre mot de passe de connexion dans ce champ est une erreur fréquente et entraînera un échec d’authentification.

L’IA peut-elle passer un trade sans mon autorisation ?

Non. Chaque trade nécessite une étape de prévisualisation suivie d’un message de confirmation explicite distinct contenant confirm=true. Le serveur n’exécutera aucun trade sans ces deux étapes. Vous devez confirmer explicitement chaque trade avant exécution.

Qu’est-ce que CAP_ALLOW_TRADING et dois-je l’activer ?

CAP_ALLOW_TRADING est un paramètre qui détermine si le serveur peut exécuter des trades. Conservez la valeur false pendant l’installation et les tests. Ne passez cette valeur à true qu’après avoir entièrement vérifié la connexion en mode démo et compris les risques du trading réel de CFD.

À quoi sert CAP_ALLOWED_EPICS ?

Il limite le serveur au trading d’instruments spécifiques. Si vous le laissez vide, tous les marchés disponibles sur votre compte sont accessibles. Ajoutez une liste d’épics (codes instruments) séparés par des virgules pour limiter le trading aux seuls instruments sélectionnés.

J’ai tout configuré mais Claude affiche moins de 36 outils. Quel est le problème ?

Le serveur ne démarre pas correctement Exécutez tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log pour consulter la sortie des logs. Les causes courantes incluent une erreur de syntaxe JSON dans le fichier de configuration ou un chemin Python pointant vers l’environnement Python système au lieu de l’environnement virtuel.

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 publique Capital.com à des logiciels, outils ou intégrations tiers, y compris ceux utilisant l’intelligence artificielle ou les grands modèles de langage (« LLM »). Ces logiciels, outils ou intégrations tiers sont indépendants de Capital.com et ne font 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, sa fonctionnalité, 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 publique  Capital.com 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 publique avec des outils de trading automatisés ou algorithmiques comporte des risques supplémentaires, incluant notamment : l’exécution rapide d’ordres sans examen ni intervention humaine ; des erreurs système, des pannes logicielles ou des problèmes de connectivité ; une exécution à des prix sensiblement différents de ceux attendus ; et des 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’utilisation de l’API publique et de tout outil connecté ne doit pas servir à manipuler la plateforme Capital.com, 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

Il vous incombe de vous assurer que votre utilisation de la plateforme Capital.com, de l’API publique, et de tout outil ou intégration tiers respecte les Conditions Générales de Capital.com, les Conditions de Trading Électronique, ainsi que 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 sur un compte Démo avant de le connecter à un environnement de trading réel.