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

配好之后能问什么

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

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

配 Claude Code：一行命令（最快）

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

# 免费工具（无需 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`。

{
  "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）。

[mcp_servers.ashareapi]
url = "https://api.ashareapi.com/mcp"
http_headers = { Authorization = "Bearer ct-你的Key" }

{
  "servers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "mcpServers": {
    "ashareapi": {
      "httpUrl": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ashareapi": {
      "type": "remote",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "mcpServers": {
    "ashareapi": {
      "type": "streamableHttp",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "mcpServers": {
    "ashareapi": {
      "serverUrl": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "mcpServers": {
    "ashareapi": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": { "Authorization": "Bearer ct-你的Key" }
    }
  }
}

{
  "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 接入页](https://ashareapi.com/mcp/)
• ChatGPT 本体（网页 / 桌面 app）也能接远程 MCP，但走另一条路：Developer mode → Apps → Create custom connector（填 endpoint → 选认证方式 → Scan Tools），目前面向 Business / Enterprise / Edu 工作区 —— 与 `config.toml` 无关。
• 国内平台（阿里云百炼 / 扣子 / 腾讯元器 / 腾讯云智能体平台 / 火山方舟）：见[国内平台接入教程](https://ashareapi.com/docs/mcp-china/)（百炼与扣子官方未提供自定义请求头 → 那边只能用免费工具）

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 挑战可到 60 次/分）——同一个平台/办公室共用一个出口 IP 时容易撞限流，填 Key 即可
• 股票代码没带前缀：`sh600667` / `sz000001` / `hk00700` / `usAAPL`；只给 6 位数字取不到
• Claude Code 里 `url` 少了 `type`：会被当成 stdio 跳过（见上面那条坑）
• 工具清单是"保存那一刻"同步的：我们后来新增的工具，需要重新保存/刷新一次配置才会出现
• 只想用免费工具：确认 `Authorization` 那行已经删掉（付费工具没 Key 会返回明确提示，不是"静默失败"）