> Source: https://ashareapi.com/mcp/  ·  Markdown version for LLMs / AI agents

AI 原生

# 接进 AI Agent（MCP）
 MCP 是让 AI Agent 调用外部工具的协议。配一次，之后你问「太极实业今天资金怎么样」，AI 自己去查。

 一句话原理
 AI Agent（Claude Code / Codex 等）通过 MCP 协议连到我们的服务，把你的自然语言问题翻译成 API 调用。**你不用写任何代码**——写代码的活交给 AI。

## 配置（3 步）
 1 选你的客户端，找到配置文件（纯 UI 客户端在设置里添加）
 Claude Code `.mcp.json`
 Cursor `.cursor/mcp.json`
 VS Code `.vscode/mcp.json`
 Codex `~/.codex/config.toml`
 OpenCode `opencode.json`
 Gemini CLI `~/.gemini/settings.json`
 Cline `~/.cline/mcp.json`
 Windsurf `mcp_config.json`
 CodeBuddy `~/.codebuddy/.mcp.json`
 WorkBuddy `~/.workbuddy/mcp.json`
 Trae `设置 → MCP → 手动配置`
 Kimi Code `~/.kimi/mcp.json`
 ZCode `~/.zcode/cli/config.json`
 MiMo Code `mimocode.json`
 Kilo Code `kilo.jsonc`
 Manus `设置 → 集成 → 自定义 MCP`
 Devin `~/.config/devin/mcp_config.json`
 OpenClaw `~/.openclaw/openclaw.json`
 Hermes `~/.hermes/config.yaml`

 国内平台（同样填 URL + 请求头，无需安装任何东西）
 豆包工作 `插件·技能·伙伴 → 插件 → + 添加 → 新建自定义插件`
 阿里云百炼 `MCP 管理 → 创建 MCP 服务 → http 方式`
 扣子 Coze `扩展 → MCP → 添加自定义 MCP（粘贴 JSON）`
 腾讯元器 `接入 MCP 插件 → 填 URL`
 腾讯云智能体开发平台 `插件广场 → 自定义插件 → 基于 MCP`
 火山方舟 `Responses API → tools[type=mcp] + headers`

 [国内平台详细接入步骤（逐家核对官方文档） →](/docs/mcp-china)

 2 粘贴配置
 把下面这段加进配置文件 / 设置里（把 ct-你的KEY 换成你的 Key；**只试免费工具**的话可以把 Authorization 那行删掉）。

 .mcp.json

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

```
{
 "mcpServers": {
 "ashareapi": {
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 .vscode/mcp.json

```
{
 "servers": {
 "ashareapi": {
 "type": "http",
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.codex/config.toml

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

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

```
{
 "mcpServers": {
 "ashareapi": {
 "httpUrl": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.cline/mcp.json

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

```
{
 "mcpServers": {
 "ashareapi": {
 "serverUrl": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.codebuddy/.mcp.json

```
{
 "mcpServers": {
 "ashareapi": {
 "type": "http",
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.workbuddy/mcp.json

```
{
 "mcpServers": {
 "ashareapi": {
 "type": "http",
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 设置 → MCP → 手动配置

```
{
 "mcpServers": {
 "ashareapi": {
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.kimi/mcp.json

```
{
 "mcpServers": {
 "ashareapi": {
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.zcode/cli/config.json

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

```
{
 "mcp": {
 "ashareapi": {
 "type": "remote",
 "url": "https://api.ashareapi.com/mcp",
 "oauth": false,
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 kilo.jsonc

```
{
 "mcp": {
 "ashareapi": {
 "type": "remote",
 "url": "https://api.ashareapi.com/mcp",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 设置 → 集成 → 自定义 MCP

```
服务器名称：ashareapi
服务器 URL：https://api.ashareapi.com/mcp
身份验证：Bearer ct-你的KEY
```
 ~/.config/devin/mcp_config.json

```
{
 "mcpServers": {
 "ashareapi": {
 "url": "https://api.ashareapi.com/mcp",
 "transport": "http",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
}
```
 ~/.openclaw/openclaw.json

```
{
 "mcp": {
 "servers": {
 "ashareapi": {
 "url": "https://api.ashareapi.com/mcp",
 "transport": "streamable-http",
 "headers": { "Authorization": "Bearer ct-你的KEY" }
 }
 }
 }
}
```
 ~/.hermes/config.yaml

```
mcp_servers:
 ashareapi:
 url: "https://api.ashareapi.com/mcp"
 headers:
 Authorization: "Bearer ct-你的KEY"
```
 Claude Desktop 用户：它的远程连接走 OAuth（官方规范），暂不支持此方式——请用上面这些客户端。ChatGPT（网页 / 桌面 app）也能接远程 MCP，但走的是 Developer mode → Apps → Create custom connector（面向 Business / Enterprise / Edu 工作区），与 config.toml 无关。其他支持"远程 MCP + 自定义请求头"的客户端同理：把 URL 和 Authorization 头填进去即可。客户端填不了自定义请求头时（例如 ChatGPT 网页版的 custom connector），把 Key 放在 URL 上也一样能用：https://api.ashareapi.com/mcp?key=你的KEY —— 工具范围、额度、限流与请求头方式完全一致；生产环境仍建议用请求头（Key 不进 URL 更安全）。

 3 重启 AI Agent，问它
 重启后在对话里直接问，例如：

-
 太极实业（600667）今天资金流向怎么样？

-
 最近 5 个交易日涨幅最大的板块是哪些？

-
 帮我找 PE 小于 20 且 ROE 大于 15 的股票

-
 沪深 300 现在估值贵不贵？

-
 今天龙虎榜机构买了什么？

 怎么确认接好了：问它「你能查 A 股数据吗」；或看客户端的 MCP 列表里有没有 ashareapi（服务器名）。

## 提供哪些工具
 AI 会在需要时自动调用。客户端里工具名会带 ashare_ 前缀（如 ashare_quote）；你不需要记这些名字。
 行情（免费，无需 Key）

-
 quote 实时快照

-
 kline K线

-
 hot 全市场热度榜（热搜股票/热度/热文/板块/ETF）

-
 changedist 涨跌分布

-
 market_overview 市场总览

-
 wiki_search 文档检索

 资讯（需 Key）

-
 agent_search 一句话取数（自然语言→数据+证据链·不可答会明确拒答）

-
 news 个股最新资讯

-
 flash 7×24 财经快讯（全市场电报）

-
 evidence 财经多源取证（公告+资讯·去重·带指纹）

-
 notice 公告（列表 / 详情，可回溯约 16 年）

 个股深度（需 Key）

-
 orderbook 五档盘口

-
 snapshot 全字段画像（估值/市值/股本/涨停价）

-
 minute 分时（当日 / 近 5 日）

-
 kline_full 全历史K线（10 年 + 可选复权）

-
 market_kline 全市场单日K线（一次拿全 A 股）

-
 abnormal 异动/偏离值（触发严重异动 / 10日100% 偏离 / 盯盘名单）

 短线打板（需 Key）

-
 review 复盘（板块主线 / 连板梯队）

-
 limit_up 打板（涨停池明细 / 竞价涨停：涨停原因 / 封单 / 主力净额）

-
 auction 集合竞价（9:15–9:25 竞价分时 + 竞价触及涨停判定）

-
 market_mood 市场情绪（破板率 + 赚钱效应 9 日趋势）

-
 limit_reason 涨停原因（单票历史 · 完整原因文案）

-
 broken_board 炸板历史（涨停被砸开的票）

-
 tail_chase 尾盘抢筹（全市场抢筹金额榜）

-
 northbound A股北向分板块持仓（季度）

-
 new_high 百日新高（按题材）

 基本面

-
 profile 公司简况（上市日期/主营/行业）

-
 finance 财务三表

-
 technical 技术指标

-
 shareholder 股东研究

-
 dividend 分红

-
 events 事件标签

-
 calendar 个股事件日历（分红/解禁/财报/新股）

-
 chip 筹码分布（获利盘/平均成本/集中度）

-
 suspension 停复牌清单（沪深/港股/美股）

-
 buyback 公司回购（A股/港股）

-
 consensus 一致预期（目标价+盈利预测）

-
 rating 机构评级（港股/美股 · 目标价+评级分布）

-
 disclosure 财报披露日历（预约披露日）

 资金

-
 fund 资金+龙虎榜+大宗+两融

-
 lhb 龙虎榜分榜

-
 lhb_seats 龙虎榜席位明细（营业部/游资标记·机构版）

-
 lhb_agency 龙虎榜机构参与个股榜（全市场筛票·净买入可为负·机构版）

-
 bigorder L2 大单资金分时（分钟级净额·机构版）

-
 bigorder_flow L2 大单成交明细（主动/被动×买卖·机构版）

-
 bigorder_queue L2 大单委托流（挂单/撤单标记·机构版）

-
 bigorder_history L2 历史大单净额（逐日·最多100个交易日·机构版）

-
 bigorder_split L2 主力四分解（主动/被动×买卖+买卖均价·可回看历史·机构版）

-
 bigorder_rank L2 全市场主力净额榜（约5568只·8种排序·机构版）

-
 margin_trade 融资融券明细（融资余额/买入/偿还）

-
 block_trade 大宗交易明细（成交价/折溢价/营业部）

-
 fund_flow 个股资金流向（A股/港股）

-
 fund_short 卖空数据（港股/美股）

-
 fund_south 南下资金持仓（港股通季度）

 板块与宏观

-
 sector 板块行情

-
 sector_valuation 板块估值

-
 index_constituent 指数成分股（沪深300 等 · 全量清单）

-
 index_list 指数清单（1223 个 · 含港股指数）

-
 score 股票评分（五维 · 含周月季变动）

-
 report 研报（列表 / 全文）

-
 industry_chain 产业链（183 主题 / 图谱 / 个股定位）

-
 macro 宏观指标

-
 screen 因子选股

-
 bond 可转债

 量化（需 Key）

-
 scanner（选股员 / scanner Agent）（自然语言条件→候选池+证据+工具轨迹 · BYOK · 99 起）

-
 backtest 回测（单标的 / 组合）

-
 backtest_batch 批量回测（多标的 × 多策略）

-
 strategies 策略清单

-
 factors 因子库

-
 playbooks 方法论库

 批量取数（需 Key · 专业版）

-
 quote_batch 批量行情（一次多只，逐只给状态）

-
 kline_batch 批量K线（多只 × 同一段时间）

-
 snapshot_batch 批量全字段画像（估值/市值/股本，300只约0.4秒）

-
 profile_batch 批量公司简况（上市日期/主营/行业，100只约6.8秒）

-
 chip_batch 批量筹码分布（获利盘/平均成本/集中度，200只约3.9秒）

-
 shareholder_batch 批量股东研究（十大股东/流通股东/股东户数，200只约4.1秒）

-
 finance_batch 批量财报（利润/资产负债/现金流，10只×4期约4.2秒）

-
 technical_batch 批量技术指标（MA/MACD/KDJ/RSI/BOLL 等 55 项，500只约1.2秒）

-
 fund_batch 批量资金流（多只的资金面一次拿）

 工具类

-
 ask_user 歧义时向用户提问（返回 1–4 个带说明的选项）

-
 stocks 全市场股票清单（代码/名称/上市日期/行业·一次拿全 A 股）

-
 etf ETF 数据

-
 ipo 新股日历

-
 dehydrated 脱水研报

-
 search 搜索

-
 usage 用量

 为什么这样比 SDK 更好用
 传统数据 API 要你写代码集成（SDK + 鉴权 + 错误处理）。MCP 把这件事交给 AI —— 你只要描述需求。**对「用 AI 做研究」的场景，这比 SDK 省事得多。**

 还没有 Key？
 免费工具（行情/K线/热搜/市场总览/涨跌分布/文档检索）无需 Key 即可用；其余工具需 Key（体验版 ¥9.9 起，86 个工具全开）。

 [看快速开始](/docs)[获取 Key](/pricing)
