AI エージェント接続(MCP)
DataSinking は MCP サーバーです。エージェントをここに向ければ、米国・中国・欧州・日本・韓国・台湾の決算書全文を平易な 言葉で検索・閲覧できます — コードは不要、6 つのツールだけです。まず 無料のキーを取得 してください。API リファレンスの一部です。
クライアントを選ぶ
| クライアント | 設定ファイル | ホスト版 URL が使えるか |
| Claude Code | ~/.claude.json · .mcp.json | 可 |
| Claude Desktop | Connectors UI · claude_desktop_config.json | 可 |
| Cursor | .cursor/mcp.json | 可 |
| OpenAI Codex CLI | ~/.codex/config.toml | 可 |
| WorkBuddy / CodeBuddy | ~/.workbuddy/mcp.json · ~/.codebuddy/.mcp.json | CodeBuddy のみ |
| Doubao Work | in-app connectors, no file | 可 |
| Devin Desktop | %AppData%\devin\mcp_config.json | 可 |
| DeepSeek Harness (dsh) | ~/.dsh/profiles/<name>/cordis.patch.yml | 可 |
| Gemini CLI | ~/.gemini/settings.json | 可 |
| OpenCode | ~/.config/opencode/opencode.json | 可 |
| Qoder | ~/.qoder/settings.json (CLI) · Settings → MCP (IDE) | 可 |
| Reasonix | reasonix.toml · .mcp.json | 可 |
| Mobile (Kelivo / Joey / Systemprompt) | アプリ内、設定ファイルなし | 可 |
| Any other client | command + args + env | 通常は可 |
エンドポイント
URL は 1 つだけ、インストールするものは何もありません。認証は Bearer ヘッダー、または ヘッダーを設定できないクライアント向けの ?apikey= です。
https://api.datasink.ing/mcp Authorization: Bearer YOUR_KEY # or: https://api.datasink.ing/mcp?apikey=YOUR_KEY
Claude Code
.mcp.json · ~/.claude.json
コマンド 1 つです — プロンプトが出たらキーを追加し、接続できたか確認します:
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 はサーバーの ヘルスチェックを自分で行うため、claude mcp get datasinking で 接続に失敗した理由が正確にわかります。
Claude Desktop
claude_desktop_config.json
Settings → Connectors → Add → Add custom connector を開き、キーをあらかじめ埋め込んだ URL を貼り付けます:
https://api.datasink.ing/mcp?apikey=YOUR_KEY
キーは URL に含めなければなりません。素の URL だとコネクターが OAuth を試みますが、この サーバーに OAuth はありません — “Couldn't register with …'s sign-in service.” と表示されます。 そのあとアプリを再起動してください。コネクターは起動時に読み込まれます。
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
コマンド 1 つです — 設定ファイルは自動で書き込まれます:
codex mcp add datasinking --url https://api.datasink.ing/mcp \ --bearer-token-env-var DATASINK_API_KEY codex mcp list # → datasinking
起動する前にこの環境変数を設定してください — Codex が保存するのは変数の名前で、 キーそのものではありません。
WorkBuddy / CodeBuddy (Tencent)
~/.workbuddy/mcp.json · ~/.codebuddy/.mcp.json
この 2 つは別製品で、設定ファイルも別々です — 設定が「効かない」と 言われる最もよくある原因がこれです:
// 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 に保管します。 どちらを編集した場合も、アプリを再起動してください。
Doubao Work (ByteDance)
no file — configured in the app
ByteDance 版の WorkBuddy にあたる存在です。こちらは 設定をすべて UI 上で行います — 編集すべき設定ファイルがないため、上の表の 各行とは形が異なります:
技能 · 连接器 · 伙伴 → 新建 → 新建自定义连接器
- Transport: HTTP(ローカルサーバーを動かしたい場合は STDIO も選べます)
- URL:
https://api.datasink.ing/mcp - 自定义 Headers:
Authorization=Bearer YOUR_KEY
保存して、トグルがオンになっていることを確認してください。知っておきたい点が 2 つあります。 カスタム MCP コネクターが読み込まれるのは デスクトップクライアントだけで、ブラウザ版とモバイル版では無視されます。 また Doubao はヘッダーをそのまま受け付けるため、ここでは ?apikey= の代替手段は不要です。
Devin Desktop
%AppData%\devin\mcp_config.json
旧 Windsurf です。正しいファイルは Cascade → MCP → Open MCP config file から開けます:
{
"mcpServers": {
"datasinking": {
"serverUrl": "https://api.datasink.ing/mcp",
"headers": { "Authorization": "Bearer ${env:DATASINK_API_KEY}" }
}
}
}リモート用のフィールドは serverUrl で、 url ではありません — ここに挙げた中で 異なるのはこのクライアントだけです。Windows では %AppData%\devin\mcp_config.json、macOS と Linux では ~/.config/devin/mcp_config.json です。
DeepSeek Harness (dsh)
~/.dsh/profiles/<name>/cordis.patch.yml
dsh には MCP の設定ファイルがありません — サーバーはプラグインとして扱われます。まずプロファイルにインストールします:
dsh plugin --profile web add @deepseek-ai/dsh-mcp-client
そのうえで、このプロファイルのパッチレイヤーに次の行を追加します:
- insert:
- id: mcp-datasinking
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: datasinking
transport: streamable-http
url: https://api.datasink.ing/mcp
headers:
Authorization: !!js '`Bearer ${process.env.DATASINK_API_KEY}`'
failOnStartupError: truefailOnStartupError: true は必ず付けて ください。デフォルトは false で、どこにも接続しないまま エラーも報告しません。ツールは mcp__datasinking__<tool> として 現れます。
Gemini CLI
~/.gemini/settings.json
1 つのコマンド、または設定ファイルを直接編集:
gemini mcp add --transport http datasinking https://api.datasink.ing/mcp \ --header "Authorization: Bearer YOUR_KEY" gemini mcp list # → datasinking
設定ファイルのフィールドは httpUrl で、 url ではありません —— url は SSE を指します:
{
"mcpServers": {
"datasinking": {
"httpUrl": "https://api.datasink.ing/mcp",
"headers": { "Authorization": "Bearer ${DATASINK_API_KEY}" }
}
}
}コンシューマー版 Gemini(gemini.google.com → 接続済みアプリ)は OAuth のみ対応なので、そこでは ?apikey= で key を URL に埋め込むか、CLI を使ってください。
OpenCode
~/.config/opencode/opencode.json
OpenCode は ~/.config/opencode/opencode.json とプロジェクトの opencode.json をマージします。MCP のキーは mcp で、 mcpServers ではありません:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"datasinking": {
"type": "remote",
"url": "https://api.datasink.ing/mcp",
"oauth": false,
"headers": { "Authorization": "Bearer {env:DATASINK_API_KEY}" }
}
}
}重要なのは 2 つの設定です。 "oauth": false にすると、OpenCode が私たちの 401 を OAuth チャレンジと誤認するのを止めます —— 省略すると「認可エラー」になり、「キー不足」になりません。 補間構文は {env:NAME} で、Claude Code と Cursor は ${NAME} を使います。
Qoder
~/.qoder/settings.json (CLI) · Settings → MCP (IDE)
Qoder CLI と Qoder IDE は 別の 設定を読みます。CLI では ~/.qoder/settings.json の mcpServers に追加します:
{
"mcpServers": {
"datasinking": {
"type": "http",
"url": "https://api.datasink.ing/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}stdio がデフォルトの type なので、URL に "http" がないと起動エラーになります。ツールは mcp__datasinking__<tool> として現れます。IDE では Settings(Ctrl Shift ,)→ MCP → My Servers → + Add で別途設定します —— IDE は CLI のファイルを読みません。
Reasonix
reasonix.toml · .mcp.json
Reasonix は公式 MCP Registry を読むので、ワンライナーがあります。または [[plugins]] を ./reasonix.toml(全プロジェクトなら ~/.reasonix/config.toml)に書きます:
reasonix mcp install io.github.heubme2020/datasinking
# or, by hand:
[[plugins]]
name = "datasinking"
type = "http"
url = "https://api.datasink.ing/mcp"
headers = { Authorization = "Bearer ${DATASINK_API_KEY}" }type はデフォルトで stdio なので、 "http" の行が必須です。コールドスタートのサーバーはバックグラウンドで接続します —— ツールがまだ出ていなければ再試行し、設定を何度も確認しないでください。ツールは mcp__datasinking__<tool> として現れます。
Mobile (Kelivo / Joey / Systemprompt)
アプリ内、設定ファイルなし
streamable HTTP 対応のモバイルアプリならどれでも動きます——インストール不要、設定ファイルなし。アプリ内でサーバーを追加してください(設定 → MCP → 追加):
URL: https://api.datasink.ing/mcp Authorization: Bearer YOUR_KEY # アプリがヘッダーを設定できない場合は、key を URL に入れます: # https://api.datasink.ing/mcp?apikey=YOUR_KEY
動作確認済み:Kelivo(kelivo.psycheas.top)、Joey MCP Client(Android)、Systemprompt(Android/iOS)。デスクトップと同じエンドポイントなので、6 ツールと ?apikey= のフォールバックは同じ挙動です。
その他の 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"]エージェントが使えるもの
6 つのツールです。REST エンドポイントと 1 対 1 で対応しているため、 API リファレンス にあるものは、質問するだけで取得できます。
| list_exchanges | どの市場が対象で、どれくらいの分量があるか |
| list_stocks | 1 つの取引所の企業一覧 |
| list_reports | ある企業の決算書一覧 — メタデータのみ |
| get_report | 1 件の決算書、全文 |
| list_sections | ある決算書の章見出しと、その分量 |
| get_section | 1 章だけ — トークン効率がよく、RAG に最適 |
最初のテストとして 「DataSinking はどの取引所を対象にしていますか?」 と聞いて みてください — エージェントが list_exchanges を呼べば、一連の流れが 動いている証明になります。次に 「トヨタの最新の年次報告書はリスクについて何と言っていますか?」 を試して ください。
接続できないとき
接続の失敗は、ほぼ次の 3 つのどれかです:
| {"detail":"Missing API key"} | 何も送信されていません — クライアントを起動する前に環境変数が設定されていません でした。 |
| {"detail":"无效的 API key"} | キーが認識されていません — 余分な空白や、 Bearer の欠落を確認して ください。 |
| no tools | クライアントを再起動してください。どのクライアントも起動時に MCP 設定を読み込みます。 |
「クライアントの設定ミス」と「キーが間違っている」を切り分けるには、クライアントを 介さずに試してください:
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 フィールドがあり、その決算書が どの公式プラットフォームから来たかを示します — SEC EDGAR(米国)、cninfo.com.cn(中国)、filings.xbrl.org(欧州)、EDINET(日本)、DART(韓国)、MOPS(台湾)。MCP のツール説明では、引用する際にこれを保持するよう モデルに指示しています。再配布するときも削除しないでください。