すべてのドキュメントを閲覧

GitHub Copilot MCPで経済データを使う

GitHub CopilotはVS CodeまたはCopilot CLIのMCP経由でNarwhalを呼び出せます。ツールは読み取り専用で、クレジットはRESTとMCPで共有されます。VS Codeはキーの入力を求めて安全に保存できます。Copilot CLIは設定ファイルにキーを書き込むため、そのファイルは非公開にしてください。

クイックスタート

  1. https://narwhalapi.com/signup から無料のNarwhalキーを取得し、プロンプトやURLには含めないでください。
  2. Business または Enterprise では、接続する前に、管理者が Copilot のポリシーで MCP サーバーを有効にしてください。
  3. VS Code ではバージョン 1.99 以降を使い、サーバー設定を .vscode/mcp.json に追加します。
  4. MCP: List Servers から Narwhal を起動し、パスワードの入力プロンプトにキーを入力します。
  5. Copilot CLI では、別の add コマンドを使い、/mcp show narwhal でエントリを確認します。

MCPの設定

VS Code の設定では、servers オブジェクトの HTTP エントリと、ヘッダー用のパスワード入力を使います。別の CLI コマンドは、同じホスト型エンドポイントを Copilot CLI に登録します。

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}
Copilot CLI
copilot mcp add --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

VS Code は、サーバーが最初に起動するときにキーの入力を求め、安全に保存します。CLI はキーを ~/.copilot/mcp-config.json に書き込むので、このファイルは非公開に保ち、バージョン管理に含めないでください。

利用できるツール

GitHub Copilotは、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 のレート履歴を表示します。
  • 取得できるパーム油の価格履歴を教えて。
  • 英国の次の祝日を調べます。
  • 米国の最新の GDP 成長率を取得します。

よく使うワークフロー

ドイツの最新の GDP 観測値を確認する

ドイツの最新の GDP 観測値は、ドイツを指定して economics ツールの economics_get_gdp を呼び出すと取得できます。

通貨ペアのレートを確認する

GBP/USD の履歴は fx_get_rate_history で取得します。基準通貨に GBP、相手通貨のリストに ["USD"] を指定し、start_date を 2026-09-08、end_date を 2026-09-14 に設定します。

Copilot でパーム油のデータを確認する

どのフレッシュフルーツバンチの系列が必要ですか? commodities_list_palmoil_physical_series で1つ選び、その系列 ID を commodities_get_palmoil_physical_observations に渡すと、ネイティブ期間ごとの価格が得られます。

英国の祝日に合わせて計画する

calendars_get_next_holiday に英国と開始日を渡すと、その日以降で最初に公表されている祝日が見つかります。

ヒント

  • VS Code では、"password": true を指定した promptString 型の入力を使い、Authorization ヘッダーで ${input:NARWHAL_API_KEY} として参照します。
  • コマンドパレットから MCP: List Servers を開くと、Narwhal の起動、停止、再起動と出力の確認ができます。
  • セッション外で登録済みのサーバーを確認したいときは、copilot mcp get narwhal で CLI のエントリを確認します。
  • Business と Enterprise の MCP ポリシーは既定でオフです。Copilot Free、Pro、Pro+、Max には適用されません。

よくある質問

VS Code の GitHub Copilot に Narwhal を追加するには?

HTTP サーバーのエントリ、Narwhal の URL、パスワード入力に連動した Authorization ヘッダーを持つ .vscode/mcp.json を作成します。MCP: List Servers からサーバーを起動し、VS Code が求めたらキーを入力してください。

Copilot CLI は Narwhal のキーをどこに保存しますか?

Copilot CLI は、add コマンドの実行後にキーを ~/.copilot/mcp-config.json に保存します。このファイルは非公開に保ってバージョン管理に含めず、キーをプロンプトや URL に貼り付けないでください。

Copilot で MCP を有効にするには管理者が必要ですか?

Business と Enterprise では、管理者が Copilot のポリシーで MCP サーバーを有効にする必要があります。このポリシーは既定でオフで、Copilot Free、Pro、Pro+、Max には適用されません。

トラブルシューティング

症状確認
Narwhal が VS Code に表示されない.vscode/mcp.json に servers オブジェクトと "type": "http" を持つエントリがあるか確認し、MCP: List Servers を開いてください。
呼び出しが 401 invalid_api_key を返す指定したキーが有効で、Authorization の値に Bearer、空白、キーの順で含まれているか確認してください。
Business または Enterprise アカウントで MCP がブロックされている管理者に Copilot ポリシーで MCP サーバーを確認してもらい、あなたのアカウントで有効にしてもらってください。
CLI のエントリがない、または URL が誤っているcopilot mcp get narwhal で確認し、末尾にスラッシュを付けずに、正確に https://api.narwhalapi.com/mcp を使ってください。

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