1. 同花顺行情接口接 MCP 协议到底解决什么问题做 A 股量化的朋友大多经历过这个阶段策略脚本里信号算得挺准回测曲线也好看但一到执行环节就卡住。要么是手动复制代码去客户端下单要么写个 GUI 自动化脚本结果同花顺一更新版本坐标全乱脚本直接报废。这个「分析结论到交易执行」的断层是个人量化开发者最头疼的事。同花顺 PC 端其实内置了一套策略 API叫 ths_api原本是给策略脚本调用的。它能完成账户资金查询、持仓查询、当日委托查询、实时行情获取、买卖下单、条件单管理等核心操作。问题在于这套 API 是进程内的外部脚本没法直接调。于是有人用 Hook 的方式把它暴露成 HTTP 网关再包一层 MCP Server让 AI Agent 能通过标准协议调用。这就是同花顺 MCP 协议 AI Agent 这条路的由来。MCP 协议是什么简单说它是 Anthropic 提出的模型上下文协议让 AI 客户端比如 Cursor、Claude Code、各种 Agent 框架能用统一的方式发现和调用外部工具。你不需要为每个 AI 客户端写一套适配只要有一个 MCP ServerAgent 就能看到「查持仓」「问财选股」「下单」这些工具并按需调用。这套方案适合谁我认为是三类人一是用同花顺 PC 端做 A 股、想把手动操作自动化的个人开发者二是已经在用 AI Agent 做分析、但苦于分析结果没法直接落地的量化爱好者三是想搭一条「选股信号 → 下单指令」可回放链路的独立开发者。不适合纯云端部署的场景因为它依赖 Windows 桌面客户端。我试过把这条链路串起来整体感受是行情和查询类接口很稳下单类接口默认走模拟安全性设计得比较克制。下面我把配置、验证和排障的完整过程拆开讲你可以跟着做一遍。2. TaoToken 统一 Key 接入 MCP 的前置准备在讲同花顺 MCP Server 配置之前得先解决 AI Agent 这一侧的模型接入问题。因为 Agent 要调用工具、理解返回的结构化数据、再生成分析结论这中间需要大模型 API。如果你用多个模型比如分析用 Claude、代码生成用别的每个都要单独配 Key、单独管额度很麻烦。TaoToken 在这里的角色是统一 Key 和 API 通道。它提供一个兼容 OpenAI 风格的接口你拿一个 Key 就能调用多种模型Agent 侧只需要配一个 Base URL 和一个 Key。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。前置准备分三步。第一步注册并拿到 API Key。登录后进控制台在 API Keys 页面创建一个 Key。这个 Key 就是后面所有配置里要填的凭证。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第二步确认你要用的模型 ID。TaoToken 支持多种模型具体列表可以在模型对话页面看地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。选一个适合 Agent 工具调用的模型记下它的 Model ID后面配置里要用。第三步确认你的 AI 客户端支持 MCP。目前 Cursor、Claude Code、Cline 等主流工具都支持。如果你用的是 Claude Code接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有详细的 Base URL 和 Key 配置说明。这里要强调一个点TaoToken 是模型 API 通道不是交易通道。它负责的是 Agent 的「大脑」部分同花顺 MCP Server 负责的是「手脚」部分。两者配合才能让 Agent 既会分析又能执行。不要把两者混为一谈也不要把 TaoToken 理解成某种交易中转它只是让你用一个 Key 调用多个模型的统一入口。准备好 Key 和 Model ID 之后就可以进入同花顺 MCP Server 的配置环节了。3. 同花顺 MCP Server 与 Agent 的可复制配置这一节是核心我把配置拆成三块同花顺侧 Hook 安装、MCP Server 配置、Agent 侧模型接入。每一块都给可复制的片段。先说同花顺侧。你需要下载 RHTHS 工具包里面包含 rhths-gui.exe、rhths.exe、rhths-mcp.exe 三个文件。安装流程是先运行 rhths-gui.exe在界面里执行「安装 Hook」然后启动同花顺并登录最后在命令行执行rhths health如果返回 ok说明 HTTP 网关默认端口 19312已经通了。这一步的原理是RhThsHost.dll 被注入同花顺进程把 ths_api 暴露成 HTTP 接口。rhths-mcp.exe 再作为 MCP Server对接 AI 客户端。rhths.exe 是 CLI 工具供脚本直接调用。三者关系是同花顺进程 └── RhThsHost.dll (ths_api → HTTP :19312) ├── rhths-mcp.exe → Cursor / Claude Code / ClineMCP └── rhths.exe → Python / PowerShell / 计划任务CLI接下来是 MCP Server 配置。不同客户端的配置文件路径不一样但结构类似。以 Cursor 为例配置文件在~/.cursor/mcp.jsonWindows 是%USERPROFILE%\.cursor\mcp.json。内容如下{ mcpServers: { rhths-trade: { command: C:\\path\\to\\rhths-mcp.exe, args: [], env: { RHTHS_HOST: 127.0.0.1, RHTHS_PORT: 19312 } } } }如果你用的是 Claude Code配置方式略有不同通常在~/.claude/settings.json或项目级.mcp.json里。Claude Code 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 MCP 配置的完整说明。Claude Code 的 Anthropic 兼容接入可以参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。然后是 Agent 侧的模型接入。以 Cline 为例它支持 OpenAI 兼容接口。你需要在 Cline 的设置里填Base URL:https://taotoken.net/apiAPI Key: 你在 TaoToken 控制台创建的那个 KeyModel ID: 你选的模型 ID这三件套Base URL Key Model ID是任何 OpenAI 兼容客户端接入的通用配置。如果你用的是 Codex它的auth.json里也要填这三项。Codex 的配置示例{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: 你选的Model ID }配置完成后重启 AI 客户端。Agent 应该能看到 rhths-trade 这个 MCP Server 提供的工具列表。工具包括工具名功能rh_trade_account查资金账户rh_trade_positions查持仓rh_trade_orders_today查当日委托rh_trade_buy买入支持 dry_runrh_trade_sell卖出rh_market_wencai问财自然语言选股rh_market_klineK线数据rh_market_timeshare分时数据rh_condition_resume恢复条件单rh_system_start_xiadan启动下单程序这些工具的描述 JSON 是 MCP Server 自动暴露的Agent 会根据描述决定调用哪个。你不需要手动写工具描述但可以检查一下 Agent 是否正确识别了这些工具。配置到这里链路就搭好了。下一节讲怎么验证。4. 模拟盘验证从选股信号到下单指令的可回放链路配置完不验证等于没配。这一节我带你走一遍完整的模拟盘验证流程目标是串起「选股信号 → 分析 → 下单指令」这条链路并且保证可回放。第一步验证基础连通性。在 AI 客户端里输入帮我查一下今天的持仓和资金账户。Agent 应该会调用rh_trade_positions和rh_trade_account返回结构化的持仓和资金数据。如果这一步失败先检查rhths health是否返回 ok再检查 MCP Server 是否启动。第二步验证问财选股。输入用问财选一下今天涨停的、PE 小于 30 的票给我一个对比分析。Agent 会调用rh_market_wencai把自然语言转成问财查询返回选股结果。然后 Agent 会基于返回的数据做分析。这一步验证的是「行情数据 → Agent 分析」的链路。第三步验证模拟下单。输入帮我模拟买入 100 股 600519用 dry_run。Agent 会调用rh_trade_buy参数里带dry_run: true。默认情况下下单接口就是 dry_run 模式只有显式传confirm_live: true才会实盘。这一步验证的是「分析结论 → 下单指令」的链路而且是在安全模式下。第四步验证可回放。把上面三步的调用记录保存下来包括 Agent 的输入、调用的工具、参数、返回结果。下次你可以用同样的输入重放检查结果是否一致。这就是可回放链路的意义出了问题能定位策略变了能对比。这里有个细节要注意rh_trade_buy的参数结构。通常是这样{ code: 600519, quantity: 100, price: 0, dry_run: true, confirm_live: false }price为 0 表示市价单。dry_run为 true 表示模拟。confirm_live为 false 表示不实盘。只有dry_run: false且confirm_live: true才会真正下单。这个双重开关设计是为了防止误操作。验证成功后你可以把这条链路封装成脚本定时跑。比如每天收盘后跑一次选股生成信号第二天开盘前跑一次模拟下单检查信号质量。等信号稳定了再考虑实盘。实盘前一定要想清楚同花顺标准版实盘有每日次数限制高级版无限制。实盘交易遵守券商规则风险自负。这不是一句客套话是真金白银的教训。5. 常见报错排查401、local proxy failed、reading choices、OAuth配置和验证过程中最容易卡在几个报错上。我把踩过的坑整理出来对照着排查。401 Unauthorized。这个通常出现在 Agent 调用模型 API 时。原因一般是 TaoToken 的 Key 填错了或者 Key 过期了。排查步骤进 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 检查 Key 是否有效确认 Base URL 是https://taotoken.net/api不要多加斜杠或路径确认请求头里的Authorization: Bearer sk-xxx格式正确。如果用的是 Claude Code检查它的 Anthropic 兼容配置参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。local proxy failed。这个报错通常出现在 MCP Server 连接同花顺 HTTP 网关时。原因是 rhths-mcp.exe 连不上 127.0.0.1:19312。排查步骤先跑rhths health确认网关是否启动检查同花顺是否登录检查防火墙是否拦了 19312 端口确认 MCP 配置里的RHTHS_HOST和RHTHS_PORT是否正确。如果rhths health返回的不是 ok重新执行「安装 Hook」并重启同花顺。reading choices 相关报错。这个通常出现在 Agent 解析模型返回时。原因是模型返回的格式不符合预期或者 Agent 的工具调用解析出了问题。排查步骤确认你选的 Model ID 支持工具调用function calling检查 Agent 的 MCP 配置是否正确如果用的是 Cline检查它的 MCP 设置里是否启用了 rhths-trade。有时候换个模型就能解决因为不同模型对工具调用的支持程度不一样。OAuth 相关报错。这个通常出现在 Claude Code 或某些需要 OAuth 的客户端。原因是客户端的认证方式和你配置的不匹配。排查步骤确认你用的是 API Key 模式而不是 OAuth 模式检查客户端的配置文件里是否残留了旧的 OAuth 配置参考接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的认证说明。如果用的是 Claude Code 的 Anthropic 兼容模式确认 Base URL 和 Key 的填法正确。除了这四个还有一个常见问题是「工具列表为空」。这通常是 MCP Server 没启动或者配置文件路径不对。检查rhths-mcp.exe的路径是否正确Windows 下路径要用双反斜杠或正斜杠。排查的核心思路是先确认同花顺侧网关通rhths health再确认 MCP Server 通工具列表能看到最后确认模型 API 通Agent 能正常对话。三层分开排查比一股脑乱试效率高得多。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔跑一次选股上面的配置够用了。但如果你想长期用 Agent 做量化编码、策略迭代、自动交易有几个建议。第一把模型接入和交易接入分开管理。模型接入用 TaoToken 的统一 Key交易接入用同花顺 MCP Server。这样换模型不用动交易配置换交易工具不用动模型配置。TaoToken 的 Coding Plan 适合长期编码场景地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 如果你要长时间跑 Agent 写策略、调参数可以考虑。第二给 Agent 的工具调用加日志。每次调用rh_trade_buy或rh_trade_sell都把参数和返回记下来。这样出了问题能回溯策略优化也有数据支撑。可回放链路的价值就在这里。第三实盘前先用模拟盘跑够样本。同花顺标准版实盘有每日次数限制别浪费在调试上。dry_run 模式跑通了信号稳定了再切实盘。第四注意 Windows 版本和同花顺账号限制。这套方案只支持 Windows 10/11同花顺账号需要两年以上。这是平台限制绕不过去。如果你的账号不满足先用模拟盘或者换其他方案。第五模型对话可以用来快速验证工具调用。TaoToken 的模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 可以直接测试模型是否支持工具调用不用每次都配到 Agent 里。最后说一句实在的这套方案的核心价值不是「AI 自动炒股」而是把重复的查询、选股、下单操作串成可回放的链路。AI 负责分析和编排你负责决策和风控。别指望它替你赚钱但它能帮你省下大量手动操作的时间让你把精力放在策略本身上。这才是同花顺 MCP 协议 AI Agent 这条路的正确打开方式。