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

Codex MCPで経済データを活用する

CodexはMCP経由でNarwhalのデータを取得でき、CLI、IDE拡張、デスクトップアプリは1つの設定を共有します。Bearerトークンの環境変数を設定して、経済指標、為替レート、その他のライブグループに接続します。RESTとMCPは同じアカウントのクレジットから差し引かれ、成功した呼び出しごとに1回と数えます。

クイックスタート

  1. https://narwhalapi.com/signup で無料のキーを取得し、NARWHAL_API_KEY としてエクスポートしてください。
  2. すべてのプロジェクトには ~/.codex/config.toml、信頼済みプロジェクトの中では .codex/config.toml を開きます。
  3. Narwhal のサーバーテーブルを追加し、URL と、変数名を指した bearer_token_env_var を設定します。
  4. エクスポートしたキーがある環境から Codex を起動し、特定の指標や為替レートを尋ねてみてください。

MCPの設定

[mcp_servers.narwhal] テーブルには、ホスト型 URL と、キーを保持する環境変数の名前を記載します。bearer_token_env_var に NARWHAL_API_KEY を指定すると、Codex はその値を読み取り、Authorization Bearer ヘッダーで送信します。

~/.codex/config.toml
[mcp_servers.narwhal]
url = "https://api.narwhalapi.com/mcp"
bearer_token_env_var = "NARWHAL_API_KEY"

共有のユーザー設定は ~/.codex/config.toml にあり、信頼済みのプロジェクトは独自の .codex/config.toml を持てます。キーは Codex を起動するプロセスの環境に置き、ファイルには変数名だけを残してください。

利用できるツール

Codexは、この1つの接続で読み取り専用のすべてのツールグループを利用できます。初期化と検出は無料です。ツール呼び出しは成功するたびに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

プロンプト例

  • 米国の最新の GDP 成長率を取得します。
  • 英国のインフレ率の履歴を表示します。
  • 現在の USD/IDR 為替レートを取得します。
  • 日本の次の祝日を調べます。
  • 現在の金のスポット価格を取得します。

よく使うワークフロー

オーストラリア向けブリーフィングの指標を集める

economics_get_cpi_history は、オーストラリアの CPI を期間別に取得し、系列の基準年も示します。

開発中に通貨ペアを確認する

基準通貨に USD、相手通貨に IDR を指定して fx_get_rate_bars に渡すと、既定の日次間隔で確定したバーが得られます。必須の start は 2026-09-15、end は 2026-09-21 に設定します。

次の米国 CPI 発表を確認する

会議の前にどの米国 CPI 発表が来ますか? economics_list_releases に国と最大 366 日の期間を渡すと、公式カレンダーのエントリが得られます。

分析のためにコモディティ価格を確認する

銀のスポット価格は commodities_get_spot_price で取得できます。リクエストでは銀と建値通貨を指定します。

ヒント

  • codex mcp add でサーバーを登録した場合は、ドキュメントにある add コマンドに Bearer トークンのフラグがないため、あとから設定に bearer_token_env_var を追加してください。
  • 接続する前に Bearer 変数を設定してください。設定しないと Codex は既定で OAuth サインインを試みますが、Narwhal には MCP 用の OAuth サインインがありません。
  • キーはプロンプト、設定値、URL に含めないでください。設定に書くのは環境変数の名前だけです。
  • リダイレクトで動作しなくなるクライアントがあるため、末尾にスラッシュを付けず、正確なエンドポイント https://api.narwhalapi.com/mcp を使ってください。

よくある質問

Codex で Narwhal を API キーとともに使えますか?

はい。Narwhal のサーバーテーブルで bearer_token_env_var に NARWHAL_API_KEY を設定します。実際のキーは Codex を起動する環境でエクスポートすると、Codex が Authorization Bearer ヘッダーを送ります。

Codex CLI とデスクトップアプリで、別々の設定が必要ですか?

いいえ、CLI、IDE 拡張、デスクトップアプリは Codex の設定を共有します。ユーザーファイルはすべてのプロジェクトに適用され、信頼済みのプロジェクトは独自の設定ファイルを持てます。

サーバーを追加すると OAuth サインインが始まりますか?

Codex は既定で OAuth を試しますが、Bearer 変数を設定しておくとトークンを送信します。Narwhal はそのキーを必須とし、MCP 用の OAuth サインインはないため、接続する前に変数を確認してください。

トラブルシューティング

症状確認
Narwhal が Codex に表示されないユーザー設定の [mcp_servers.narwhal] を確認するか、.codex/config.toml を含むプロジェクトが信頼済みか確認してください。
Narwhal が 401 invalid_api_key を返すキーがない、または誤っている場合、Narwhal は 401 invalid_api_key を返します。Codex を起動するシェルで NARWHAL_API_KEY がエクスポートされているか確認してください。
Codex が OAuth サインインを開こうとするサーバーテーブルに bearer_token_env_var を追加し、Codex を起動する前に、その名前の環境変数を設定します。
add コマンドは URL を登録したが、呼び出しが失敗するconfig.toml を開いて Bearer 変数の設定を追加します。ドキュメントにある add コマンドは、この認証情報の設定なしで URL だけを登録します。

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