Agent Trade Kit: MCP OKX nativ, oficial și open source!

TradingView MCP oficial a făcut vâlvă în septembrie, dar are un preț: cel puțin un abonament Essential, perioadele de probă excluse. Pentru cripto există o cale gratuită, venită direct de la un exchange: MCP OKX. OKX își publică propriul server MCP, Agent Trade Kit: open source, gratuit, capabil să-i ofere AI-ului tău prețurile, lumânările, funding-ul, open interest-ul, aproape 70 de indicatori tehnici și un screener — fără să deschizi măcar un cont la OKX.

Conectat la contul tău, același server merge mai departe: sold, poziții, istoric, știri și calendar economic, apoi, dacă decizi tu, ordinele — mai întâi pe contul demo, fără bani reali. Aici apar adevăratele întrebări: ce permisiuni să dai cheii API, ce site OKX să alegi când locuiești în Europa (SEE) și cum să păstrezi controlul asupra fiecărui ordin.

Acest ghid acoperă totul, în ordine: ce face MCP OKX, instalarea în zece minute pe PC sau Mac, cererile care funcționează fără cheie, conectarea contului tău doar pentru citire, trecerea în demo și limitele pe care trebuie să le cunoști înainte să-i încredințezi orice. Fiecare comandă a fost verificată în documentația și în codul sursă oficiale, versiunea 1.4.8 din 23 septembrie 2026.

Esențialul de reținut

• MCP OKX — „Agent Trade Kit” — este serverul MCP oficial al OKX: open source (licență MIT), gratuit, rulează pe calculatorul tău, iar cheile tale API nu îl părăsesc niciodată.
• Fără cheie API, AI-ul tău citește deja datele publice ale OKX: prețuri, lumânări cu istoric din 2021, cartea de ordine, funding, open interest, aproape 70 de indicatori tehnici și un screener.
• Este echivalentul cripto, gratuit, al TradingView MCP oficial, care cere un abonament Essential; în schimb, el se limitează la piețele OKX și nu gestionează nici liste de urmărire, nici alerte.
• Este un server local: funcționează cu Claude Desktop, Claude Code, Cursor, VS Code și Windsurf, dar nu și cu claude.ai în browser, cu aplicația mobilă sau cu ChatGPT.
• Precizează întotdeauna --modules: fără această opțiune, comanda de instalare conectează cele 167 de instrumente ale kitului, inclusiv ordinele.
• În Europa (SEE), contul tău ține de site-ul european al OKX, my.okx.com: cheia API se creează acolo, iar serverul se setează pe site-ul „eea”.
• Pentru cheia API: doar „Citire” (Read) la început, „Citire” + „Tranzacționare” (Trade) pentru a plasa ordine și niciodată permisiunea „Retrage” (Withdraw), pe care o desconsiliază și documentația OKX.
• Ordinele se testează în demo, cu o cheie separată. Pe contul real, AI-ul tău pregătește și execută, dar tu validezi fiecare apel — și tot tu porți riscul.

MCP OKX: ce este, mai exact?

Un MCP (Model Context Protocol) este portul USB al AI-ului tău: de o parte asistentul, de cealaltă un software care expune „instrumente” (a citi un preț, a calcula un RSI, a plasa un ordin), iar protocolul face traducerea între cele două. Serverul OKX se numește oficial OKX Agent Trade Kit. OKX îl publică pe GitHub, în depozitul oficial okx/agent-trade-kit, și pe npm sub numele @okx_ai/okx-trade-mcp.

Kitul conține două programe independente: okx-trade-mcp, serverul MCP pe care îl apelează AI-ul tău, și okx, un instrument în linie de comandă care va servi mai ales la înregistrarea cheilor tale. Serverul rulează local, pornit de aplicația ta de AI ca un mic program de fundal: fără serviciu cloud intermediar, fără releu terț. Vorbește direct cu API-ul OKX, iar datele tale de autentificare rămân într-un fișier de pe calculatorul tău, ~/.okx/config.toml.

Cele 167 de instrumente ale sale sunt împărțite în 11 module, iar tu alegi, la pornire, pe care dintre ele le vede AI-ul tău, cu opțiunea --modules:

Serverul rulează la tine: AI-ul tău primește doar rezultatele instrumentelor, niciodată cheile tale.

Fără cheie API: tot ce vede deja AI-ul tău

Acesta este marele atu al MCP OKX: pornit doar cu modulul market, nu cere nici cont, nici cheie, nici configurare. Datele de piață ale OKX sunt publice, iar serverul le oferă AI-ului tău în timp real. Concret, vreo douăzeci de instrumente:

• Prețuri și cartea de ordine: ultimul preț, volumul pe 24 de ore, cele mai bune prețuri de cumpărare și de vânzare, adâncimea cărții de ordine, ultimele tranzacții, prețul de marcare (mark price) și prețurile index.
• Lumânări: de la un minut la o lună (1m, 5m, 15m, 1H, 4H, 1D, 1W, 1M…), cu un istoric care merge înapoi până în 2021.
• Derivate: funding-ul actual și istoricul lui, open interest-ul pe contract și istoricul lui, diferența de preț dintre două instrumente — spot-ul față de perpetuu, de exemplu.
• Indicatori tehnici: aproape 70 de indicatori calculați de OKX, de la RSI la MACD, trecând prin benzile Bollinger, ATR, ADX, Supertrend, VWAP, OBV sau liniile Ichimoku.
• Screener: o sortare multicriterială a piețelor spot, perpetue și futures (variație pe 24 de ore, capitalizare, volum, funding, open interest, data listării), plus un clasament al celor mai mari variații ale open interest-ului pe o perioadă dată.

Două precizări te feresc de multe surprize. Indicatorii se calculează pe 3, 5 sau 15 minute, 1 oră, 4 ore, 12 ore, 1 zi, 3 zile sau 1 săptămână (nu pe 1 minut), iar instrumentul ia cadrul de timp de 1 oră dacă nu îi dai niciunul: precizează-l întotdeauna pe al tău. Cât despre screener, el sortează piețele spot, perpetue și futures, dar nu și opțiunile.

MCP OKX sau TradingView MCP: pe care să-l alegi?

Cele două servere nu au nici același preț, nici același teren de joc. TradingView MCP oficial rulează la TradingView, se conectează lipind o adresă URL și acoperă toate piețele platformei. MCP OKX rulează la tine și cunoaște doar piețele OKX, dar nu costă nimic și coboară până la nivelul derivatelor:

Cele două se completează foarte bine: nimic nu te împiedică să le conectezi împreună în Claude Desktop, TradingView pentru listele tale de urmărire și pentru celelalte piețe, OKX pentru funding, open interest și execuție. Începe pur și simplu fiecare cerere cu „Cu OKX” sau „Cu TradingView”, ca AI-ul tău să aleagă instrumentul potrivit.

Instalarea MCP OKX în zece minute

Îți trebuie aplicația Claude pentru calculator, pe Windows sau macOS (ori Claude Code, Cursor, VS Code, Windsurf), și Node.js, motorul care face serverul să funcționeze. Totul se petrece într-un terminal: PowerShell pe Windows, Terminal pe Mac.

1. Instalează Node.js, versiunea 18 sau mai nouă

Verifică mai întâi dacă este deja instalat:

node -v

Dacă comanda afișează v18 sau o versiune mai nouă, treci la pasul 2. În caz contrar, instalează versiunea LTS de pe nodejs.org sau printr-o singură comandă:

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

# Mac (cu Homebrew)
brew install node

Închide și redeschide terminalul după instalare, apoi rulează din nou node -v ca să verifici.

2. Instalează kitul OKX

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

Primul pachet este serverul MCP, al doilea instrumentul okx, care va servi la înregistrarea cheilor tale. Verifică cu okx-trade-mcp --version: ar trebui să vezi un număr de versiune, 1.4.8 la 1 octombrie 2026. Pe Windows, dacă PowerShell refuză să execute npm, rulează o dată Set-ExecutionPolicy RemoteSigned -Scope CurrentUser, apoi reia instalarea.

3. Conectează-l la Claude, în modul „doar date”

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

Comanda adaugă serverul în fișierul de configurare al Claude Desktop, fără să atingă celelalte MCP-uri deja instalate, și păstrează o copie a vechiului fișier (.bak). Pentru altă aplicație, înlocuiește claude-desktop cu claude-code, cursor, vscode sau windsurf.

Capcana de evitat: nu uita niciodată --modules. Fără această opțiune, comanda setup conectează toate modulele: cele 167 de instrumente, inclusiv ordinele, boții și transferurile. Fără cheie API, aceste instrumente eșuează; dar în ziua în care adaugi una, AI-ul tău ar avea mână liberă peste tot. Începe cu market și adaugă celelalte module pe rând, când ai cu adevărat nevoie.

4. Repornește Claude și testează

Închide complet Claude Desktop — pe Windows, clic dreapta pe pictograma lui de lângă ceas, apoi Ieșire (Quit); pe Mac, ⌘Q — și redeschide-l. Într-o conversație nouă, cere:

„Cu OKX, dă-mi prețul BTC-USDT, funding-ul BTC-USDT-SWAP și open interest-ul lui.”

Claude îți cere permisiunea de a folosi instrumentele OKX: acceptă, sunt doar citiri și nimic nu se modifică. Ca să vezi tot ce știe serverul să facă, cere-i: „Listează instrumentele OKX la care ai acces.” Cu doar modulul market, lista are cam douăzeci de rânduri și niciunul nu plasează ordine.

Patru comenzi și opțiunea --modules, pe care să nu o uiți niciodată.

Cererile care funcționează, fără cheie

Două reflexe schimbă totul. În primul rând, începe cu „Cu OKX”: altfel, AI-ul tău poate căuta cifrele în altă parte, pe web sau într-un alt MCP. Apoi, numește piețele așa cum le numește OKX: BTC-USDT pentru spot, BTC-USDT-SWAP pentru perpetuu, BTC-USD- urmat de data scadenței (AALLZZ) pentru un contract la termen. Iată câteva cereri pe care le poți folosi ca atare, cu instrumentul pe care AI-ul tău îl apelează în culise:

Ține minte ierarhia: screenerul găsește, AI-ul rezumă, planul tău de trading decide. Un funding extrem sau un salt al open interest-ului este o informație, nu un motiv să intri într-o poziție. Iar pentru CVD, pe care MCP OKX nu îl oferă, screenerele noastre OI & CVD rămân gratuite și deschise tuturor.

Conectarea contului tău OKX, doar pentru citire

Cu o cheie API, AI-ul tău vede și contul tău: soldul, pozițiile deschise, istoricul ordinelor, comisioanele plătite. Cheia deblochează în plus două module care cer autentificare, chiar dacă doar citesc: news — știri, sentimentul pe criptomonedă și calendarul economic, de la CPI până la FOMC — și smartmoney, clasamentul celor mai performanți traderi de pe OKX. Începem cu o cheie care nu poate modifica nimic.

Creează cheia pe site-ul potrivit

OKX funcționează cu site-uri regionale, iar fiecare cont ține de site-ul său. Dacă locuiești în Spațiul Economic European (SEE), site-ul tău este my.okx.com. Conectează-te, deschide gestionarea API-urilor contului tău și creează o cheie cu aceste setări:

• Permisiuni: doar Citire. Vei adăuga Tranzacționare mai târziu, pe o altă cheie, dacă vrei să plasezi ordine.
• „Retrage”: niciodată. Kitul nu are nevoie de această permisiune, iar documentația OKX însăși o desconsiliază.
• Adresă IP: dacă conexiunea ta are o adresă IP fixă, leagă cheia de această adresă: o cheie furată ar deveni astfel inutilizabilă.
• Passphrase: este o parolă proprie cheii, pe care o alegi tu. Păstrează-o împreună cu cheia și cu cheia secretă, vei avea nevoie de ea la pasul următor.

Înregistrează cheia pe calculatorul tău

În terminal, lansează asistentul instrumentului okx:

okx config init

Îți cere site-ul (alege EEA), tipul cheii (reală sau demo), apoi cheia ta, cheia secretă și passphrase-ul, și scrie totul în ~/.okx/config.toml — pe Windows, C:\Users\numele-tau\.okx\config.toml. Poți scrie acest fișier și de mână; cu un profil numit „citire”, arată cam așa:

default_profile = "citire"

[profiles.citire]
site = "eea"
api_key = "cheia-ta-api"
secret_key = "cheia-ta-secreta"
passphrase = "passphrase-ul-tau"

Acest fișier este seiful tău: nu-l trimite nimănui, nu lipi niciodată conținutul lui într-o conversație și, dacă folosești Claude Code, care poate deschide fișierele de pe calculatorul tău, nu-i cere niciodată să-l citească. Serverul, la rândul lui, nu transmite niciodată cheile tale AI-ului tău: le folosește ca să semneze cererile către OKX, iar AI-ul vede doar rezultatele instrumentelor.

Reconectează serverul, cu două încuietori

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

Adaugă apoi a doua încuietoare, opțiunea --read-only, pe care comanda setup nu știe s-o scrie singură. În Claude Desktop, deschide Setările, mergi în fila Dezvoltator, apasă pe butonul Editează configurația (Settings → Developer → Edit Config) și completează linia args a serverului okx-trade-mcp-citire:

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

Repornește Claude și testează: „Cu OKX, care este soldul contului meu și care sunt pozițiile mele deschise?” Cu o cheie doar pentru citire și opțiunea --read-only, ai două încuietori independente: serverul nu mai oferă AI-ului tău nici măcar instrumente de scriere, iar OKX ar refuza oricum orice ordin venit de la această cheie.

Patru niveluri de acces: urci o treaptă doar când cea anterioară este stăpânită.

Plasarea ordinelor: mai întâi în demo

OKX oferă un mod de trading simulat: fonduri virtuale, prețuri reale, niciun risc pentru capitalul tău. MCP OKX îl gestionează nativ, iar de aici ar trebui să înceapă orice ordin plasat printr-un AI.

1. Creează o cheie demo. Pe OKX, treci în modul demo (Demo Trading) și creează o cheie API din acest mod, cu permisiunile Citire și Tranzacționare. Este o cheie distinctă de cheile tale reale.
2. Pune-o într-un profil „demo”. Cu okx config init sau de mână, adăugând linia demo = true în profil: serverul trimite atunci toate ordinele către trading-ul simulat.
3. Conectează-o ca pe un server separat. okx-trade-mcp setup --client claude-desktop --profile demo --modules market,account,spot,swap, apoi repornește Claude.

Apoi, exersează cu o cerere simplă:

„În demo pe OKX, plasează un ordin de cumpărare cu limită de preț pentru 0,01 ETH pe ETH-USDT, cu 5% sub prețul actual, apoi arată-mi ordinele mele deschise.”

Înainte să execute, Claude îți arată instrumentul apelat și parametrii lui: piață, direcție, tip de ordin, mărime, preț. Citește-i cu adevărat: este momentul în care o greșeală mai poate fi corectată. La perpetue, mărimea se exprimă în contracte, iar un contract nu valorează neapărat o unitate din criptomonedă: cere-i AI-ului tău valoarea contractului și suma în dolari înainte să validezi. Restul — ordinele cu limită de preț, ordinele OCO, trailing stop-urile, reglarea efectului de levier — se pilotează tot în limbaj natural.

În demo, instrumentele de piață continuă să citească prețurile reale; în schimb, știrile și produsele de economisire (Earn) nu sunt disponibile acolo. Iar indiferent de mod, fiecare apel este consemnat într-un registru local, în ~/.okx/logs/: „Cu OKX, arată-mi registrul apelurilor de instrumente de azi” îți spune exact ce a făcut AI-ul tău — un bun complement al jurnalului tău de trading.

Și pe contul real?

Trecerea pe contul real urmează aceiași pași, cu o cheie Citire + Tranzacționare creată în afara modului demo. Se adaugă trei reguli:

• Un cont dedicat: un subcont OKX în care lași doar suma pe care ești dispus s-o pui în joc. Kitul gestionează mai multe profiluri, deci mai multe conturi, fiecare cu propria cheie.
• Fiecare ordin se validează manual: nu acorda niciodată o autorizare permanentă unui instrument care plasează ordine și pune-ți stop-loss-ul la OKX, nu în conversație.
• Mai întâi, poziții mici: începe cu sume care nu schimbă nimic în capitalul tău, până vezi cum îți interpretează AI-ul cererile. Gestionarea riscului nu se delegă.

Securitatea în cinci reflexe

1. Instalează pachetul corect. Singurul oficial este @okx_ai/okx-trade-mcp, publicat de OKX, al cărui cod se află în organizația okx de pe GitHub. Ferește-te de copii și de „versiunile îmbunătățite” care îți cer cheile.
2. Fixează versiunea dacă vrei stabilitate. În configurare, @okx_ai/okx-trade-mcp@1.4.8 în locul lui @okx_ai/okx-trade-mcp împiedică o actualizare să schimbe comportamentul serverului tău fără să știi.
3. Separă web-ul de ordine. O pagină web, un tweet sau o știre poate conține instrucțiuni ascunse adresate AI-ului tău: aceasta este injecția de prompt (prompt injection). Nu reuni niciodată, în aceeași conversație, o sursă necunoscută și instrumente care plasează ordine.
4. Verifică cifrele care contează. AI-ul poate citi greșit un rezultat sau poate confunda două piețe. Cere-i sursa și ora fiecărei informații și verifică-le în interfața OKX înainte de orice decizie.
5. Revocă la cea mai mică îndoială. O cheie se șterge cu un clic în gestionarea API-urilor OKX: ștergerea are efect imediat și taie accesul AI-ului tău, indiferent de configurația lui.

Ce nu face MCP OKX

• Nicio altă platformă: cunoaște doar piețele OKX — fără acțiuni și fără forex, în afara câtorva token-uri legate de acțiuni (stock tokens) cotate pe OKX.
• Fără CVD: pentru Cumulative Volume Delta și pentru date de derivate mai fine, îți trebuie un instrument specializat precum Velo sau Coinalyze.
• Fără grafic: nu desenează nimic și nu scrie Pine Script. Pentru a-ți controla graficele, există puntea open source prezentată pe pagina noastră AI trading.
• Fără browser și fără mobil: fiind un server local, nu funcționează nici pe claude.ai în browser, nici în aplicația mobilă, nici în ChatGPT.
• Fără retrageri: kitul nu are niciun instrument pentru a scoate fonduri din OKX, doar un transfer intern între conturile tale OKX — iar cheia ta nu are oricum permisiunea „Retrage”.
• Nu chiar aceleași piețe: fără cheie, datele vin de pe site-ul global al OKX, care listează ceva mai multe instrumente decât site-ul european. O piață vizibilă în screener nu este neapărat deschisă contului tău.

Întrebări frecvente

Este MCP OKX cu adevărat gratuit?

Da. Kitul este open source, sub licență MIT, iar OKX nu taxează nici serverul, nici datele de piață, accesibile fără cont. Plătești doar ce ai plăti oricum: comisioanele de trading ale OKX dacă plasezi ordine și abonamentul la AI-ul tău, dacă ai unul.

Ai nevoie de un cont OKX ca să folosești MCP OKX?

Nu, nu pentru datele publice: pornit doar cu modulul market, serverul funcționează fără cont și fără cheie API. Un cont și o cheie devin necesare pentru a-ți consulta soldul și pozițiile, pentru a citi știrile și calendarul economic sau pentru a plasa ordine.

Funcționează MCP OKX cu ChatGPT sau claude.ai?

Nu. Este un server local, pornit pe calculatorul tău de aplicația ta de AI: funcționează cu Claude Desktop, Claude Code, Cursor, VS Code, Windsurf și cu celelalte aplicații compatibile cu serverele MCP locale. ChatGPT, claude.ai în browser și aplicația mobilă se conectează doar la servere la distanță, accesibile printr-o adresă URL.

Poate AI-ul meu să-mi retragă criptomonedele cu MCP OKX?

Nu. Kitul nu conține niciun instrument de retragere: se limitează la trading, la consultarea contului și la transferurile interne între conturile tale OKX. Iar cheia API pe care i-o încredințezi nu trebuie să aibă niciodată permisiunea „Retrage”: chiar și cu un instrument defectuos, OKX ar refuza operațiunea.

Unde sunt stocate cheile mele API?

Într-un fișier de pe calculatorul tău, ~/.okx/config.toml (C:\Users\numele-tau\.okx\config.toml pe Windows). Serverul le citește ca să-și semneze cererile către OKX, dar nu le transmite niciodată AI-ului tău, care vede doar rezultatele instrumentelor. Protejează acest fișier ca pe o parolă și șterge cheia din contul tău OKX la cea mai mică îndoială.

Cum testezi trading-ul fără risc cu MCP OKX?

Cu modul demo al OKX: creează o cheie API din trading-ul simulat, înregistrează-o într-un profil care conține linia demo = true și conectează acel profil ca pe un server separat. Ordinele se execută atunci cu fonduri virtuale, la prețurile reale. Doar știrile și produsele de economisire rămân indisponibile în demo.

Care este diferența dintre MCP OKX și TradingView MCP?

TradingView MCP oficial rulează la TradingView, cere un abonament Essential sau superior și acoperă toate piețele platformei, cu liste de urmărire și alerte, dar fără niciun ordin. MCP OKX este gratuit, rulează pe calculatorul tău și se limitează la piețele OKX; în schimb, oferă funding-ul, open interest-ul, aproape 70 de indicatori și, cu o cheie potrivită, execuția ordinelor.

Locuiesc în Europa (SEE): ce site OKX să aleg în configurare?

Site-ul european. Contul tău ține de my.okx.com: cheia ta API se creează acolo, iar profilul serverului se setează cu site = "eea", opțiune pe care ți-o oferă asistentul okx config init. O cheie creată pe site-ul european nu funcționează pe site-ul global: cererile către contul tău eșuează acolo cu o eroare de autentificare.