> Source: https://ashareapi.com/docs/guides/mcp-claude-code/  ·  Markdown version for LLMs / AI agents

教程

# 用 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 接入页](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 会返回明确提示，不是"静默失败"）

## 常见问题
 MCP 是什么？和直接调 API 有什么区别？
 MCP（Model Context Protocol）是让 AI Agent 调用外部工具的协议。区别在"谁来写代码"：调 API 是你写代码取数再喂给 AI；MCP 是配一次之后，AI 自己按你的问题去取数。两者背后是同一套后端（32 个端点），MCP 只是把 24 个工具暴露给 Agent。

 不填 Key 能用吗？
 能。行情快照 / K线 / 热搜 / 市场总览 / 涨跌分布 这 5 个工具无需 Key；其余 19 个（财务 / 资金 / 龙虎榜 / 板块估值 / 宏观 / 可转债 / 因子选股等）需要 Key（体验版 ¥9.9 起）。

 免费额度怎么算？
 按调用来源算：匿名 5 次/分；解一次 PoW 挑战（GET /v1/challenge）可提到 60 次/分。客户端多人共用一个出口 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）。

 国内平台（百炼 / 扣子 / 元宝）能接吗？
 阿里云百炼、扣子、腾讯元器、腾讯云智能体开发平台、火山方舟都能接，逐家步骤见国内平台教程。注意：百炼与扣子的官方文档没有"自定义请求头"，所以在那边只能用 5 个免费工具；要付费工具请用腾讯云智能体平台 / 元器 / 火山方舟（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` 为准（24 个工具）。

 接着看

-
[MCP 接入页（19 家客户端配置写法）](/mcp)

-
[国内平台接入教程（百炼 / 扣子 / 元器 / 火山方舟）](/docs/mcp-china)

-
[用 Python 获取 A 股实时行情（3 种方法对比）](/docs/guides/python-ashare-quotes)

-
[端点清单](/endpoints)

 [← 全部教程](/docs/guides)