リモートMCP接続ガイド
EDINET DBはMCP(Model Context Protocol)のStreamable HTTPトランスポートに対応しています。 Claude、Cursor、ChatGPT等のAIアシスタントから、日本の上場企業3,848社の財務データに直接アクセスできます。
利用可能なツール
| ツール名 | 説明 |
|---|---|
| get_company | 企業の基本情報・最新財務・財務健全性スコアを取得 |
| get_financials | 最大6年分の財務時系列データを取得 |
| get_analysis | AI分析(財務健全性スコア、投資適性、業界ベンチマーク)を取得 |
| search_companies | 企業名・証券コード・業種・財務健全性スコアで検索 |
| search_companies_batch | 複数企業を一括検索(比較分析に便利) |
| get_ranking | ROE・配当利回り等の財務指標ランキングを取得 |
セットアップ
Claude.aiとChatGPTはGoogleアカウント認証だけで使えます(APIキー不要)。その他のクライアントはダッシュボードでAPIキーを発行してください。
Claude Code(CLI)
ターミナルから1コマンドで追加:
claude mcp add edinetdb \
--transport http \
--url https://edinetdb.jp/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
または .claude/settings.local.json に直接記述:
{
"mcpServers": {
"edinetdb": {
"type": "http",
"url": "https://edinetdb.jp/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Claude Desktop
mcp-remote パッケージ経由で接続(Node.js 18+が必要):
{
"mcpServers": {
"edinetdb": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://edinetdb.jp/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor
.cursor/mcp.json(プロジェクト)または ~/.cursor/mcp.json(グローバル)に追加:
{
"mcpServers": {
"edinetdb": {
"url": "https://edinetdb.jp/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
その他(curl / 直接接続)
標準的なMCP Streamable HTTPリクエスト:
# 1. Initialize
curl -X POST https://edinetdb.jp/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-03-26",
"capabilities":{},
"clientInfo":{"name":"my-app","version":"1.0"}}}'
# 2. Search companies (要APIキー)
curl -X POST https://edinetdb.jp/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"search_companies",
"arguments":{"query":"トヨタ"}}}'
使用例
企業分析
"トヨタ自動車の直近5年間の売上推移と収益性を分析して"
業界比較
"情報・通信業のROEトップ10を取得して、業界の特徴を教えて"
スクリーニング
"ROE15%以上、PBR1倍以下の割安高収益企業を探して"
技術仕様
| エンドポイント | https://edinetdb.jp/mcp |
| プロトコル | MCP Streamable HTTP(JSON-RPC 2.0) |
| プロトコルバージョン | 2025-03-26 |
| 認証方式 |
Authorization: Bearer API_KEY(推奨)X-API-Key: API_KEY?key=API_KEY(クエリパラメータ)
|
| 認証が必要 | tools/call のみ |
| 認証不要 | initialize, tools/list, ping |
| レスポンス形式 |
JSON(Accept: application/json)SSE( Accept: text/event-stream)
|
| セッション管理 | Mcp-Session-Id ヘッダー(自動発行、1時間有効) |
APIキーの仕組みと制限
取得方法は2種類
| 方法 | 対象 | 上限 |
|---|---|---|
| MCP接続(OAuth認証) | Claude.ai、ChatGPT等 | クライアントごとに1つ |
| ダッシュボードで手動発行 | REST API、Claude Code、Cursor等 | 最大3つ |
MCP接続(Claude.ai / ChatGPT)
- Googleアカウントで認証するだけでAPIキーが自動発行されます
- 再接続しても古いキーは自動で置き換わります。手動の管理は不要です
- ClaudeとChatGPTなど複数のAIクライアントを同時に接続できます。それぞれ独立して管理されます
- ダッシュボードには各クライアントの最新キーのみが「MCP (Claude)」「MCP (ChatGPT)」のように表示されます
ダッシュボードでの手動発行
- REST APIやClaude Code等、手動設定が必要なクライアント向けです
- 1アカウントにつき最大3つまで有効にできます
- 不要なキーを無効化すれば、新しいキーを発行できます
- キーは発行時に一度だけ表示されます。紛失した場合は無効化して再発行してください
レート制限
| プラン | 日次上限 | 月次上限 | 料金 |
|---|---|---|---|
| Beta | 1,000回/日 | 30,000回/月 | 無料 |
| Free | 100回/日 | 3,000回/月 | 無料 |
| Pro / Business | 1,000〜10,000回/日 | 30,000〜100,000回/月 | 準備中 |
レート制限はアカウント単位です。複数のキーを使い分けても、同じアカウントのリクエストは合算されます。現在はBetaプラン(Pro相当)を全員に無料で提供しています。
トラブルシューティング
401 API key required
APIキーが未設定です。Developersページでキーを発行し、Authorization: Bearer YOUR_KEY ヘッダーを設定してください。
接続はできるがツール呼び出しでエラーになる
initialize と tools/list は認証不要ですが、tools/call(実際のデータ取得)にはAPIキーが必要です。
SSE接続エラー / 405 Method Not Allowed
GET SSEは非対応です(サーバー起点の通知が不要なため)。Streamable HTTP(POST)で通信してください。mcp-remoteを使用している場合、このエラーはフォールバック試行のログで、接続自体は成功しています。
Claude Desktopで接続できない
Claude Desktopはまだネイティブの HTTP MCP接続に非対応です。上記の mcp-remote パッケージ経由の設定を使用してください。Node.js 18以上が必要です。
Claude Desktopが起動しなくなった
設定ファイル(claude_desktop_config.json)のJSON構文エラーが原因の可能性があります。末尾カンマ、引用符の不一致、不正なエスケープ文字などを確認してください。問題が解消しない場合は、MCP設定部分を一度削除してClaude Desktopが正常に起動することを確認してから、設定を再入力してください。
429 Rate limit exceeded
レート制限に達しました。Beta(無料)プランは1日1,000リクエストまでです。ダッシュボードで使用状況を確認できます。