MCP 経由で Finnhub を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Finnhub をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Finnhub + Cursor

Finnhub のリアルタイム市場データを AI に渡します。株式、為替、暗号資産の相場、企業プロフィールと主要財務指標、企業ニュースと市場ニュース、アナリストの推奨、決算と IPO のカレンダー、インサイダー取引、SEC 提出書類、市場の開場状況を扱えます。Finnhub の無料プランで動作し、読み取り専用です。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

FINNHUB_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 1 分です。Finnhub の API キーが必要です。無料プランで、ローソク足の価格履歴を除くすべてのツールが使えます。

1. finnhub.io/register で登録します。無料です。
2. finnhub.io/dashboard の Dashboard を開き、表示されている API キーをコピーします。
3. キーだけを FINNHUB_API_KEY に貼り付けます。token= やスペースは付けないでください。コネクターはキーを X-Finnhub-Token ヘッダーで送り、URL には含めません。
4. コネクターをインストールし、取引所 US で finnhub_get_market_status を実行します。米国市場がいま開いているか、どのセッションかがわかります。

読み取れるデータ: 株式、ETF、為替、暗号資産の相場。時価総額と発行済株式数を含む企業プロフィール。52 週高値・安値、ベータ、PER、PBR、EPS、利益率、ROE、配当利回りなどの指標。企業ニュースと市場ニュース（一般、為替、暗号資産、M&A）。同業他社。月ごとのアナリスト推奨。決算サプライズと決算カレンダー。IPO カレンダー。インサイダー取引とインサイダーセンチメント。SEC に提出されたままの財務諸表と SEC 提出書類の一覧。市場の開場状況と休場日。そして為替プロバイダーと暗号資産取引所のシンボル一覧です。

まずシンボルを特定: AI は finnhub_search_symbols で、会社名、シンボル、ISIN、CUSIP からティッカーを特定します。米国のティッカーは AAPL のように接尾辞なし、他の取引所は 7203.T や SAP.DE のように接尾辞が付きます。為替と暗号資産の相場は OANDA:EUR_USD や BINANCE:BTCUSDT のような取引所のシンボルを使い、AI が finnhub_list_forex_symbols または finnhub_list_crypto_symbols で調べます。

数値の読み方: 相場のフィールド名は短く、c は現在値、d は変化額、dp は変化率、h は高値、l は安値、o は始値、pc は前日終値、t は Unix 秒の時刻です。時価総額と発行済株式数は百万単位です。日付は YYYY-MM-DD 形式です。提出された財務諸表は回答が大きいため、AI は finnhub_get_financials_reported を開始日と終了日で絞り込みます。

無料プラン: finnhub_get_stock_candles（価格履歴）を除くすべてのツールが動きます。このツールは有料プランが必要で、無料キーでは 403 を返します。その場合、AI は代わりに finnhub_get_quote と finnhub_get_basic_financials の 52 週の値を使います。無料キーでは一部のデータの期間が短くなります。企業ニュースは 1 年前まで、決算サプライズは直近 4 四半期、決算カレンダーは 1 か月前までと今後の予定です。リアルタイム相場は米国株が対象で、他の市場には有料プランが必要です。

読み取り専用: すべてのツールは読み取りのみです。注文を出すことも資金を動かすこともないため、確認する操作はなく、インストール時にオフになるツールもありません。

制限: 無料プランでは 1 分あたり 60 回、1 秒あたり 30 回まで呼び出せます。429 が返ったら AI は 1 分待ち、広い呼び出しを何度も行うより的を絞った 1 回の呼び出しを優先します。

よくあるエラー: 401 は Finnhub がキーを拒否したことを示します。ダッシュボードからもう一度コピーしてください。403 の "You don't have access to this resource" は、キーは有効でもそのデータがプランに含まれていないことを示します。429 は 1 分あたりの上限に達したことを示します。

投資助言ではありません: 市場データは情報です。何を売買すべきか尋ねられた場合、AI は数値を示し、投資助言ではないことを伝えます。

このコネクターは、売買、注文の発注、証券口座への接続、ポートフォリオの読み取りは行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Finnhub のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「トヨタの株価はいまいくらですか。今日はどれくらい動いていますか。」
• 「ソニー、任天堂、キーエンスの PER、利益率、配当利回りを比較してください。」
• 「来週決算を発表する企業はどこですか。アナリストの EPS 予想も教えてください。」
• 「この 3 か月で、Nvidia のインサイダーは株を買っていますか、売っていますか。」
• 「Tesla の最新ニュースと、ここ数か月のアナリストの推奨をまとめてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続