> Source: https://ashareapi.com/docs/guides/today-mcp/ · Markdown version for LLMs / AI agents 教程 # Today 接入 A 股数据 在 Today 里用自定义 MCP 接入 A 股数据：手机操作，不用开电脑，也不用装 SDK。配置一次，之后直接问行情、财务和 K 线。 ## 先说结论：手机端就能接 Today 是 Today AI 的个人助理 App，跑在云端，支持自定义 MCP。 我们的 MCP 端点是远程 Streamable HTTP，不需要你在本地开服务、开端口或装 Python。 所以你只需要 Today App 和一个 ashareapi Key，不用打开电脑。 - 协议：Streamable HTTP - 鉴权：Bearer Token - 地址：`https://api.ashareapi.com/mcp` - 不需要本地 MCP / localhost / 端口转发 ## 接入前准备 - 安装并登录 Today（iOS / Android / Mac 均可） - 准备一个 ashareapi API Key；建议单独建只读 Key，不要复用到其他产品 - 确认 Key 可用：先调一次 `GET /v1/quote?code=sh600519` ## 四步接入 Today 入口：**设置 → 连接应用 → + 添加自定义 MCP**。在「通过链接添加」里填 MCP 链接，下一步再选认证方式和 Token。 - **第一步**：打开 Today 的设置，进入「连接应用」。 - **第二步**：点右上角 `+`，选择「添加自定义 MCP」。 - **第三步**：选「通过链接添加」，MCP 链接填 `https://api.ashareapi.com/mcp`，勾选风险确认后点「下一步」。 - **第四步**：名称填 `ashareapi`，认证方式选 `Bearer token`，Token 只填 API Key 本身，点「添加」。 注意：下拉已经选了 Bearer，Token 框不要再手写 `Bearer`，否则会变成 `Bearer Bearer sk-...`。 ## 验证：先看工具，再问三个问题 添加成功后，Today 会读取 MCP 的工具列表。先确认能看到 `ashare_quote`、`ashare_finance`、`ashare_kline`，再用三个问题验证取数链路。 在 Today 里直接问 ``` 查一下 600519 最新行情 查一下 600519 2026Q3 营收 给我 600519 最近 30 天日 K ``` - 行情失败：先确认代码带市场前缀，如 `sh600519`，不是裸 `600519`。 - 财务失败：确认 Key 档位包含财务端点，且请求的是具体报告期。 - K 线失败：确认 `count` 没有超过单次上限；需要更多就分批。 ## 401 或看不到工具，怎么排查 | | | 现象 | 先查什么 | 处理 | | 401 Unauthorized | Token 是否填错、是否多了 Bearer | 只填 Key；或改填 `Bearer ` 再试 | | 看不到工具 | URL 是否走错域名 | 确认是 `api.ashareapi.com`，不是 `ashareapi.com` | | 连接失败 | 尾斜杠/网关 | 先试 `https://api.ashareapi.com/mcp/` | | 客户端不能填 Header | 认证方式限制 | 用兜底 URL：`https://api.ashareapi.com/mcp?key= ` | | 工具调用超时 | 单次结果过大 | 减少 `count` / `limit` / `num`，或分批请求 401 Unauthorized Token 是否填错、是否多了 Bearer 只填 Key；或改填 `Bearer ` 再试 看不到工具 URL 是否走错域名 确认是 `api.ashareapi.com`，不是 `ashareapi.com` 连接失败 尾斜杠/网关 先试 `https://api.ashareapi.com/mcp/` 客户端不能填 Header 认证方式限制 用兜底 URL：`https://api.ashareapi.com/mcp?key= ` 工具调用超时 单次结果过大 减少 `count` / `limit` / `num`，或分批请求 兜底 URL 会把 Key 放进 URL，可能进入日志；能用 Bearer 就不要用 Query Key。 ## 能问什么，不能问什么 - ✅ 行情、K 线、财务、资金流、龙虎榜、板块、ETF、可转债、宏观等数据查询 - ✅ 把查询结果整理成表格、摘要、对比 - ⛔ 不自动交易、不接券商、不承诺收益 - ⛔ 不构成投资建议；数据按接口返回的日期和口径解释 - ⛔ 不把缺少的字段补成 0，不把上一交易日的价说成实时价 ## 用哪一档：免费先试，不够再升级 先用免费工具验证链路；财报、批量、选股和研究型调用再按档位升级。价格以 [完整定价页](/pricing) 为准，下面只是按 Today 使用场景给出的选择建议。 | | | 档位 | 价格 | 额度 | 适合 Today 的用法 | | 体验版 | **¥9.9 买断** | 1 万次 · 30 次/分 · 24 个端点 | 看财报、分红、板块，个人轻量研究 | | 标准版 | **¥29.9 买断** | 10 万次 · 120 次/分 · 46 个端点 | 日常研究、公告/资金/更多数据 | | 专业版 | **¥99 买断** | 50 万次 · 300 次/分 · 80 个端点 | 选股、批量财务、Agent 研究 | | 机构版 | **¥199/月** | 10 万次/日 · 600 次/分 · 96 个端点 | 团队、多 IP、机构研究 体验版 **¥9.9 买断** 1 万次 · 30 次/分 · 24 个端点 看财报、分红、板块，个人轻量研究 标准版 **¥29.9 买断** 10 万次 · 120 次/分 · 46 个端点 日常研究、公告/资金/更多数据 专业版 **¥99 买断** 50 万次 · 300 次/分 · 80 个端点 选股、批量财务、Agent 研究 机构版 **¥199/月** 10 万次/日 · 600 次/分 · 96 个端点 团队、多 IP、机构研究 **先接免费工具**试通链路；需要财报/K线批量/选股时再升级： [¥9.9 体验版](/pricing/trial) · [¥29.9 标准版](/pricing/standard) · [¥99 专业版](/pricing/pro) · [机构版](/pricing/unlimited) · [完整定价](/pricing) Today 负责对话和任务编排；数据来自 ashareapi。回答里的每个数字都应能回到接口字段，而不是模型记忆。 ## 常见问题 真的不用开电脑吗？ 不用。Today 和我们的 MCP 都在云端，手机 App 里完成配置即可；不需要本地服务、端口或 Python 环境。 Token 填 Key 还是 Bearer Key？ 认证方式选 Bearer token 后，Token 框通常只填 Key。若客户端提示格式错误，再试 `Bearer `。 为什么今天没有实时价？ 先看返回的 `date` 是不是交易日。休市日、停牌或上游延迟时，最新一根可能不是“今天”；不要把上一交易日的收盘价说成实时价。 免费能用吗？ 可以先接免费工具试用；财务/K 线等端点需要对应 Key 档位。具体额度和计费看 `/pricing`。 能接其他 Personal Agent 吗？ 同一套远程 MCP 形态可以接支持自定义 MCP 的客户端；每个客户端的入口和认证字段不同，Today 这条已按实机界面验证。 最后更新: 2026-10-31 Today 入口按 2026-10-31 实机界面（设置 → 连接应用 → 添加自定义 MCP → 通过链接添加 → Bearer token）；MCP 地址与 Bearer 鉴权以 ashareapi 线上 MCP 端点和 `mcp_remote.py` 为准；行情/财务/K线字段以接口实际返回为准。 相关 - [MCP 接入总览](/mcp) - [定价与额度](/pricing) - [行情接口字段](/docs/endpoints/quote) - [错误码与限流](/docs/errors) [← 全部教程](/docs/guides)