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
OpenCodeopencode.json
Gemini CLI~/.gemini/settings.json
Cline~/.cline/mcp.json
Windsurfmcp_config.json
CodeBuddy~/.codebuddy/.mcp.json
WorkBuddy~/.workbuddy/mcp.json
Trae设置 → MCP → 手动配置
Kimi Code~/.kimi/mcp.json
ZCode~/.zcode/cli/config.json
MiMo Codemimocode.json
Kilo Codekilo.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

国内平台详细接入步骤(逐家核对官方文档) →

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 个工具全开)。