AI接入
把发明者量化接入Claude Code、Codex、Cursor等AI编程助手（AI agent）后，可以直接用对话完成写策略、回测、创建和管理实盘、查看日志与收益。AI助手通过平台提供的MCP（Model Context Protocol）服务调用这些功能，用的是一把专门为它创建的API KEY，权限由你在授权时决定，随时可以修改或吊销。
一句话接入
在AI助手里输入：
读 https://www.fmz.com/agent/setup.zh-CN.md 然后接入发明者量化
AI助手会按这份说明完成以下步骤，你只需要在浏览器里点一次同意：
- AI助手向平台申请授权，然后给出一个授权链接（形如
https://www.fmz.com/agent/authorize?code=XXXX-XXXX），链接10分钟内有效。 - 在已登录发明者量化的浏览器中打开链接，确认申请者名称和权限后点击同意。可以在页面上取消勾选不想给的权限。
- AI助手取得API KEY，写入自己的MCP配置并连接。之后就可以直接对它说「列出我的实盘」「给这个策略跑一次回测」。
申请时AI助手会用「名字 @ 机器名」（例如Claude Code @ MacBook）作为这把API KEY的名称。同一个名称再次申请并同意时，旧的API KEY会被吊销、换成新的，重复接入不会累积多余的API KEY。
权限
| 权限 | 允许的操作 | 默认 |
|---|---|---|
| read | 查看策略、实盘、托管者、交易所账户列表与详情，读取日志、消息、账户概览（不含任何密钥） | 是 |
| backtest | 发起、查询、停止回测 | 是 |
| write | 保存策略与版本、分组、告警开关，修改已停止实盘的配置 | 是 |
| trade | 创建、启动、停止实盘，给实盘发送交互命令（会扣费并真实下单） | 是 |
| danger | 删除策略、实盘、托管者，公开策略 | 否 |
danger权限默认不授予，只有AI助手明确申请、并在授权页面勾选时才会获得。AI助手调用[trade]或[danger]类工具前，应当先向你确认。
手动配置
不能执行命令的客户端（例如Cherry Studio）可以手动配置：
- 在「账号设置 → API KEY」（
https://www.fmz.com/m/account#apikey）创建API KEY，记下Access Key和Secret Key。 - 在客户端添加一个MCP服务，类型选Streamable HTTP：
- URL：
https://www.fmz.com/api/mcp/<Access Key> - 请求头：
Authorization: Bearer <Secret Key>
- URL：
Secret Key只能放在请求头里，不能写进URL。各客户端的配置示例：
bash
# Claude Code
claude mcp add --transport http fmz "https://www.fmz.com/api/mcp/<Access Key>" --header "Authorization: Bearer <Secret Key>"
json
{"mcpServers": {"fmz": {"url": "https://www.fmz.com/api/mcp/<Access Key>", "headers": {"Authorization": "Bearer <Secret Key>"}}}}
上面的JSON用于Cursor（~/.cursor/mcp.json）等支持Streamable HTTP的客户端；Claude Desktop需要通过npx mcp-remote转接，见接入说明原文。
安装skills（推荐）
skills是给AI助手阅读的平台知识包：平台操作流程、完整的API文档、各编程语言的策略写法、回测和指标。装上之后AI助手写出的策略更准确。在终端执行：
bash
npx skills add fmzquant/skills --global --yes -a claude-code
-a后面填你使用的AI助手名称（claude-code、codex、cursor、gemini-cli等）。也可以直接在GitHub阅读：https://github.com/fmzquant/skills。
可用的工具
连接后AI助手可以使用以下工具，完整说明以AI助手看到的工具列表为准：
| 权限 | 工具 |
|---|---|
| read | ping、get_account_summary、list_exchanges、list_platforms、list_nodes、list_strategies、get_strategy、list_strategy_versions、get_strategy_version、list_robots、get_robot、get_robot_logs、get_robot_profit、get_robot_output、list_messages、list_groups、revoke_my_key |
| backtest | run_backtest、get_backtest、list_backtests、stop_backtest |
| write | check_strategy、save_strategy、save_strategy_version、delete_strategy_version、update_robot、save_group、move_to_group、delete_group、set_robot_alert、set_node_alert、delete_messages |
| trade | create_robot、start_robot、stop_robot、restart_robot、send_robot_command，以及交易终端插件工具plugin_*（查询行情、下单等） |
| danger | delete_strategy、delete_robot、delete_node、publish_strategy |
一个典型的流程：list_platforms和list_nodes了解账户里有哪些交易所账户和托管者；save_strategy保存策略并用check_strategy检查语法；run_backtest和get_backtest回测；确认后create_robot创建实盘，再用get_robot、get_robot_logs观察运行情况。
安全与管理
- 交易所的API KEY不经过AI助手：在网页的「交易所」页面添加，AI助手按编号选择。所有工具的返回结果里都不包含任何密钥。
- 在
https://www.fmz.com/m/account#apikey可以查看AI助手使用的API KEY，修改权限或锁定。权限除了填写上表的权限名，还可以填工具名，用!工具名排除某个工具。 - 不再使用时，让AI助手调用
revoke_my_key吊销它自己的API KEY，或在上面的页面中删除。 stop_robot只停止实盘，不会平仓。- 第一次让AI助手创建实盘时，建议先回测，再用模拟盘或小额资金运行。
常见问题
- 提示没有在线托管者：创建实盘需要至少一个在线的托管者，见「平台基础 → 托管者」。
- 提示回测任务过多：同时运行的回测数量有上限，让AI助手先用
stop_backtest停止不再需要的回测。 - AI助手说没有某个工具，或者调用被拒绝：这把API KEY没有对应的权限，在API KEY页面修改权限后重新连接。
同一把API KEY也可以用于扩展API接口，供脚本和定时任务调用；能用MCP的场景优先使用MCP。