本目录说明外部 AI Agent 如何通过受控接口使用 QuantDinger。建议人工接入者从中文指南开始；自动化工具应以 OpenAPI 和英文标识符为准。
- Agent Gateway 快速开始：创建令牌、验证身份、提交策略与回测。
- MCP 接入指南：连接 Cursor、Claude Code、Codex 或远程 Agent。
- AI 集成设计（英文）：理解权限边界与服务端保护。
- Agent OpenAPI：查看
/api/agent/v1的机器可读契约。
| Scope | 用途 | 典型操作 |
|---|---|---|
R |
只读 | 行情、研究、账户与运行状态 |
W |
写入配置 | 保存策略源码、创建停止状态的部署 |
B |
回测 | 提交、查询或取消回测任务 |
N |
通知 | 管理和触发信号提醒 |
T |
交易与运行时 | 停止策略、下单、紧急停止 |
C |
管理 | 仅管理员使用 |
令牌权限不会绕过服务端实盘开关、标的白名单、名义金额上限、有效期、速率限制或审计。所有会产生副作用的 W/B/N/T 请求都应提供唯一的 Idempotency-Key。
- 中文页面解释操作流程和风险；英文页面与代码中的路由、字段、Scope、环境变量保持原样。
agent-openapi.json是 Agent HTTP 接口的权威契约。- Human Web API 另见 Web API 文档，不要混用人类 JWT 与 Agent Token。