Agent Trade Kit: o MCP OKX nativo, oficial e open source!

O MCP oficial do TradingView deu o que falar em setembro, mas tem um preço: uma assinatura Essential, no mínimo, e os períodos de teste não dão acesso; já para cripto existe um caminho gratuito, o MCP OKX, que vem direto de uma exchange. A OKX publica o seu próprio servidor MCP, o Agent Trade Kit: open source, gratuito, capaz de fornecer à sua IA os preços, os candles, o funding, o open interest, quase 70 indicadores técnicos e um screener — sem nem sequer abrir uma conta na OKX.

Conectado à sua conta, o mesmo servidor vai mais longe: saldo, posições, histórico, notícias e calendário econômico, depois, se você decidir, as ordens — primeiro na conta demo, sem dinheiro real. É aí que estão as questões que realmente importam: quais permissões dar à chave de API, qual site da OKX escolher quando se mora na Europa (EEE) e como manter o controle de cada ordem.

Este guia cobre tudo, na ordem: o que o MCP OKX faz, a instalação em dez minutos no PC ou no Mac, os pedidos que funcionam sem chave, a conexão da sua conta em modo somente leitura, a passagem para o modo demo e os limites que você precisa conhecer antes de confiar qualquer coisa a ele. Cada comando foi verificado na documentação e no código-fonte oficiais, versão 1.4.8 de 23 de setembro de 2026.

Os pontos principais

• O MCP OKX — o “Agent Trade Kit” — é o servidor MCP oficial da OKX: open source (licença MIT), gratuito, roda no seu computador e as suas chaves de API nunca saem dele.
• Sem chave de API, a sua IA já lê os dados públicos da OKX: preços, candles desde 2021, livro de ofertas, funding, open interest, quase 70 indicadores técnicos e um screener.
• É o equivalente cripto, gratuito, do TradingView MCP oficial, que exige uma assinatura Essential; em contrapartida, ele se limita aos mercados da OKX e não gerencia watchlists nem alertas.
• É um servidor local: ele funciona com o Claude Desktop, o Claude Code, o Cursor, o VS Code e o Windsurf, mas não com o claude.ai no navegador, o aplicativo de celular ou o ChatGPT.
• Especifique sempre --modules: sem essa opção, o comando de instalação conecta as 167 ferramentas do kit, ordens incluídas.
• Na Europa (EEE), a sua conta está vinculada ao site europeu da OKX, my.okx.com: a chave de API é criada lá e o servidor é configurado com o site “eea”.
• Para a chave de API: só “Ler” (Read) para começar, “Ler” + “Negociar” (Trade) para enviar ordens e nunca a permissão “Sacar” (Withdraw), que a própria documentação da OKX também desaconselha.
• Teste as ordens em demo, com uma chave separada. Na conta real, a sua IA prepara e executa, mas é você quem aprova cada chamada — e quem assume o risco.

O que é o MCP OKX, afinal?

Um MCP (Model Context Protocol) é a porta USB da sua IA: de um lado, o assistente; do outro, um software que expõe “ferramentas” — ler um preço, calcular um RSI, enviar uma ordem —, e o protocolo faz a tradução entre os dois. O servidor da OKX se chama oficialmente OKX Agent Trade Kit. A OKX o publica no GitHub, no repositório oficial okx/agent-trade-kit, e no npm com o nome @okx_ai/okx-trade-mcp.

O kit contém dois programas independentes: okx-trade-mcp, o servidor MCP que a sua IA chama, e okx, uma ferramenta de linha de comando que servirá sobretudo para registrar as suas chaves. O servidor roda localmente, iniciado pelo seu aplicativo de IA como um pequeno programa em segundo plano: sem serviço de nuvem no meio do caminho, sem intermediários de terceiros. Ele conversa diretamente com a API da OKX, e as suas credenciais ficam em um arquivo do seu computador, ~/.okx/config.toml.

As 167 ferramentas dele estão organizadas em 11 módulos, e é você quem escolhe quais a sua IA vê, na inicialização, com a opção --modules:

O servidor roda na sua máquina: a sua IA só recebe os resultados das ferramentas, nunca as suas chaves.

Sem chave de API: tudo o que a sua IA já vê

Essa é a grande força do MCP OKX: iniciado apenas com o módulo market, ele não pede conta, nem chave, nem configuração. Os dados de mercado da OKX são públicos, e o servidor os entrega à sua IA em tempo real. Na prática, cerca de vinte ferramentas:

• Preços e livro de ofertas: último preço, volume em 24 horas, melhores preços de compra e de venda, profundidade do livro de ofertas, últimos trades, preço de marcação e preço dos índices.
• Candles: do minuto ao mês (1m, 5m, 15m, 1H, 4H, 1D, 1W, 1M…), com um histórico que remonta a 2021.
• Derivativos: funding atual e histórico, open interest por contrato e o seu histórico, diferença de preço entre dois instrumentos — o spot em relação ao perpétuo, por exemplo.
• Indicadores técnicos: quase 70 indicadores calculados pela OKX, do RSI ao MACD, passando pelas bandas de Bollinger, pelo ATR, pelo ADX, pelo Supertrend, pelo VWAP, pelo OBV ou pelas linhas do Ichimoku.
• Screener: uma triagem multicritério dos mercados spot, perpétuos e futuros — variação em 24 horas, capitalização, volume, funding, open interest, data de listagem —, mais um ranking das maiores variações de open interest em um período determinado.

Duas observações evitam muitas surpresas. Os indicadores são calculados em 3, 5 ou 15 minutos, 1 hora, 4 horas, 12 horas, 1 dia, 3 dias ou 1 semana — não em 1 minuto —, e a ferramenta usa o tempo gráfico de 1 hora se você não informar nenhum: especifique sempre o seu. Quanto ao screener, ele filtra os mercados spot, perpétuos e futuros, mas não as opções.

MCP OKX ou TradingView MCP: qual escolher?

Os dois servidores não têm nem o mesmo preço nem o mesmo campo de atuação. O TradingView MCP oficial roda nos servidores do TradingView, se conecta por uma URL que você cola e cobre todos os mercados da plataforma. O MCP OKX roda na sua máquina e só conhece os mercados da OKX, mas não custa nada e chega até os derivativos:

Os dois se complementam muito bem: nada impede de conectá-los juntos no Claude Desktop — o TradingView para as suas watchlists e os outros mercados, a OKX para o funding, o open interest e a execução. Basta começar cada pedido por “Com a OKX” ou “Com o TradingView” para que a sua IA escolha a ferramenta certa.

Instalar o MCP OKX em dez minutos

Você precisa do aplicativo Claude para computador, no Windows ou no macOS — ou do Claude Code, do Cursor, do VS Code, do Windsurf —, e do Node.js, o motor que faz o servidor funcionar. Tudo acontece em um terminal: PowerShell no Windows, Terminal no Mac.

1. Instalar o Node.js, versão 18 ou superior

Verifique primeiro se ele já está instalado:

node -v

Se o comando mostrar v18 ou superior, passe para a etapa 2. Caso contrário, instale a versão LTS pelo nodejs.org, ou com um único comando:

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

# Mac (com Homebrew)
brew install node

Feche e reabra o seu terminal depois da instalação e rode node -v de novo para verificar.

2. Instalar o kit da OKX

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

O primeiro pacote é o servidor MCP, o segundo é a ferramenta okx, que servirá para registrar as suas chaves. Verifique com okx-trade-mcp --version: você deve ver um número de versão, 1.4.8 em 1º de outubro de 2026. No Windows, se o PowerShell se recusar a executar o npm, rode uma vez Set-ExecutionPolicy RemoteSigned -Scope CurrentUser e depois recomece.

3. Conectar o kit ao Claude, no modo “somente dados”

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

O comando adiciona o servidor ao arquivo de configuração do Claude Desktop sem mexer nos outros MCPs já instalados e guarda uma cópia do arquivo antigo (.bak). Para outro aplicativo, troque claude-desktop por claude-code, cursor, vscode ou windsurf.

A armadilha a evitar: nunca se esqueça do --modules. Sem essa opção, o comando setup conecta todos os módulos: as 167 ferramentas, incluindo ordens, bots e transferências. Sem chave de API, essas ferramentas falham; mas no dia em que você adicionar uma, a sua IA terá o controle de tudo. Comece pelo market e adicione os outros módulos um por um, quando você realmente precisar deles.

4. Reiniciar o Claude e fazer o teste

Feche completamente o Claude Desktop — no Windows, clique com o botão direito no ícone dele perto do relógio e depois em Sair (Quit); no Mac, ⌘Q — e reabra-o. Em uma nova conversa, peça:

“Com a OKX, me dê o preço do BTC-USDT, o funding do BTC-USDT-SWAP e o open interest dele.”

O Claude pede permissão para usar as ferramentas da OKX: aceite, são leituras e nada é modificado. Para ver tudo o que o servidor sabe fazer, peça a ele: “Liste as ferramentas da OKX às quais você tem acesso.” Com apenas o módulo market, a lista cabe em umas vinte linhas, e nenhuma delas envia ordens.

Quatro comandos, e a opção --modules que você nunca deve esquecer.

Os pedidos que funcionam, sem chave

Dois hábitos mudam tudo. Primeiro, comece por “Com a OKX”: senão, a sua IA pode buscar os números em outro lugar, na web ou em outro MCP. Depois, nomeie os mercados como a OKX os nomeia: BTC-USDT para o spot, BTC-USDT-SWAP para o perpétuo, BTC-USD- seguido da data de vencimento (AAMMDD) para um contrato futuro. Aqui estão pedidos para copiar do jeito que estão, com a ferramenta que a sua IA chama nos bastidores:

Mantenha a hierarquia em mente: o screener encontra, a IA resume, o seu plano de trading decide. Um funding extremo ou um salto do open interest é uma informação, não um motivo para entrar em uma posição. E para o CVD, que o MCP OKX não fornece, os nossos screeners OI & CVD continuam gratuitos e abertos a todos.

Conectar a sua conta OKX, em modo somente leitura

Com uma chave de API, a sua IA também vê a sua conta: saldo, posições abertas, histórico de ordens, taxas pagas. A chave libera ainda dois módulos que exigem autenticação, mesmo fazendo apenas leitura: news — notícias, sentimento por cripto e calendário econômico, do CPI ao FOMC — e smartmoney, o ranking dos traders de melhor desempenho da OKX. Começamos por uma chave que não pode modificar nada.

Criar a chave no site certo

A OKX funciona com sites regionais, e cada conta está vinculada ao seu. No Espaço Econômico Europeu (EEE), é o my.okx.com. Faça login, abra o gerenciamento de API da sua conta e crie uma chave com estas configurações:

• Permissão: só “Ler”. Você vai acrescentar “Negociar” depois, em outra chave, se quiser enviar ordens.
• “Sacar”: nunca. O kit não precisa dessa permissão, e a própria documentação da OKX a desaconselha.
• Endereço IP: se a sua conexão tem um endereço IP fixo, vincule a chave a esse endereço: se for roubada, ela se tornará inutilizável.
• Passphrase: é uma senha própria da chave, que você escolhe. Guarde-a junto com a chave e a chave secreta: você vai precisar dela na etapa seguinte.

Registrar a chave no seu computador

No terminal, execute o assistente da ferramenta okx:

okx config init

Ele pergunta o site (escolha EEA), se é uma chave real ou demo, depois a sua chave, a sua chave secreta e a sua passphrase, e grava tudo em ~/.okx/config.toml — no Windows, C:\Users\seu-nome\.okx\config.toml. Você também pode escrever esse arquivo à mão; com um perfil chamado “leitura”, ele fica assim:

default_profile = "leitura"

[profiles.leitura]
site = "eea"
api_key = "sua-chave-api"
secret_key = "sua-chave-secreta"
passphrase = "sua-passphrase"

Esse arquivo é o seu cofre: não o envie a ninguém, nunca cole o conteúdo dele em uma conversa e, se você usa o Claude Code, que pode abrir os arquivos do seu computador, nunca peça a ele que o leia. O servidor, por sua vez, nunca transmite as suas chaves à sua IA: ele as usa para assinar as requisições à OKX, e a IA só vê os resultados das ferramentas.

Reconectar o servidor, com duas travas

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

Depois, adicione a segunda trava, a opção --read-only, que o comando setup não sabe escrever sozinho. No Claude Desktop, abra as Configurações, vá à aba Desenvolvedor e clique em Editar configuração (em inglês: Settings → Developer → Edit Config), e acrescente essa opção à linha args do servidor okx-trade-mcp-leitura:

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

Reinicie o Claude e teste: “Com a OKX, qual é o saldo da minha conta e quais são as minhas posições abertas?” Com uma chave somente leitura e a opção --read-only, você tem duas travas independentes: o servidor nem sequer oferece mais ferramentas de escrita à sua IA, e a OKX, de todo modo, recusaria qualquer ordem vinda dessa chave.

Quatro níveis de acesso: só se sobe um degrau quando o anterior está dominado.

Enviar ordens: primeiro em demo

A OKX oferece um modo de trading simulado: fundos virtuais, preços reais, nenhum risco para o seu capital. O MCP OKX lida com ele nativamente, e é por aí que toda ordem enviada por uma IA deveria começar.

1. Crie uma chave demo. Na OKX, passe para o modo demo (Demo Trading) e crie uma chave de API a partir desse modo, com as permissões “Ler” e “Negociar”. É uma chave distinta das suas chaves reais.
2. Guarde-a em um perfil “demo”. Com okx config init ou à mão, acrescentando ao perfil a linha demo = true: o servidor passa então a enviar todas as ordens para o trading simulado.
3. Conecte-a como um servidor à parte. okx-trade-mcp setup --client claude-desktop --profile demo --modules market,account,spot,swap e depois reinicie o Claude.

Depois, treine com um pedido simples:

“Em demo na OKX, envie uma ordem limite de compra de 0,01 ETH no ETH-USDT, 5% abaixo do preço atual, e depois mostre as minhas ordens abertas.”

Antes de executar, o Claude mostra a ferramenta chamada e os parâmetros dela: instrumento, direção, tipo de ordem, tamanho, preço. Leia-os de verdade: é o momento em que um erro ainda pode ser corrigido. Nos perpétuos, o tamanho é contado em contratos, e um contrato não vale necessariamente uma unidade da cripto: peça à sua IA o valor do contrato e o montante em dólares antes de aprovar. O resto — ordens limitadas, ordens OCO, trailing stops, ajuste da alavancagem — também se controla em linguagem natural.

Em demo, as ferramentas de mercado continuam lendo os preços reais; já as notícias e os produtos de poupança (Earn) não estão disponíveis ali. E, seja qual for o modo, cada chamada fica anotada em um registro local, em ~/.okx/logs/: “Com a OKX, mostre o registro das chamadas de ferramentas de hoje” diz exatamente o que a sua IA fez — um bom complemento ao seu diário de trading.

E na conta real?

A passagem para a conta real segue as mesmas etapas, com uma chave “Ler” + “Negociar” criada fora do modo demo. Três regras se somam:

• Uma conta dedicada: uma subconta da OKX em que você deixa apenas a quantia que aceita arriscar. O kit gerencia vários perfis, ou seja, várias contas, cada uma com a sua chave.
• Cada ordem é aprovada manualmente: nunca conceda autorização permanente a uma ferramenta que envia ordens e coloque o seu stop loss na OKX, não na conversa.
• Tamanhos pequenos primeiro: comece com valores que não mudam nada no seu capital, enquanto você observa como a sua IA interpreta os seus pedidos. A gestão de risco não se delega.

A segurança em cinco hábitos

1. Instale o pacote certo. O único oficial é o @okx_ai/okx-trade-mcp, publicado pela OKX, cujo código fica na organização okx no GitHub. Desconfie das cópias e das “versões melhoradas” que pedem as suas chaves.
2. Fixe a versão se quiser estabilidade. Na configuração, usar @okx_ai/okx-trade-mcp@1.4.8 no lugar de @okx_ai/okx-trade-mcp evita que uma atualização mude o comportamento do seu servidor sem que você saiba.
3. Separe a web das ordens. Uma página da web, um tweet ou uma notícia pode conter instruções ocultas dirigidas à sua IA: é a injeção de prompt. Nunca reúna, em uma mesma conversa, uma fonte desconhecida e ferramentas que enviam ordens.
4. Confira os números que importam. A IA pode ler mal um resultado ou confundir dois mercados. Peça a ela a fonte e o horário de cada dado e cruze com a interface da OKX antes de qualquer decisão.
5. Revogue ao menor sinal de dúvida. Uma chave é excluída com um clique no gerenciamento de API da OKX: é imediato, e corta o acesso da sua IA, seja qual for a configuração dela.

O que o MCP OKX não faz

• Nenhuma outra plataforma: ele só conhece os mercados da OKX — nada de ações nem de forex, exceto alguns tokens lastreados em ações (stock tokens) negociados na OKX.
• Sem CVD: para o Cumulative Volume Delta e para dados de derivativos mais refinados, é preciso uma ferramenta especializada como o Velo ou o Coinalyze.
• Sem gráfico: ele não desenha nada e não escreve Pine Script. Para controlar os seus gráficos, existe a ponte open source apresentada na nossa página IA trading.
• Nem navegador, nem celular: por ser um servidor local, ele não funciona nem no claude.ai pelo navegador, nem no aplicativo de celular, nem no ChatGPT.
• Sem saque: o kit não tem nenhuma ferramenta para tirar fundos da OKX, apenas uma transferência interna entre as suas contas da OKX — e a sua chave, de qualquer forma, não tem a permissão “Sacar”.
• Não exatamente os mesmos mercados: sem chave, os dados vêm do site global da OKX, que lista um pouco mais de instrumentos que o site europeu. Um mercado visível no screener não está necessariamente aberto à sua conta.

Perguntas frequentes

O MCP OKX é realmente gratuito?

Sim. O kit é open source, sob licença MIT, e a OKX não cobra nem pelo servidor nem pelos dados de mercado, acessíveis sem conta. Você só paga o que pagaria de qualquer maneira: as taxas de trading da OKX, se enviar ordens, e a assinatura da sua IA, se tiver uma.

É preciso ter uma conta na OKX para usar o MCP OKX?

Não, não para os dados públicos: iniciado apenas com o módulo market, o servidor funciona sem conta nem chave de API. Uma conta e uma chave passam a ser necessárias para consultar o seu saldo e as suas posições, ler as notícias e o calendário econômico, ou enviar ordens.

O MCP OKX funciona com o ChatGPT ou com o claude.ai?

Não. É um servidor local, iniciado no seu computador pelo seu aplicativo de IA: ele funciona com o Claude Desktop, o Claude Code, o Cursor, o VS Code, o Windsurf e os outros aplicativos compatíveis com servidores MCP locais. O ChatGPT, o claude.ai no navegador e o aplicativo de celular só se conectam a servidores remotos, acessíveis por uma URL.

A minha IA pode sacar as minhas criptos com o MCP OKX?

Não. O kit não contém nenhuma ferramenta de saque: ele se limita ao trading, à consulta da conta e às transferências internas entre as suas contas da OKX. E a chave de API que você confia a ele nunca deve ter a permissão “Sacar”: mesmo com uma ferramenta defeituosa, a OKX recusaria a operação.

Onde ficam armazenadas as minhas chaves de API?

Em um arquivo do seu computador, ~/.okx/config.toml (C:\Users\seu-nome\.okx\config.toml no Windows). O servidor as lê para assinar as requisições à OKX, mas nunca as transmite à sua IA, que só vê os resultados das ferramentas. Proteja esse arquivo como uma senha e exclua a chave na sua conta da OKX ao menor sinal de dúvida.

Como testar o trading sem risco com o MCP OKX?

Com o modo demo da OKX: crie uma chave de API a partir do trading simulado, registre-a em um perfil que contenha a linha demo = true e conecte esse perfil como um servidor à parte. As ordens passam a ser enviadas com fundos virtuais, a preços reais. Só as notícias e os produtos de poupança continuam indisponíveis em demo.

Qual é a diferença entre o MCP OKX e o TradingView MCP?

O TradingView MCP oficial roda nos servidores do TradingView, exige uma assinatura Essential ou superior e cobre todos os mercados da plataforma, com watchlists e alertas, mas sem nenhuma ordem. O MCP OKX é gratuito, roda no seu computador e se limita aos mercados da OKX; em troca, ele dá o funding, o open interest, quase 70 indicadores e, com uma chave adequada, a execução de ordens.

Moro na Europa (EEE): qual site da OKX escolher na configuração?

O site europeu. A sua conta está vinculada ao my.okx.com: a sua chave de API é criada lá, e o perfil do servidor é configurado com site = "eea", opção que o assistente okx config init oferece. Uma chave criada no site europeu não funciona no site global: as requisições para a sua conta falham ali com um erro de autenticação.