瀏覽全部文件

讓 Claude Code MCP 直接取得經濟數據

Claude Code 可透過一個託管的 MCP 連線請求 Narwhal 資料，每次成功的工具呼叫計為一次請求。加入 Bearer 金鑰後，終端機代理即可連接經濟指標、貨幣匯率與其他即時工具群組。若使用網頁版或桌面版用戶端，請參閱另外的 Claude 應用程式說明。

快速開始

  1. 從 https://narwhalapi.com/signup 取得免費金鑰，並匯出為 NARWHAL_API_KEY。
  2. 使用 --scope user、HTTP 傳輸與 Authorization 標頭執行新增指令，即可在所有專案中存取。
  3. 以 claude mcp list、claude mcp get narwhal，或在工作階段中使用 /mcp 檢查連線。

MCP 設定

此新增指令以 --scope user 為所有專案註冊 HTTP 端點與 Bearer 標頭。使用 --scope project 時，Claude Code 會寫入共用的 .mcp.json 項目，其中必須包含 "type": "http"；只有網址而沒有 type 的項目會被略過。

終端
claude mcp add --scope user --transport http narwhal https://api.narwhalapi.com/mcp \ --header 'Authorization: Bearer ${NARWHAL_API_KEY}'
.mcp.json
{
  "mcpServers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NARWHAL_API_KEY}"
      }
    }
  }
}

Claude Code 會在標頭中展開 ${NARWHAL_API_KEY}，因此連線前請先把實際金鑰放在環境變數中。來自共用 .mcp.json 的伺服器需要在互動式工作階段中核准。

可用的工具

Claude Code 透過同一個連線即可使用所有唯讀工具組。初始化和工具探索免費；每次成功的工具呼叫計為一次呼叫，從與 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

提示詞範例

  • 取得美國最新的通膨值。
  • 顯示 USD/IDR 匯率的可用歷史資料。
  • 依目前的 GBP/USD 匯率將 GBP 換算成 USD。
  • 請幫我找出美國下一次官方公布 CPI 的日期。
  • 請取得現有的棕櫚油價格歷史資料。

常見工作流程

準備美國經濟簡報

美國最新的通膨值是多少？向 economics_get_inflation 指定國家，即可取得回報的百分比變動。

開發時查看匯率

fx_get_rate_history 以 USD 作為基準貨幣，["IDR"] 作為報價貨幣清單，並將 start_date 設為 2026-09-01、end_date 設為 2026-09-07，即可取得歷史匯率觀測值。

檢視棕櫚油價格歷史

以 commodities_list_palmoil_physical_series 選擇棕櫚油數列。將其數列 ID 傳給 commodities_get_palmoil_physical_observations，即可依原生期間取得觀測值；若指定範圍，須同時提供起訖日期。

查看下一次美國 CPI 公布

開會前，以美國和最長 366 天的日期區間呼叫 economics_list_releases，即可找出官方 CPI 公布日期。

使用提示

  • 在新增或連接伺服器前，請讓終端機環境對 Claude Code 保持可用；未設定的變數會送出原始參照文字，並產生警告。
  • 先用 /mcp 區分 Connected、Needs authentication 與 Failed to connect，再變更你的設定。
  • 若要在所有專案共用同一個連線，請選擇 --scope user；若設定屬於該專案，請選擇 --scope project。
  • 請使用確切的網址 https://api.narwhalapi.com/mcp，因為結尾斜線造成的重新導向會讓部分用戶端無法運作。

常見問題

如何讓 Claude Code 存取經濟資料？

以 Authorization Bearer 標頭將 Narwhal 新增為 HTTP MCP 伺服器。將你的金鑰匯出為 NARWHAL_API_KEY，連接伺服器後即可查詢國家指標或歷史數列。

Claude Code 會共用我的 REST 額度嗎？

可以，REST 與 MCP 使用同一個帳戶、API 金鑰與額度。每個帳戶在前 12 個月內，每月都有 $10 的免費額度，短時間限制為每分鐘 50 次請求。

我可以把專案設定放進版本控制嗎？

可以，請共用 .mcp.json 設定，並在標頭中使用環境變數參照。請讓實際金鑰不出現在檔案、提示詞與網址中，然後以互動方式執行 claude 並核准專案伺服器。

故障排查

症狀檢查
Narwhal 沒有出現在伺服器清單中檢查 .mcp.json 項目中是否有 "type": "http"，然後檢查 claude mcp get narwhal 與所選範圍。
伺服器停在等待核准以互動方式執行 claude，並核准 .mcp.json 中的專案伺服器。
連線失敗並出現 401 invalid_api_key檢查 claude mcp get narwhal，並確認 NARWHAL_API_KEY 已在啟動 Claude Code 的 shell 中匯出。金鑰錯誤或未啟用時，Narwhal 會回傳 401 invalid_api_key。
工具呼叫回傳 402 或 429 錯誤檢查代碼是 rate_limit_exceeded 還是 insufficient_credits，然後按照錯誤與額度處理。

此頁面對你有幫助嗎?