AI エージェント接続(MCP)
DataSinking は MCP サーバーです。エージェントをここに向ければ、中国・日本・韓国・台湾の決算書全文を平易な 言葉で検索・閲覧できます — コードは不要、6 つのツールだけです。まず 無料のキーを取得 してください。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 は 1 つだけ、インストールするものは何もなく、お使いのマシンに Python も Node も 必要ありません。認証は Bearer ヘッダー、またはヘッダーを設定できないクライアント向けの ?apikey= です。
https://api.datasink.ing/mcp Authorization: Bearer YOUR_KEY # or: https://api.datasink.ing/mcp?apikey=YOUR_KEY
以下に挙げる各クライアントでは、ホスト版が使える場合はその形式を示します。使えない場合は ローカルサーバーに切り替えます — 同じ 6 つのツールを、npx または uvx 経由で自分のマシンで実行でき、こちらも インストールは不要です。
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 を開き、 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 (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 に保管します。 どちらを編集した場合も、アプリを再起動してください。
その他の 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 を呼べば、一連の流れが 動いている証明になります。次に 「トヨタの最新の年次報告書はリスクについて何と言っていますか?」 を試して ください。
接続できないとき
ホスト版エンドポイントは POST のみでステートレスです。接続が失敗する 原因のほとんどはこの 2 点です。クライアントは逆を想定しがちだからです:
| 401 | {"detail":"Missing API key"} — 何も送信されていません。 {"detail":"无效的 API key"} — キーが認識されていません。 |
| 405 | GET が使われました。SSE ストリームはありません — POST のみです。 |
| no tools | クライアントを再起動してください。どのクライアントも起動時に MCP 設定を読み込みます。 |
| blank header | クライアントの起動前に環境変数が設定されていなかったか、そのクライアントに合わない 展開構文を使っています。 |
「クライアントの設定ミス」と「キーが間違っている」を切り分けるには、クライアントを 介さずに試してください:
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 のツール説明では、引用する際にこれを保持するよう モデルに指示しています。再配布するときも削除しないでください。