接入 AI Agent(MCP)

DataSinking 是一个 MCP server。把你的 Agent 指向它,就能用大白话检索并阅读来自中国、韩国、日本和台湾的财报全文——不用写代码,6 个工具。先 免费领一个 key。本页属于 API 参考的一部分。

选择你的客户端

客户端配置文件托管 URL 是否可用
Claude Code~/.claude.json, .mcp.json可以
Claude Desktopclaude_desktop_config.json + Connectors UI走 UI
Cursor.cursor/mcp.json可以
OpenAI Codex CLI~/.codex/config.toml可以
WorkBuddy / CodeBuddy~/.workbuddy/mcp.json, ~/.codebuddy/.mcp.json仅 CodeBuddy
其它客户端command + args + env通常可以
DeepSeek (Harness dsh)~/.dsh/cordis.patch.yml (YAML)可以
Windsurf / Devin~/.config/devin/mcp_config.json可以

托管端点

一个 URL,什么都不用装,机器上也不需要 Python 或 Node。鉴权用 bearer 请求头;对于无法自定义 请求头的客户端,可以用 ?apikey=

https://api.datasink.ing/mcp

Authorization: Bearer YOUR_KEY      # or: https://api.datasink.ing/mcp?apikey=YOUR_KEY

下面每个客户端,只要支持托管方式,给出的就是托管写法。不支持时,文档会退回到本地 server —— 同样是那 6 个工具,通过 npx uvx 在你自己的机器上运行,依然什么都不用装。

Claude Code

.mcp.json · ~/.claude.json

一条命令——提示时填入 key,然后确认已经连上:

claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
  --header "Authorization: Bearer YOUR_KEY"

claude mcp list        # → datasinking: ✔ Connected

加上 --scope user 可以让它在所有项目里都能用, 而不只是当前这一个。Claude Code 会自己对 server 做健康检查,所以 claude mcp get datasinking 能明确告诉你 连接为什么失败。

完整配置指南 →

Claude Desktop

claude_desktop_config.json

Settings → Connectors → Add → Add custom connector,粘贴 https://api.datasink.ing/mcp,然后完成授权提示。 这件事不要改 JSON 文件,也不要用 mcp-remote —— 那个文件只支持 stdio, 不接受 url 这个键。

完整配置指南 →

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "datasinking": {
      "url": "https://api.datasink.ing/mcp",
      "headers": { "Authorization": "Bearer ${env:DATASINK_API_KEY}" }
    }
  }
}

Cursor 内插的是 ${env:NAME} —— 不像 Claude Code 那样用 ${NAME}。改完要重启 Cursor;连接错误会显示在 Output → MCP Logs 下面。

完整配置指南 →

OpenAI Codex CLI

~/.codex/config.toml

[mcp_servers.datasinking]
url = "https://api.datasink.ing/mcp"
bearer_token_env_var = "DATASINK_API_KEY"

Codex 没有 type 字段 —— 传输方式是根据你写的是 url 还是 command 推断出来的。请求头的键是 http_headers,不是 headers;直接写裸的 bearer_token 会被拒绝 —— 请用环境变量。

完整配置指南 →

WorkBuddy / CodeBuddy(腾讯)

~/.workbuddy/mcp.json · ~/.codebuddy/.mcp.json

这是两个不同的产品,配置文件也是两份 —— 这也是配置“不生效”最常见的原因:

// WorkBuddy (desktop app) — ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

WorkBuddy 官方文档里的配置只支持 stdio; type: "http" 这种写法在 CodeBuddy Code 上可用,后者的配置放在 ~/.codebuddy/.mcp.json。改完任何一份都要重启应用。

完整配置指南 →

其它 MCP 客户端

command + args + env

本地方式、stdio,需要 Node 18+ 或 Python 3.8+:

{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

# Python instead of Node:
#   "command": "uvx", "args": ["--from", "datasinking[mcp]", "datasinking-mcp"]

完整配置指南 →

Agent 能用什么

6 个工具。它们与 REST 端点一一对应,所以 API 参考 里的任何内容,都能靠一句话问出来。

list_exchanges覆盖了哪些市场,各有多少数据
list_stocks某个交易所的上市公司
list_reports某家公司的公告 —— 仅元数据
get_report单份公告,全文
list_sections一份公告的章节标题及其大小
get_section只取单个章节 —— 省 token,最适合 RAG

可以先问一句 “DataSinking 覆盖哪些交易所?” 试试 —— Agent 能调用 list_exchanges 就说明整条链路都是通的。 然后再试试 “丰田最新的年报里怎么讲风险?”

连不上时

托管端点只支持 POST,而且是无状态的。大多数连接失败都出在这两点上, 因为客户端往往默认按相反的方式工作:

401{"detail":"Missing API key"} —— 什么都没发出去。 {"detail":"无效的 API key"} —— 这个 key 不认识。
405用的是 GET。这里没有 SSE 流 —— 只能 POST
no tools重启客户端。所有客户端都只在启动时读一次 MCP 配置。
blank header环境变量在客户端启动前没有设置,或者该客户端的内插语法你用错了。

想分清“是我的客户端配错了”还是“我的 key 不对”,可以完全绕开客户端直接测:

curl -s -X POST https://api.datasink.ing/mcp \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

各客户端的专项排查 —— 包括每个客户端实际打印出来的报错 —— 都在上面链接的指南里,位于 docs/mcp/

保留来源署名

每个响应都带一个 source 字段,标明这份财报来自哪个官方 披露平台 —— cninfo.com.cn(中国)、DART(韩国)、EDINET(日本)、MOPS (台湾)。MCP 工具的说明里已经要求模型引用时保留它。你转发这些内容时,也请不要把它去掉。