AI agent 接入
两种接入方式，任选其一即可使用，也可同时配置。
| 方式一：安装 skill | 方式二：配置 MCP | |
|---|---|---|
| 操作 | 执行一条命令 | 编辑 agent 的配置文件 |
| 调用路径 | agent 在终端执行 mexc 命令 | agent 直接调用，不经过终端 |
| 前置条件 | agent 可执行终端命令 | agent 支持 MCP |
方式一：安装 skill
mexc skills install # 默认安装给 Claude Code
mexc skills install --agent cursor # 安装给指定工具
mexc skills install --all-agents # 安装给全部检测到的工具
mexc skills update # 升级 CLI 后重新执行
安装内容为 25 份功能说明文档。安装完成后可直接提问，例如「BTC 合约当前资金费率」或「现货账户 USDT 余额」。
每份文档包含一张完整功能表：命令写法、读写属性、是否需要密钥、重复执行是否安全，以及功能说明；另附实操流程，例如下单后如何确认成交。因此「现货交易能做什么」「查持仓用哪条命令」这类问题，agent 依据本地文档作答，来源可核对。
文档随二进制发布，内容与所安装的版本一致。升级 CLI 后执行 mexc skills update 同步文档；版本不一致时 mexc doctor 会告警。
功能范围
下表用于确认功能类别的覆盖情况。具体到单条功能，通过 agent 或 mexc explore 查询。
| 类别 | 模块 | 数量 | 内容 |
|---|---|---|---|
| 现货 | marketv2 | 25 | 行情数据，含公开实时推送；21 个无需密钥 |
| 现货 | kline | 2 | K 线，无需密钥 |
| 现货 | market-search | 1 | 市场搜索 |
| 现货 | trade | 12 | 下单、改单、撤单、查询；含止盈止损、触发单、追踪单、OCO |
| 现货 | asset | 32 | 总览、余额、充提与划转记录、账户间划转、账单、盈亏 |
| 现货 | convert | 8 | 闪兑 |
| 现货 | dca | 21 | 定投 |
| 现货 | fee | 9 | 费率中心 |
| 现货 | grid | 16 | 网格交易 |
| 现货 | account | 1 | 本账户成交实时推送 |
| 合约 | market | 37 | 公开行情，无需密钥 |
| 合约 | trade | 54 | 下单、计划委托、止损、跟踪、杠杆、保证金、持仓 |
| 合约 | account | 26 | 资产、流水、多资产、费率、风险、偏好设置 |
| 理财 | flexible | 18 | 活期产品与自动质押 |
| 理财 | fixed | 12 | 定期产品与订单 |
| 理财 | contract-hold | 10 | 合约持有生息 |
| 理财 | common | 11 | 通用产品、资产、持仓、订单查询 |
| 活动 | reward | 4 | 奖励中心 |
| 活动 | online | 3 | 活动发现 |
| 活动 | participate | 1 | 活动报名 |
| 期货行情 | market | 3 | 公开实时推送，无需密钥 |
| 期货行情 | account | 1 | 本账户成交实时推送 |
未安装 skill 时可自行查询：mexc explore 浏览全部功能，mexc contract market --help 列出模块下全部功能，mexc schema 输出全部功能 id，便于脚本处理。
方式二：配置 MCP
按类别配置，每个类别一条：
{
"mcpServers": {
"mexc-spot": { "command": "mexc", "args": ["mcp", "spot", "--read-only"] }
}
}
多数 agent 提供配置命令，无需手写配置文件，以下为常见 agent 配置参考：
claude mcp add-json -s user mexc-spot '{"type":"stdio","command":"mexc","args":["mcp","spot","--read-only"]}'
codex mcp add mexc-spot -- mexc mcp spot --read-only
gemini mcp add -s user -t stdio mexc-spot mexc mcp spot --read-only
kiro-cli mcp add --name mexc-spot --command "mexc mcp spot --read-only" --scope global
code --add-mcp '{"name":"mexc-spot","type":"stdio","command":"mexc","args":["mcp","spot","--read-only"]}'
cursor --add-mcp '{"name":"mexc-spot","type":"stdio","command":"mexc","args":["mcp","spot","--read-only"]}'
按需配置。将 307 个功能全部暴露给 agent 会降低其选中正确功能的准确率，并增加上下文消耗。
args 配置 | 覆盖范围 | 工具数 |
|---|---|---|
["mcp", "spot", "--read-only"] | 现货全部 | 123 |
["mcp", "contract", "--read-only"] | 合约全部 | 117 |
["mcp", "financial-openapi", "--read-only"] | 理财 | 51 |
["mcp", "activity", "--read-only"] | 活动与奖励 | 8 |
["mcp", "spot", "marketv2", "--read-only"] | 仅现货行情 | 22 |
仅查询行情与账户时，配置第一条即可。文件上传下载与实时推送无法通过 MCP 协议传输，因此工具数少于功能数；futures 全部为实时推送，配置后无可用工具，仅支持终端调用。
MCP server 无法启动
将配置中的 mexc 替换为二进制文件的完整路径。Windows 必须使用完整路径。macOS 与 Linux 上，从终端启动的 agent 通常无需替换；从程序坞或启动台启动的可能需要，Claude Desktop 较为常见。
npm root -g # 输出目录后接 @mexc-ai/cli-<平台>/bin/mexc
<平台> 取值为 win32-x64、darwin-arm64、linux-x64 等。Windows 下文件名带 .exe，写入 JSON 时反斜杠需要转义：
"command": "C:\\Users\\你的用户名\\AppData\\Roaming\\npm\\node_modules\\@mexc-ai\\cli-win32-x64\\bin\\mexc.exe"