Agent Trade Kit : le MCP OKX natif officiel et open source !

Le MCP officiel de TradingView a fait parler de lui en septembre, mais il a un prix : un abonnement Essential au minimum, essais exclus. Pour la crypto, il existe une voie gratuite, et elle vient directement d'un exchange. OKX publie son propre serveur MCP, l'Agent Trade Kit : open source, gratuit, capable de donner à ton IA les prix, les bougies, le funding, l'open interest, près de 70 indicateurs techniques et un screener — sans même ouvrir de compte chez OKX.

Branché sur ton compte, le même serveur va plus loin : solde, positions, historique, actualités et calendrier économique, puis, si tu le décides, les ordres — d'abord sur le compte de démo, sans argent réel. C'est là que se jouent les vraies questions : quelles permissions donner à la clé API, quel site OKX choisir quand on vit en France, et comment garder la main sur chaque ordre.

Ce guide couvre tout, dans l'ordre : ce que fait le MCP OKX, l'installation en dix minutes sur PC ou Mac, les demandes qui marchent sans clé, la connexion de ton compte en lecture seule, le passage en démo et les limites à connaître avant de lui confier quoi que ce soit. Chaque commande a été vérifiée dans la documentation et le code source officiels, version 1.4.8 du 23 septembre 2026.

L'essentiel à retenir

• Le MCP OKX — l'« Agent Trade Kit » — est le serveur MCP officiel d'OKX : open source (licence MIT), gratuit, il tourne sur ton ordinateur et tes clés API n'en sortent jamais.
• Sans clé API, ton IA lit déjà les données publiques d'OKX : prix, bougies depuis 2021, carnet d'ordres, funding, open interest, près de 70 indicateurs techniques et un screener.
• C'est le pendant crypto, gratuit, du MCP TradingView officiel, qui exige un abonnement Essential ; en contrepartie, il se limite aux marchés d'OKX et ne gère ni watchlists ni alertes.
• C'est un serveur local : il marche avec Claude Desktop, Claude Code, Cursor, VS Code et Windsurf, mais pas avec claude.ai dans le navigateur, l'application mobile ou ChatGPT.
• Précise toujours --modules : sans cette option, la commande d'installation branche les 167 outils du kit, ordres compris.
• Depuis la France, ton compte dépend du site européen d'OKX, my.okx.com : la clé API se crée là-bas et le serveur se règle sur le site « eea ».
• Pour la clé API : Lecture seule pour commencer, Lecture + Trade pour passer des ordres, et jamais la permission Retrait, que la documentation d'OKX déconseille elle aussi.
• Les ordres se testent en démo, avec une clé séparée. En réel, ton IA prépare et exécute, mais c'est toi qui valides chaque appel — et qui portes le risque.

Le MCP OKX, c'est quoi ?

Un MCP (Model Context Protocol) est le port USB de ton IA : d'un côté l'assistant, de l'autre un logiciel qui expose des « outils » — lire un prix, calculer un RSI, passer un ordre —, et le protocole fait la traduction entre les deux. Le serveur d'OKX s'appelle officiellement OKX Agent Trade Kit. OKX le publie sur GitHub, dans son dépôt officiel okx/agent-trade-kit, et sur npm sous le nom @okx_ai/okx-trade-mcp.

Le kit contient deux programmes indépendants : okx-trade-mcp, le serveur MCP que ton IA appelle, et okx, un outil en ligne de commande qui servira surtout à enregistrer tes clés. Le serveur tourne en local, lancé par ton application d'IA comme un petit programme d'arrière-plan : pas de service cloud intermédiaire, pas de relais tiers. Il parle directement à l'API d'OKX, et tes identifiants restent dans un fichier de ton ordinateur, ~/.okx/config.toml.

Ses 167 outils sont rangés en 11 modules, et c'est toi qui choisis lesquels ton IA voit, au lancement, avec l'option --modules :

Le serveur tourne chez toi : ton IA ne reçoit que les résultats des outils, jamais tes clés.

Sans clé API : tout ce que ton IA voit déjà

C'est la grande force du MCP OKX : lancé avec le seul module market, il ne demande ni compte, ni clé, ni configuration. Les données de marché d'OKX sont publiques, et le serveur les sert à ton IA en temps réel. Concrètement, une vingtaine d'outils :

• Prix et carnet : dernier prix, volume sur 24 heures, meilleurs prix à l'achat et à la vente, profondeur du carnet d'ordres, derniers trades, prix de marque et prix des indices.
• Bougies : de la minute au mois (1m, 5m, 15m, 1H, 4H, 1D, 1W, 1M…), avec un historique qui remonte jusqu'en 2021.
• Dérivés : funding actuel et historique, open interest par contrat et son historique, écart de prix entre deux instruments — le spot face au perpétuel, par exemple.
• Indicateurs techniques : près de 70 indicateurs calculés par OKX, du RSI au MACD en passant par les bandes de Bollinger, l'ATR, l'ADX, le Supertrend, le VWAP, l'OBV ou les lignes d'Ichimoku.
• Screener : un tri multicritère des marchés spot, perpétuels et futures — variation sur 24 heures, capitalisation, volume, funding, open interest, date de listing —, plus un classement des plus fortes variations d'open interest sur une période donnée.

Deux précisions évitent bien des surprises. Les indicateurs se calculent en 3, 5 ou 15 minutes, 1 heure, 4 heures, 12 heures, 1 jour, 3 jours ou 1 semaine — pas en 1 minute —, et l'outil prend l'unité de 1 heure si tu n'en donnes aucune : précise toujours la tienne. Quant au screener, il trie les marchés spot, perpétuels et futures, mais pas les options.

MCP OKX ou MCP TradingView : lequel choisir ?

Les deux serveurs n'ont ni le même prix ni le même terrain de jeu. Le MCP TradingView officiel tourne chez TradingView, se branche en collant une URL et couvre tous les marchés de la plateforme. Le MCP OKX tourne chez toi et ne connaît que les marchés d'OKX, mais il ne coûte rien et descend jusqu'aux dérivés :

Les deux se complètent très bien : rien n'empêche de les brancher ensemble dans Claude Desktop, TradingView pour tes watchlists et les autres marchés, OKX pour le funding, l'open interest et l'exécution. Commence simplement chaque demande par « Avec OKX » ou « Avec TradingView » pour que ton IA prenne le bon outil.

Installer le MCP OKX en dix minutes

Il te faut l'application Claude pour ordinateur, sur Windows ou macOS — ou Claude Code, Cursor, VS Code, Windsurf —, et Node.js, le moteur qui fait tourner le serveur. Tout se passe dans un terminal : PowerShell sur Windows, Terminal sur Mac.

1. Installer Node.js, version 18 ou plus

Vérifie d'abord s'il est déjà installé :

node -v

Si la commande affiche v18 ou plus, passe à l'étape 2. Sinon, installe la version LTS depuis nodejs.org, ou en une seule commande :

# Windows (PowerShell)
winget install OpenJS.NodeJS.LTS

# Mac (avec Homebrew)
brew install node

Ferme puis rouvre ton terminal après l'installation, et relance node -v pour vérifier.

2. Installer le kit d'OKX

npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli

Le premier paquet est le serveur MCP, le second l'outil okx qui servira à enregistrer tes clés. Vérifie avec okx-trade-mcp --version : tu dois voir un numéro de version, 1.4.8 au 1^er octobre 2026. Sur Windows, si PowerShell refuse d'exécuter npm, lance une fois Set-ExecutionPolicy RemoteSigned -Scope CurrentUser, puis recommence.

3. Le brancher sur Claude, en mode « données seules »

okx-trade-mcp setup --client claude-desktop --modules market

La commande ajoute le serveur au fichier de configuration de Claude Desktop sans toucher aux autres MCP déjà installés, et garde une copie de l'ancien fichier (.bak). Pour une autre application, remplace claude-desktop par claude-code, cursor, vscode ou windsurf.

Le piège à éviter : n'oublie jamais --modules. Sans cette option, la commande setup branche tous les modules : les 167 outils, ordres, bots et transferts compris. Sans clé API, ces outils échouent ; mais le jour où tu en ajoutes une, ton IA aurait la main sur tout. Commence par market, et ajoute les autres modules un par un, quand tu en as vraiment besoin.

4. Redémarrer Claude et faire le test

Quitte complètement Claude Desktop — sur Windows, clic droit sur son icône près de l'horloge, puis Quitter ; sur Mac, ⌘Q — et rouvre-le. Dans une nouvelle conversation, demande :

« Avec OKX, donne-moi le prix du BTC-USDT, le funding du BTC-USDT-SWAP et son open interest. »

Claude te demande la permission d'utiliser les outils d'OKX : accepte, ce sont des lectures et rien n'est modifié. Pour voir tout ce que le serveur sait faire, demande-lui : « Liste les outils OKX auxquels tu as accès. » Avec le seul module market, la liste tient en une vingtaine de lignes, et aucune ne passe d'ordre.

Quatre commandes, et l'option --modules à ne jamais oublier.

Les demandes qui marchent, sans clé

Deux réflexes changent tout. D'abord, commence par « Avec OKX » : sinon, ton IA peut aller chercher ses chiffres ailleurs, sur le web ou dans un autre MCP. Ensuite, nomme les marchés comme OKX les nomme : BTC-USDT pour le spot, BTC-USDT-SWAP pour le perpétuel, BTC-USD- suivi de la date d'échéance (AAMMJJ) pour un contrat à terme. Voici des demandes à reprendre telles quelles, avec l'outil que ton IA appelle en coulisse :

Garde en tête la hiérarchie : le screener trouve, l'IA résume, ton plan de trading décide. Un funding extrême ou un bond d'open interest est une information, pas une raison d'entrer en position. Et pour le CVD, que le MCP OKX ne fournit pas, nos screeners OI & CVD restent gratuits et ouverts à tous.

Brancher ton compte OKX, en lecture seule

Avec une clé API, ton IA voit aussi ton compte : solde, positions ouvertes, historique des ordres, frais payés. La clé débloque en plus deux modules qui exigent une authentification, même s'ils ne font que lire : news — actualités, sentiment par crypto et calendrier économique, du CPI au FOMC — et smartmoney, le classement des traders les plus performants d'OKX. On commence par une clé qui ne peut rien modifier.

Créer la clé sur le bon site

OKX fonctionne avec des sites régionaux, et chaque compte dépend du sien. Depuis la France, comme partout dans l'Espace économique européen, c'est my.okx.com. Connecte-toi, ouvre la gestion des API de ton compte et crée une clé avec ces réglages :

• Permission : Lecture uniquement. Tu ajouteras Trade plus tard, sur une autre clé, si tu veux passer des ordres.
• Retrait : jamais. Le kit n'en a pas besoin, et la documentation d'OKX elle-même la déconseille.
• Adresse IP : si ta connexion a une adresse IP fixe, lie la clé à cette adresse : volée, elle deviendrait inutilisable.
• Passphrase : c'est un mot de passe propre à la clé, que tu choisis. Garde-la avec la clé et la clé secrète, tu en auras besoin à l'étape suivante.

Enregistrer la clé sur ton ordinateur

Dans le terminal, lance l'assistant de l'outil okx :

okx config init

Il te demande le site (choisis EEA), s'il s'agit d'une clé réelle ou de démo, puis ta clé, ta clé secrète et ta passphrase, et il écrit le tout dans ~/.okx/config.toml — sur Windows, C:\Users\ton-nom\.okx\config.toml. Tu peux aussi écrire ce fichier à la main ; avec un profil nommé « lecture », il ressemble à ceci :

default_profile = "lecture"

[profiles.lecture]
site = "eea"
api_key = "ta-cle-api"
secret_key = "ta-cle-secrete"
passphrase = "ta-passphrase"

Ce fichier, c'est ton coffre : ne l'envoie à personne, ne colle jamais son contenu dans une conversation et, si tu utilises Claude Code, qui peut ouvrir les fichiers de ton ordinateur, ne lui demande jamais de le lire. Le serveur, lui, ne transmet jamais tes clés à ton IA : il s'en sert pour signer ses requêtes à OKX, et l'IA ne voit que les résultats des outils.

Rebrancher le serveur, avec deux verrous

okx-trade-mcp setup --client claude-desktop --profile lecture --modules market,account,news

Ajoute ensuite le second verrou, l'option --read-only, que la commande setup ne sait pas écrire seule. Dans Claude Desktop, ouvre les Paramètres, onglet Développeur, bouton Modifier la config (Settings → Developer → Edit Config), et complète la ligne args du serveur okx-trade-mcp-lecture :

"okx-trade-mcp-lecture": {
  "command": "npx",
  "args": ["-y", "@okx_ai/okx-trade-mcp", "--profile", "lecture",
           "--modules", "market,account,news", "--read-only"]
}

Redémarre Claude et teste : « Avec OKX, quel est le solde de mon compte, et quelles sont mes positions ouvertes ? » Avec une clé en lecture seule et l'option --read-only, tu as deux verrous indépendants : le serveur ne propose même plus d'outils d'écriture à ton IA, et OKX refuserait de toute façon tout ordre venu de cette clé.

Quatre niveaux d'accès : on ne monte d'une marche que quand la précédente est maîtrisée.

Passer des ordres : d'abord en démo

OKX propose un mode de trading simulé : des fonds fictifs, des prix réels, aucun risque pour ton capital. Le MCP OKX le gère nativement, et c'est là que tout ordre passé par une IA devrait commencer.

1. Crée une clé de démo. Sur OKX, passe en mode démo (Demo Trading) et crée une clé API depuis ce mode, avec les permissions Lecture et Trade. C'est une clé distincte de tes clés réelles.
2. Range-la dans un profil « demo ». Avec okx config init ou à la main, en ajoutant la ligne demo = true au profil : le serveur envoie alors tous les ordres vers le trading simulé.
3. Branche-la comme un serveur à part. okx-trade-mcp setup --client claude-desktop --profile demo --modules market,account,spot,swap, puis redémarre Claude.

Ensuite, entraîne-toi sur une demande simple :

« En démo sur OKX, place un ordre limite d'achat de 0,01 ETH sur ETH-USDT, 5 % sous le prix actuel, puis montre-moi mes ordres ouverts. »

Avant d'exécuter, Claude te montre l'outil appelé et ses paramètres : instrument, sens, type d'ordre, taille, prix. Lis-les vraiment, c'est le moment où une erreur se rattrape. Sur les perpétuels, la taille se compte en contrats, et un contrat ne vaut pas forcément une unité de la crypto : demande à ton IA la valeur du contrat et le montant en dollars avant de valider. Le reste — ordres à cours limité, ordres OCO, stops suiveurs, réglage de l'effet de levier — se pilote aussi en langage naturel.

En démo, les outils de marché continuent de lire les vrais prix ; en revanche, les actualités et les produits d'épargne (Earn) n'y sont pas disponibles. Et quel que soit le mode, chaque appel est consigné dans un registre local, dans ~/.okx/logs/ : « Avec OKX, montre-moi le registre des appels d'outils d'aujourd'hui » te dit exactement ce que ton IA a fait — un bon complément à ton journal de trading.

Et en réel ?

Le passage au réel suit les mêmes étapes, avec une clé Lecture + Trade créée hors du mode démo. Trois règles s'ajoutent :

• Un compte dédié : un sous-compte OKX où tu ne laisses que la somme que tu acceptes d'exposer. Le kit gère plusieurs profils, donc plusieurs comptes, chacun avec sa clé.
• Chaque ordre se valide à la main : n'accorde jamais d'autorisation permanente à un outil qui passe des ordres, et pose ton stop loss chez OKX, pas dans la conversation.
• De petites tailles d'abord : commence avec des montants qui ne changent rien à ton capital, le temps de voir comment ton IA interprète tes demandes. La gestion du risque ne se délègue pas.

La sécurité en cinq réflexes

1. Installe le bon paquet. Le seul officiel est @okx_ai/okx-trade-mcp, publié par OKX, dont le code vit dans l'organisation okx sur GitHub. Méfie-toi des copies et des « versions améliorées » qui réclament tes clés.
2. Fige la version si tu veux de la stabilité. Dans la configuration, @okx_ai/okx-trade-mcp@1.4.8 à la place de @okx_ai/okx-trade-mcp évite qu'une mise à jour change le comportement de ton serveur sans que tu le saches.
3. Sépare le web et les ordres. Une page web, un tweet ou une actualité peut contenir des instructions cachées adressées à ton IA : c'est l'injection de prompt. Ne réunis jamais, dans une même conversation, une source inconnue et des outils qui passent des ordres.
4. Vérifie les chiffres qui comptent. L'IA peut mal lire un résultat ou confondre deux marchés. Demande-lui la source et l'heure de chaque donnée, et recoupe sur l'interface d'OKX avant toute décision.
5. Révoque au moindre doute. Une clé se supprime en un clic dans la gestion des API d'OKX : c'est immédiat, et ça coupe l'accès de ton IA quelle que soit sa configuration.

Ce que le MCP OKX ne fait pas

• Pas d'autres plateformes : il ne connaît que les marchés d'OKX — pas d'actions ni de forex, hormis les quelques jetons adossés à des actions (stock tokens) cotés sur OKX.
• Pas de CVD : pour le Cumulative Volume Delta et les données de dérivés plus fines, il faut un outil spécialisé comme Velo ou Coinalyze.
• Pas de graphique : il ne dessine rien et n'écrit pas de Pine Script. Pour piloter tes graphiques, c'est le pont open source présenté sur notre page IA trading.
• Pas de navigateur ni de mobile : serveur local oblige, il ne marche ni sur claude.ai dans le navigateur, ni dans l'application mobile, ni dans ChatGPT.
• Pas de retrait : le kit n'a aucun outil pour sortir des fonds d'OKX, seulement un transfert interne entre tes comptes OKX — et ta clé n'a de toute façon pas la permission Retrait.
• Pas tout à fait les mêmes marchés : sans clé, les données viennent du site mondial d'OKX, qui liste un peu plus d'instruments que le site européen. Un marché visible dans le screener n'est pas forcément ouvert à ton compte.

Questions fréquentes

Le MCP OKX est-il vraiment gratuit ?

Oui. Le kit est open source, sous licence MIT, et OKX ne fait payer ni le serveur ni les données de marché, accessibles sans compte. Tu ne paies que ce que tu paierais de toute façon : les frais de trading d'OKX si tu passes des ordres, et l'abonnement à ton IA si tu en as un.

Faut-il un compte OKX pour utiliser le MCP OKX ?

Non, pas pour les données publiques : lancé avec le seul module market, le serveur fonctionne sans compte ni clé API. Un compte et une clé deviennent nécessaires pour consulter ton solde et tes positions, lire les actualités et le calendrier économique, ou passer des ordres.

Le MCP OKX fonctionne-t-il avec ChatGPT ou claude.ai ?

Non. C'est un serveur local, lancé sur ton ordinateur par ton application d'IA : il fonctionne avec Claude Desktop, Claude Code, Cursor, VS Code, Windsurf et les autres applications compatibles avec les serveurs MCP locaux. ChatGPT, claude.ai dans le navigateur et l'application mobile ne se branchent qu'à des serveurs distants, accessibles par une URL.

Mon IA peut-elle retirer mes cryptos avec le MCP OKX ?

Non. Le kit ne contient aucun outil de retrait : il se limite au trading, à la consultation du compte et aux transferts internes entre tes comptes OKX. Et la clé API que tu lui confies ne doit jamais avoir la permission Retrait : même avec un outil défaillant, OKX refuserait l'opération.

Où sont stockées mes clés API ?

Dans un fichier de ton ordinateur, ~/.okx/config.toml (C:\Users\ton-nom\.okx\config.toml sous Windows). Le serveur les lit pour signer ses requêtes vers OKX, mais ne les transmet jamais à ton IA, qui ne voit que les résultats des outils. Protège ce fichier comme un mot de passe, et supprime la clé dans ton compte OKX au moindre doute.

Comment tester le trading sans risque avec le MCP OKX ?

Avec le mode démo d'OKX : crée une clé API depuis le trading simulé, enregistre-la dans un profil qui contient la ligne demo = true, et branche ce profil comme un serveur à part. Les ordres partent alors sur des fonds fictifs, avec les prix réels. Seules les actualités et les produits d'épargne restent indisponibles en démo.

Quelle différence entre le MCP OKX et le MCP TradingView ?

Le MCP TradingView officiel tourne chez TradingView, demande un abonnement Essential ou supérieur et couvre tous les marchés de la plateforme, avec watchlists et alertes, mais sans aucun ordre. Le MCP OKX est gratuit, tourne sur ton ordinateur et se limite aux marchés d'OKX ; en échange, il donne le funding, l'open interest, près de 70 indicateurs et, avec une clé adaptée, l'exécution des ordres.

Je vis en France : quel site OKX choisir dans la configuration ?

Le site européen. Ton compte est rattaché à my.okx.com : ta clé API se crée là-bas, et le profil du serveur se règle avec site = "eea", ce que l'assistant okx config init te propose. Une clé créée sur le site européen ne fonctionne pas sur le site mondial : les requêtes vers ton compte y échouent avec une erreur d'authentification.