Codex 接入 A股数据 MCP 实战：把一次盘后复盘做成可复核任务

1. 为什么盘后复盘需要 Codex MCP 而不是搜索框先说清楚这套东西是什么、能做什么、适合谁。Codex 是能读写文件、执行命令、调用外部工具的编码 AgentMCPModel Context Protocol是一套让 Agent 发现并调用结构化工具的协议A股数据 MCP 就是把交易日历、指数行情、涨停梯队、题材资金这些接口包装成 Agent 可调用的工具集。适合谁适合每天收盘后要做复盘、又不想手动在四五个网页之间来回切的人也适合想把复盘沉淀成可归档文档的研究型选手。我试过直接让模型“搜一下今天A股怎么样”结果很尴尬它给出的“今日成交额”其实是某篇文章发布当天的数据标题里的“今日”和真正的目标交易日差了三天。更麻烦的是你没法判断这个数字来自哪个口径——是沪深两市合计还是某个指数附带的成交额模型自己也说不清。盘后复盘这句话拆开看至少是四类任务叠在一起。第一类是日期确认今天到底是不是交易日数据实际对应哪一天。第二类是市场概览三大指数涨跌、两市成交额、涨跌家数。第三类是情绪结构涨停、炸板、最高连板、各梯队分布。第四类是资金验证哪些题材有资金进场哪些只是情绪脉冲。搜索式问答的问题在于它把“找数据”和“下结论”混在一步里完成中间没有可检查的环节。而 MCP 的价值是把数据获取变成显式的工具调用Codex 先列出有哪些工具再按顺序调用每次调用返回的日期字段、口径字段、异常状态都留在上下文里。最后产出的报告里每个结论都能追溯到具体工具和字段。这就是“可复核”的含义。不是让模型写得更像股评而是让一次复盘变成有日期、有工具、有字段、有异常记录的可重复任务。你明天再跑一遍流程一样验收标准一样出问题时能定位到是哪一步的数据不对。还有一个现实问题Codex 本身不生产行情数据它只是个调度器。数据从哪来、鉴权怎么走、endpoint 指向哪里这些必须提前配好。下面先解决通道问题再进入具体配置。2. 把 Codex 的模型通道切到 TaoToken 统一入口在配 MCP 之前得先保证 Codex 自己能正常跑起来。Codex 调用模型需要 Base URL、API Key、Model ID 三件套。如果你希望用一个统一入口管理 Key 和调用可以把 endpoint 指向 TaoToken 的 API 通道。TaoToken 在这里的角色是统一鉴权与调用通道你拿到一个 Key配置好 Base URLCodex 的模型请求就走这条通道出去。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。具体操作分三步。第一步去控制台创建 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 列表页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后先复制保存页面刷新后不一定还能看到完整 Key。第二步把 Key 写进环境变量不要硬编码在配置文件里export TAOTOKEN_API_KEYsk-你的Key第三步配置 Codex 的模型通道。Codex 的配置文件通常在~/.codex/config.toml如果你用的是 auth.json 方式路径在~/.codex/auth.json。下面给一份 TOML 片段路径和字段名按你本地实际文件为准# ~/.codex/config.toml model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses如果你用的是 auth.json 方式结构大致是这样{ OPENAI_API_KEY: sk-你的Key, OPENAI_BASE_URL: https://taotoken.net/api }这里三件套要写全Base URL 是https://taotoken.net/apiKey 走环境变量TAOTOKEN_API_KEYModel ID 按你实际使用的模型填比如gpt-5-codex。三个字段缺一个请求就会失败。配完之后先做一次最小验证确认通道通了再往下走codex exec 回复 ok 两个字母即可如果返回正常文本说明模型通道没问题。如果报 401先检查 Key 是否复制完整、环境变量是否在当前 shell 生效。如果报连接类错误检查 base_url 是否写成了带路径的完整地址。通道通了之后Codex 就有了“大脑”。接下来要给它接上“数据手”——也就是 A股数据 MCP。3. 配置 A股数据 MCP从 endpoint 到 tools/list这一步是整个流程的核心。MCP 配置写对了Codex 才能发现并调用 A股数据工具。先明确一点MCP 的 endpoint 和模型通道的 endpoint 是两回事。模型通道走 TaoToken数据工具走 A股数据 MCP 自己的地址。两者互不冲突各管各的鉴权。假设你用的 A股数据 MCP 远程入口是https://stock.quicktiny.cn/api/mcp先把它的 API Key 放进环境变量export WUDAO_API_KEY你的数据服务Key然后用 Codex 的 MCP 添加命令注册这个服务codex mcp add wudao-stock-data \ --url https://stock.quicktiny.cn/api/mcp \ --bearer-token-env-var WUDAO_API_KEY这条命令做了三件事给 MCP 服务起名wudao-stock-data指定远程 URL告诉 Codex 从环境变量WUDAO_API_KEY读取 Bearer Token。注意--bearer-token-env-var后面跟的是变量名不是变量值本身。注册完成后让 Codex 列出当前可用的 MCP 工具codex mcp list或者在交互模式里直接问列出当前 wudao-stock-data 提供的所有工具只输出工具名和一句话说明。这一步很关键。工具数量和参数会持续更新实际使用时应以客户端tools/list返回和线上 Manifest 为准不要把旧文章里的工具数量当成固定常量。你看到的工具列表可能包含市场复盘工作流、指数行情、涨停梯队、题材资金、个股研究、公告证据、K线等。如果codex mcp list里看不到刚添加的服务检查两个地方一是命令是否执行成功二是环境变量WUDAO_API_KEY是否在当前 shell 里 export 过。MCP 服务启动时会去读这个变量读不到就会鉴权失败。还有一个容易踩的坑MCP 配置文件和 Codex 主配置文件可能不在同一个目录。有些版本把 MCP 配置写在~/.codex/mcp.json或项目级的.codex/mcp.json里。如果你用命令行添加后不生效可以手动检查这个文件{ mcpServers: { wudao-stock-data: { url: https://stock.quicktiny.cn/api/mcp, bearerTokenEnvVar: WUDAO_API_KEY } } }这份 JSON 片段里的三个关键字段url是 MCP 服务地址bearerTokenEnvVar是环境变量名mcpServers是固定外层键。路径按你本地实际文件位置来不要照抄路径。配置生效后Codex 就具备了调用 A股数据工具的能力。但“能调用”和“调用得对”是两回事下一步要解决的是任务编排。4. 写验收条件让 Codex 按固定顺序调用工具很多人配完 MCP 就直接甩一句“帮我复盘今天A股”然后抱怨结果不稳定。问题不在模型在于任务描述太模糊。Agent 需要明确的验收条件才知道什么算完成、什么算异常。我会把任务写成下面这样你可以直接复制改日期使用 wudao-stock-data MCP 完成最近一个已收盘交易日的市场复盘。 执行要求 1. 从工具结果读取实际交易日和日期状态不要假设用户说的“今天”就是交易日 2. 先调用市场复盘工作流获取整体骨架 3. 使用指数工具核对上证、深证、创业板和两市成交额 4. 使用涨停梯队工具核对最高连板、各梯队数量和主要题材 5. 使用题材资金工具核对主要方向的资金强度 6. 输出每项结论所使用的工具名和字段名 7. 数据缺失、日期不匹配、部分工具失败时单独列出 8. 不生成买卖建议不把推断写成已确认事实。这比一句“帮我复盘”长得多但它让结果有了明确的验收标准。Codex 会按这个顺序执行每一步的返回值都留在上下文里。推荐的工具调用顺序是这样的。第一步调market_replay_workflow它返回市场宽度、短线情绪、涨停结构和题材线索的组合摘要适合先搭报告框架。但工作流返回的是摘要不代表后续不需要原子工具——需要具体梯队、指数点位或资金口径时必须继续查询专门工具。第二步调index_market核对指数和两市成交额。这里有一条重要规则优先读取工具提供的市场成交额汇总字段不要让 Codex 自行把不同amountScope的指数行混加。报告里至少保留requestedDate、tradeDate、actualTradeDate、dateStatus、三大指数涨跌幅、marketTurnover。如果日期状态不匹配直接写明“工具实际返回的是某日数据”不能继续称为用户指定日期的数据。第三步调limit_up_ladder核对连板结构。关注最高连板高度、二板三板及以上数量、各梯队股票、主类题材及涨停数量、首次和最后涨停时间。描述时间时优先读取工具给出的可读时间字段不要自行解释原始时间戳。第四步调theme_intraday_capital核对题材资金。这一步回答的是哪些方向得到资金确认热门题材是否只有情绪没有资金强势题材内部是否分化。题材资金不要默认换成传统板块资金接口不同来源和统计口径不能混写。整个流程跑下来Codex 会产出一份带工具来源的报告。下面给一个推荐的结果结构你可以直接作为输出模板# A股盘后复盘 ## 数据状态 - 请求日期 - 实际交易日 - 日期状态 - 部分错误 ## 市场环境 - 结论 - 数据字段 - 工具 ## 指数与成交额 - 上证 - 深证 - 创业板 - 两市成交额 - 工具 ## 涨停梯队 - 最高板 - 主要梯队 - 主要题材 - 工具 ## 题材与资金 - 强势方向 - 资金验证 - 工具 ## 风险与待验证项 - 空数据 - 日期差异 - 数据质量提示 - 仍需人工核验这个结构有两个好处。第一任何人都能看出某个结论来自哪个工具。第二当工具返回异常时Codex 有明确位置记录而不是把异常吞掉以后继续生成完整故事。5. 验证请求与常见报错排查配置写完不算完得实际跑一次验证。下面是我实测下来比较稳的验证步骤。第一步确认 MCP 工具可发现codex exec 列出 wudao-stock-data 的所有工具名每行一个不要解释预期结果是返回一串工具名。如果返回空或报错说明 MCP 没注册成功回到第 3 节检查配置。第二步单独验证一个原子工具。比如先问交易日调用 wudao-stock-data 的交易日相关工具告诉我最近一个已收盘交易日的日期和日期状态。预期返回里应该包含tradeDate和dateStatus字段。如果这里就报鉴权错误说明数据服务的 Key 有问题和模型通道无关。第三步跑完整复盘任务。把第 4 节的验收条件整段贴进去观察 Codex 是否按顺序调用工具。正常情况下你会看到它先调工作流再调指数、涨停梯队、题材资金最后输出结构化报告。下面是几个真实会遇到的报错和排查方向。报错一401 Unauthorized。这个要分两层看。如果是模型请求报 401检查TAOTOKEN_API_KEY是否设置、base_url 是否写成https://taotoken.net/api。如果是 MCP 工具调用报 401检查WUDAO_API_KEY是否 export、--bearer-token-env-var后面跟的变量名是否和实际一致。两个 Key 是独立的不要混用。报错二local proxy failed或连接超时。这类错误通常出现在 MCP 服务地址不可达时。先确认https://stock.quicktiny.cn/api/mcp这个地址在当前网络环境下能访问再检查是否有本地代理配置干扰。如果你在 auth.json 或 config.toml 里配了额外的代理字段先注释掉再试。报错三reading choices相关错误。这通常出现在模型返回结构不符合预期时比如 wire_api 配错。检查config.toml里的wire_api字段responses 和 chat 两种模式不能混用。如果你不确定用哪个先按服务商文档给的默认值来。报错四OAuth 相关报错。有些 MCP 服务支持 OAuth 流程如果你用的是 Bearer Token 方式却触发了 OAuth 检查检查配置里是否同时存在两套鉴权字段。保留一套即可多余的删掉。报错五工具返回空数据但 Codex 继续编。这是最危险的情况。解决办法是在验收条件里明确写“查询结果为空时只说明当前条件下没有记录不等于资金没有参与或没有公告”。空结果就是空结果不能推断成负面结论。排查顺序建议从外到内先确认模型通道通codex exec 回复 ok再确认 MCP 工具可列出codex mcp list再确认单个工具可调用最后跑完整任务。哪一层断了就修哪一层不要跳步。6. 把复盘变成可归档任务扩展与边界跑通一次之后这套工作流还能继续扩展。完成市场复盘后可以增加不同方向用个股研究工作流研究少量重点个股用公告证据工具核对正式披露和互动记录用 K线工具检查历史价格与成交变化用竞价工具在次日开盘后复查主线反馈最后把报告交给定时任务或项目文档持续归档。扩展时仍然遵循同一个原则先明确任务再选择工具先保留证据再组织结论。不要一上来就让 Codex 拉全市场所有首板、K线和个股资料上下文塞满之后结果反而更不稳定。先用工作流和聚合结果定位重点再下钻少量个股。如果你想把复盘做成长期编码或 Agent 任务可以考虑用 Coding Plan 来管理调用额度入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。如果只是想先验证模型对话效果可以用模型对话入口 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite Claude Code 相关配置参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。适用边界也要说清楚。这套方式适合市场复盘、个股研究、数据核验和报告自动化。它不负责自动交易也不能代替券商行情授权、机构级逐笔数据或多年历史回测数据库。重要结论仍应结合交易所公告、正式披露和人工判断。本文只讨论数据接入和研究工作流不构成投资建议。最后给一个实用技巧把每次复盘的输出存成带日期的 Markdown 文件比如reports/2025-01-15-review.md。下次跑之前先让 Codex 读上一份对比日期状态和工具版本。这样你不仅有了单次复盘还有了一条可追溯的时间线。哪天发现某个字段口径变了翻历史文件就能定位到是哪次更新引入的。