リモートMCP接続ガイド

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

利用可能なツール

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

セットアップ

Developersページで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時間有効）

トラブルシューティング

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以上が必要です。

429 Rate limit exceeded

レート制限に達しました。Beta（無料）プランは1日1,000リクエストまでです。ダッシュボードで使用状況を確認できます。