双十一机构版年付 ¥1,699/年查看年付
教程

用 Claude Code / Codex 查 A 股数据:MCP 接入

MCP 让 AI Agent 直接查真实数据,而不是凭记忆编答案。配一次就好 —— 填 https://api.ashareapi.com/mcp,免费工具连 Key 都不用。

配好之后能问什么

配好后在对话里直接问,AI 会自己去调工具取数,而不是凭训练记忆回答:

  • 太极实业(600667)今天资金流向怎么样?
  • 最近 5 个交易日涨幅最大的板块是哪些?
  • 帮我筛 PE 小于 20 且 ROE 大于 15 的股票
  • 沪深 300 现在估值贵不贵?
  • 今天龙虎榜机构买了什么?

配 Claude Code:一行命令(最快)

Claude Code 支持一条命令添加远程 MCP 服务器(--transport http 就是我们的类型)。只试免费工具时不要 --header 那半行。

终端(Claude Code)
# 免费工具(无需 Key)
claude mcp add --transport http ashareapi https://api.ashareapi.com/mcp

# 要用付费工具(财务/资金/龙虎榜…)再加请求头
claude mcp add --transport http ashareapi https://api.ashareapi.com/mcp \
  --header "Authorization: Bearer ct-你的KEY"

# 检查是否连上(应显示 ✔ Connected)
claude mcp list

配 Cursor / Claude Code:JSON 写法

Cursor 的配置文件是 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局);Claude Code 也可以用 .mcp.json(项目根)或 ~/.claude.json。

.cursor/mcp.json(或 .mcp.json)
{
  "mcpServers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的KEY" }
    }
  }
}
  • 关键坑:url 必须同时写 "type": "http" —— Claude Code 把「有 url 但没有 type」的条目当成 stdio 服务器并直接跳过(官方文档明说会报 has a "url" but no "type")。上面这份配置已经带了,别手删。
  • 只试免费工具:把 headers 那行整个删掉即可(其余不变)。
  • VS Code 的键名不一样:用 "servers"(不是 mcpServers),值同样带 "type": "http" + url。

Codex / VS Code / Gemini CLI / OpenCode 等客户端的配置

先说 Codex:2026-07-09 起 Codex 已并入 ChatGPT 桌面端(Chat / Work / Codex 三模式一个应用,旧的独立 Codex app 没了),但 Codex CLI 不受影响 —— MCP 配置仍在 ~/.codex/config.toml(官方《Developer settings》原文:桌面端的 MCP 设置与 CLI 共用同一份 config.toml)。

Codex · ~/.codex/config.toml
[mcp_servers.ashareapi]
url = "https://api.ashareapi.com/mcp"
http_headers = { Authorization = "Bearer ct-你的Key" }
VS Code · .vscode/mcp.json
{
  "servers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
Gemini CLI · ~/.gemini/settings.json
{
  "mcpServers": {
    "ashareapi": {
      "httpUrl": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
OpenCode · opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ashareapi": {
      "type": "remote",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
Cline · ~/.cline/mcp.json
{
  "mcpServers": {
    "ashareapi": {
      "type": "streamableHttp",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
Windsurf · mcp_config.json
{
  "mcpServers": {
    "ashareapi": {
      "serverUrl": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
CodeBuddy · ~/.codebuddy/.mcp.json
{
  "mcpServers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
WorkBuddy · ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}
  • 键名不同,别照抄:VS Code 用 servers · Gemini CLI 用 httpUrl · Cline 要 "type":"streamableHttp" · Windsurf 用 serverUrl · OpenCode / Kilo Code / ZCode 用 mcp 键 · Codex 是 TOML 不是 JSON
  • 其余客户端(Trae / Kimi Code / MiMo Code / Manus / Devin / OpenClaw / Hermes)逐家写法见 MCP 接入页
  • ChatGPT 本体(网页 / 桌面 app)也能接远程 MCP,但走另一条路:Developer mode → Apps → Create custom connector(填 endpoint → 选认证方式 → Scan Tools),目前面向 Business / Enterprise / Edu 工作区 —— 与 config.toml 无关。
  • 国内平台(豆包工作 / 阿里云百炼 / 扣子 / 腾讯元器 / 腾讯云智能体平台 / 火山方舟):见国内平台接入教程(百炼与扣子官方未提供自定义请求头 → 那边只能用免费工具)

30 秒验证

配好后重启客户端,然后问一句「太极实业(600667)现价多少?」。判断标准是看它有没有真的调用工具(对话里会出现工具调用/ashare_quote 字样),而不是看答案像不像真的 —— AI 凭空编的数字往往也很像。

也可以直接看客户端的 MCP 列表:Claude Code 用 /mcp,或命令行 claude mcp list(应显示 √ Connected)。要看工具清单,直接在会话里让它列。

配好了却查不到数据?按这几条排查

  • URL 写错:必须是 https://api.ashareapi.com/mcp(注意是 /mcp,别写成站点页 ashareapi.com/mcp/ 去当接口用也无妨,但接口域名是 api. 开头)
  • 免费额度被撞:匿名按调用来源限流(5 次/分,解一次 PoW 挑战可到 15 次/分)——同一个平台/办公室共用一个出口 IP 时容易撞限流,填 Key 即可
  • 股票代码没带前缀:sh600667 / sz000001 / hk00700 / usAAPL;只给 6 位数字取不到
  • Claude Code 里 url 少了 type:会被当成 stdio 跳过(见上面那条坑)
  • 工具清单是"保存那一刻"同步的:我们后来新增的工具,需要重新保存/刷新一次配置才会出现
  • 只想用免费工具:确认 Authorization 那行已经删掉(付费工具没 Key 会返回明确提示,不是"静默失败")

常见问题

MCP 是什么?和直接调 API 有什么区别?

MCP(Model Context Protocol)是让 AI Agent 调用外部工具的协议。区别在"谁来写代码":调 API 是你写代码取数再喂给 AI;MCP 是配一次之后,AI 自己按你的问题去取数。两者背后是同一套后端(102 个端点),MCP 只是把 92 个工具暴露给 Agent。

不填 Key 能用吗?

能。行情快照 / K线 / 热搜 / 市场总览 / 涨跌分布 这 6 个工具无需 Key;其余 86 个(分时 / 财务 / 资金 / 龙虎榜 / 板块估值 / 宏观 / 可转债 / 因子选股 / 量化回测等)需要 Key(体验版 ¥9.9 起)。

免费额度怎么算?

按调用来源算:匿名 5 次/分;解一次 PoW 挑战(GET /v1/challenge)可提到 15 次/分。客户端多人共用一个出口 IP 时容易撞限流,所以正式用建议填 Key(按档位限流,标准版 120 次/分)。

除了 Claude Code / Codex,还支持哪些客户端?

19 家:Claude Code · Cursor · VS Code · Codex · OpenCode · Gemini CLI · Cline · Windsurf · CodeBuddy · WorkBuddy · Trae · Kimi Code · ZCode · MiMo Code · Kilo Code · Manus · Devin · OpenClaw · Hermes。逐家配置写法与键名差异见 MCP 接入页(有的客户端键名是 servers,有的是 mcp,有的是 httpUrl)。

国内平台(豆包 / 百炼 / 扣子 / 元器 / 腾讯云 / 火山方舟)能接吗?

豆包工作、阿里云百炼、扣子、腾讯元器、腾讯云智能体开发平台、火山方舟都能接,逐家步骤见国内平台教程。注意:百炼与扣子的官方文档没有"自定义请求头",所以在那边只能用 6 个免费工具;要付费工具请用豆包工作 / 腾讯云智能体平台 / 元器 / 火山方舟(Responses API)或 Claude Code / Cursor 这类支持 Header 的客户端。

最后更新: 2026-09-21

配置写法依据各客户端官方文档核对(2026-09-21:Claude Code MCP 文档的 claude mcp add --transport http、.mcp.json 的 "type": "http"、以及「url 无 type 会被当作 stdio 跳过」的官方错误说明)。工具清单以线上 tools/list 为准(92 个工具)。