OKX Agent Trade Kit 把交易所功能接到 AI 助手或终端里。例如，你可以让助手查询 BTC-USDT 的买卖价和盘口，再解释订单规模，而不用手动搬运数据。它包含 MCP 服务与 CLI；和用于链上路由的 OnchainOS 不是同一套接入。
先用不带 Key 的行情模式
核对官方仓库和软件包名称后，在自己的终端安装版本。下面固定到本次核对的 1.2.8，后续升级前先看变更记录：
npm install -g @okx_ai/okx-trade-mcp@1.2.8 @okx_ai/okx-trade-cli@1.2.8
okx market ticker BTC-USDT
okx-trade-mcp --modules market --read-onlyMCP 命令是供客户端连接的本地服务，不是普通的一问一答命令；终端保持运行可能是正常状态。在 AI 客户端里配置程序 okx-trade-mcp，参数为 --modules market --read-only。先询问一个可核对的问题：“查询 BTC-USDT 买一、卖一和时间，不下单”。
想直接在 Claude 里连接？对照这两张图
如果你使用 Claude，可以按 OKX 官方演示进入 Customize → Connectors，添加自定义 MCP。这里走的是网页账户授权；上面的终端命令走本地 MCP 配置，选择一种连接方式即可。本地的 --read-only 参数不会自动作用于这个网页连接器。
第一步：填写连接名称和地址。 名称填 okx-agent-trade-kit，服务地址从 OKX 官方页面的 Claude 标签复制，再点击 Add。
第二步：在 Connectors 列表找到 OKX，点击 Connect。 接着按页面提示完成账户授权，先看清授权账户及权限，再让助手查询行情。要练习模拟交易，继续使用下方单独配置的 Demo profile，不要把网页连接成功当作已切换模拟盘。
再添加独立的 Demo profile
运行 okx config init，按官方配置文档创建名为 demo 的 profile，使用模拟盘 Key，并明确 demo = true。先只开放 market 和 account 模块：
okx-trade-mcp --profile demo --modules market,account --read-only请助手读取模拟余额并说明所用 profile。不要把真实 Key 粘贴进模型提示词；工具在本机签名，不意味着模型客户端不会读取返回的账户信息。只给任务确实需要的权限。
怎么确认自己看到的是模拟盘？
如果要在网页中对照账户和订单，先进入 OKX 的模拟交易页面，看左上角是否显示 “模拟盘交易”。下图右上角的 “实盘交易” 是返回实盘的切换入口，练习时留在模拟环境。网页显示模拟盘，只能确认当前网页环境；本地 MCP 仍需使用前面配置的 --profile demo 和 demo = true。
需要练习下单时，明确每个参数
在确认模拟环境后，才切换到含 spot 或 swap 的模块并移除只读标记。先让助手列出完整计划：交易对、方向、数量单位、价格、订单类型、客户订单 ID 和撤单步骤，再逐笔确认。不要用“帮我赚最多的钱”这种无法核验的指令替代参数。
如果想先不经过 AI，使用独立 Python 模拟盘教程跑一遍接单、查单、撤单。这样能分清是交易所请求出了问题，还是助手选错了工具。
CLI 与 MCP 工具名不要混着写
CLI 用空格分层，MCP 暴露的是工具名称。不要把助手看到的下划线名称机械改成带横线的终端命令。遇到失败，记录工具名、错误码与环境，不要提交带密钥的配置文件。认证问题见API 报错排查。