瀏覽全部文件

在 Codex MCP 中使用經濟數據

Codex 可以透過 MCP 請求 Narwhal 資料，其命令列、IDE 擴充功能和桌面應用共用一份設定。設定 Bearer 權杖環境變數，即可連接經濟指標、匯率和其他即時工具組。REST 和 MCP 使用同一個帳戶額度，每次成功呼叫計一次呼叫。

快速開始

  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] 資料表會寫明託管網址，以及存放金鑰的環境變數。請將 NARWHAL_API_KEY 填入 bearer_token_env_var；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 透過這一個連線即可使用所有唯讀工具組。初始化和探索免費；每次成功的工具呼叫計為一次呼叫，從與 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
貨幣匯率可查詢貨幣對的即時匯率、歷史匯率、貨幣換算與匯率 K 線。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，即可取得預設日間隔的已收盤 K 線。將必填的 start 設為 2026-09-15，end 設為 2026-09-21。

檢視下一次美國 CPI 公布

在會議前，哪一次美國 CPI 公布最接近？向 economics_list_releases 提供國家與最長 366 天的日期區間，即可取得官方行事曆項目。

查看商品價格以供分析

白銀現貨價格來自 commodities_get_spot_price，請求中須指定白銀與報價貨幣。

使用提示

  • 若以 codex mcp add 註冊伺服器，之後需在設定中加入 bearer_token_env_var，因為文件中的新增指令沒有 Bearer 權杖參數。
  • 連線前請先設定 Bearer 變數；否則 Codex 預設會嘗試 OAuth 登入，而 Narwhal 的 MCP 沒有 OAuth 登入。
  • 請勿將金鑰放進提示詞、設定值與網址；設定中只需填入環境變數名稱。
  • 請使用確切的端點 https://api.narwhalapi.com/mcp，結尾不要加斜線，以避免重新導向導致部分用戶端出問題。

常見問題

Codex 能搭配 API 金鑰使用 Narwhal 嗎？

可以，在 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；請確認 NARWHAL_API_KEY 已在啟動 Codex 的 shell 中匯出。
Codex 嘗試開啟 OAuth 登入在伺服器資料表中加入 bearer_token_env_var，並在啟動 Codex 前設定該環境變數。
新增指令已註冊網址，但呼叫失敗開啟 config.toml 並加入 Bearer 變數設定；文件中的新增指令只會註冊網址，不含該憑證設定。

此頁面對你有幫助嗎?