接入 AI Agent(MCP)
DataSinking 是一个 MCP server。把你的 Agent 指向它,就能用大白话检索并阅读来自中国、韩国、日本和台湾的财报全文——不用写代码,6 个工具。先 免费领一个 key。本页属于 API 参考的一部分。
选择你的客户端
| 客户端 | 配置文件 | 托管 URL 是否可用 |
| Claude Code | ~/.claude.json, .mcp.json | 可以 |
| Claude Desktop | claude_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 工具的说明里已经要求模型引用时保留它。你转发这些内容时,也请不要把它去掉。