Cursor MCPに経済データを取り込む

Q: Cursor は envFile からキーを読み込めますか?

いいえ、Cursor のリモートサーバーは envFile に対応していません。シェルのプロファイルかシステム環境に変数を設定し、ヘッダーでは ${env:NARWHAL_API_KEY} として参照してください。

CursorはリモートMCPサーバー経由でNarwhalを呼び出せます。APIキーとクレジットはRESTとMCPで共有されます。Cursorを起動する前に環境変数にキーを保存し、作業中に経済データを依頼してください。同じ接続で為替レート、コモディティデータ、その他のライブツールグループも使えます。

クイックスタート

https://narwhalapi.com/signup から無料のキーを取得してください。
Cursor を起動する前に、シェルのプロファイルかシステム環境で NARWHAL_API_KEY を設定してください。
このプロジェクトだけなら .cursor/mcp.json、すべてのプロジェクトで使うなら ~/.cursor/mcp.json にリモートサーバーの設定を追加します。
サイドバーの Customize で Narwhal を有効にし、Available Tools を確認してください。

MCPの設定

リモートエントリでは url と headers を使い、Authorization ヘッダーに ${env:NARWHAL_API_KEY} を指定します。Cursor はこの参照を自身の環境から読み取ります。リモート MCP サーバーは envFile に対応していません。

{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

必要なスコープに応じて、設定はプロジェクトファイルかユーザーファイルに置きます。システムやシェルの環境を変更したあとは、接続前にプロセスがキーを持つよう Cursor を再起動してください。

利用できるツール

Cursorは、1つのNarwhal接続で読み取り専用のすべてのツールグループを利用できます。初期化とツール検出は無料で、ツール呼び出しは成功するたびに1回と数え、RESTと同じクレジットから差し引かれます。

グループ	依頼できる内容	ツール
経済指標	国別に、CPI、インフレ率、失業率、労働力率、GDP、GDP成長率、貿易のデータを依頼できます。対象範囲は指標ごとに異なります。	`economics_get_cpi` `economics_get_inflation` `economics_get_unemployment` `economics_get_labour_force_participation` `economics_get_gdp` `economics_get_gdp_growth` `economics_get_trade` `economics_get_cpi_history` `economics_get_inflation_history` `economics_get_unemployment_history` `economics_get_labour_force_participation_history` `economics_get_gdp_history` `economics_get_gdp_growth_history` `economics_get_trade_history` `economics_read_series_observations` `economics_search_catalogue` `economics_read_catalogue_series` `economics_read_catalogue_observations` `economics_read_catalogue_latest_batch` `economics_get_policy_rate` `economics_get_policy_rate_history` `economics_get_central_bank_reserves` `economics_get_central_bank_balance_sheet`
通貨レート	通貨ペアについて、現在の為替レート、過去のレート、通貨の換算、レートのバーを依頼できます。	`fx_get_rates` `fx_get_rate_history` `fx_convert_currency` `fx_get_rate_bars`
コモディティ価格	金、銀、プラチナ、パラジウム、銅、WTI原油、ブレント原油のスポット価格とその価格履歴、および現物のパーム油価格(粗パーム油と果房)を取得できます。	`commodities_get_spot_price` `commodities_get_price_history` `commodities_list_palmoil_physical_series` `commodities_get_palmoil_physical_price` `commodities_get_palmoil_physical_observations` `commodities_list_physical_series` `commodities_get_physical_series` `commodities_get_physical_latest` `commodities_get_physical_observations`
発表とイベント	国別のブリーフィングを計画する前に、公式の経済指標の発表日とイベントの詳細を依頼できます。	`economics_list_releases` `economics_get_release` `events_list` `events_get`
祝日	国別の祝日、特定の日付の祝日、次の祝日を依頼できます。	`calendars_list_holidays` `calendars_get_holidays_on_date` `calendars_get_next_holiday`
予測市場の確率	スカラー、極値、タイミング、二値の結果を持つ予測市場のトピックとイベント、その履歴、当局別の政策パスを依頼できます。	`predictions_list_topics` `predictions_get_topic` `predictions_list_events` `predictions_get_scalar` `predictions_get_extreme` `predictions_get_timing` `predictions_get_binary` `predictions_get_scalar_history` `predictions_get_extreme_history` `predictions_get_timing_history` `predictions_get_binary_history` `predictions_get_policy_path` `predictions_get_policy_path_history`
国債利回り	米国、英国、ドイツ、日本、カナダ、スウェーデン、ノルウェー、オーストラリア、ユーロ圏の国債利回り曲線を、同じ Narwhal 接続で取得できます。	`economics_get_yield_curve` `economics_get_yield_curve_history`

プロンプト例

カナダの最新の失業率を取得します。
現在のGBP/USDの為替レートを表示して。
取得できるパーム油の価格履歴を教えて。
米国の次回のCPI公式発表日を調べて。
今年の日本の祝日を一覧にして。

よく使うワークフロー

期間別にカナダの失業率をたどる

Cursor に、economics_get_unemployment_history を使ってカナダの失業率の観測値を尋ねます。これは economics グループのツールで、履歴は期間ごとの観測値として返ります。

換算の前にレートを確認する

今の GBP/USD レートで足りますか? GBP を基準通貨、USD を相手通貨にして fx_get_rates を呼び出します。

Cursor でパーム油の履歴を確認する

Cursor に、commodities_list_palmoil_physical_series でパーム油の系列を探し、選んだ系列 ID を commodities_get_palmoil_physical_observations に渡して期間ごとの観測値を読むよう依頼します。

発表日を軸にブリーフィングを計画する

economics_list_releases でブリーフィングを計画します。米国と、366 日以内の期間を指定してください。エントリには予定された発表日と時刻が含まれます。

ヒント

特定の操作を Cursor に使わせたいときはツール名を指定し、そうでなければ必要なデータを説明して Available Tools を確認してください。
共有されるプロジェクトファイルでも、ヘッダーで環境変数の参照を使えば、実際のキーを .cursor/mcp.json に入れずに済みます。
接続エラーの詳細が必要なときは、Cmd+Shift+U で Output パネルを開き、MCP Logs を選びます。
プロジェクトのニーズに応じて、サイドバーの Customize で Narwhal サーバーを有効化、無効化、管理できます。

よくある質問

Cursor を Narwhal MCP に接続するには?

Cursor の MCP 設定に、Narwhal の URL と Authorization Bearer ヘッダーを持つリモートサーバーのエントリを追加します。Cursor を起動する前に NARWHAL_API_KEY を設定し、サーバーを有効にして Available Tools を確認してください。

Cursor は envFile からキーを読み込めますか?

いいえ、Cursor のリモートサーバーは envFile に対応していません。シェルのプロファイルかシステム環境に変数を設定し、ヘッダーでは ${env:NARWHAL_API_KEY} として参照してください。

Cursor での Narwhal の呼び出しにはいくらかかりますか?

ツール呼び出しが成功するたびに1回として数え、ツールの検索は無料です。すべてのアカウントに、最初の12か月間、毎月$10の無料クレジットが付き、短時間の上限は1分あたり50リクエストです。

トラブルシューティング

症状	確認
Narwhal が Available Tools に表示されない	プロジェクトまたはユーザーの `.cursor/mcp.json` を確認し、サイドバーの Customize でサーバーを有効にしてください。
接続が `401 invalid_api_key` を返す	Cursor を起動する環境で `NARWHAL_API_KEY` に有効なキーが入っているか確認し、Cursor を再起動してください。
リモートサーバーが envFile を読み取れない	シェルのプロファイルかシステム環境に変数を移し、Authorization ヘッダーでは `${env:NARWHAL_API_KEY}` を使います。
URL を編集したあとで接続に失敗する	末尾にスラッシュを付けずに、正確に https://api.narwhalapi.com/mcp を使い、そのあと Output パネルの MCP Logs を確認してください。

このページは役に立ちましたか?