現在β版として公開中 — Pro相当のAPI/MCPを無料でご利用いただけます APIキーを取得

リモートMCP接続ガイド

EDINET DBはMCP(Model Context Protocol)のStreamable HTTPトランスポートに対応しています。 Claude、Cursor、ChatGPT等のAIアシスタントから、日本の上場企業3,848社の財務データに直接アクセスできます。

利用可能なツール

ツール名 説明
get_company企業の基本情報・最新財務・財務健全性スコアを取得
get_financials最大6年分の財務時系列データを取得
get_analysisAI分析(財務健全性スコア、投資適性、業界ベンチマーク)を取得
search_companies企業名・証券コード・業種・財務健全性スコアで検索
search_companies_batch複数企業を一括検索(比較分析に便利)
get_rankingROE・配当利回り等の財務指標ランキングを取得

セットアップ

Claude.aiとChatGPTはGoogleアカウント認証だけで使えます(APIキー不要)。その他のクライアントはダッシュボードでAPIキーを発行してください。

Claude.ai

APIキー不要。Googleアカウントで認証するだけで接続できます。

接続手順を見る

ChatGPT

APIキー不要。Googleアカウントで認証するだけで接続できます。

接続手順を見る

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 ヘッダーを設定してください。

接続はできるがツール呼び出しでエラーになる

initializetools/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リクエストまでです。ダッシュボードで使用状況を確認できます。