讓 LLM 代理程式存取 Narwhal

用 MCP 連接代理程式

Narwhal 的 MCP 使用 Streamable HTTP。REST 與 MCP 共用一個帳戶、一把 API 金鑰和一份額度餘額，所以 REST 用的金鑰同樣可以為代理程式驗證。REST 的基礎 URL 是 https://api.narwhalapi.com，MCP 連線則是 https://api.narwhalapi.com/mcp。把端點 URL 交給 MCP 用戶端，並在 Authorization 標頭中傳送金鑰。

1. 儲存 API 金鑰 在註冊頁取得免費金鑰，並存放在環境變數 NARWHAL_API_KEY 中。端點只接受放在標頭裡的金鑰，格式為 Authorization: Bearer <key>。
2. 將 Narwhal 加入 Claude Code 命令中使用 HTTP 傳輸和 Authorization 標頭。該命令以 narwhal 為名稱加入伺服器，並從 NARWHAL_API_KEY 讀取金鑰。在 Claude Code 中，可用 claude mcp list 或 /mcp 查看伺服器的連線情況。
   加入 MCP 伺服器

   claude mcp add --transport http narwhal https://api.narwhalapi.com/mcp \
     --header "Authorization: Bearer ${NARWHAL_API_KEY}"

3. 改用專案設定 在專案的 .mcp.json 中，除 URL 和標頭外還要加入 "type": "http"。把 Narwhal 的設定放在 mcpServers 下，伺服器名稱用 narwhal，headers 項目中放 Authorization 標頭。這是 Claude Code 的專案設定方式；上面的命令是命令列方式。
   專案的 .mcp.json

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

4. 在 Cursor 或 Codex 中設定連線 在 Cursor 中，專案用 .cursor/mcp.json，全域用 ~/.cursor/mcp.json，並設定 url 和 headers。Cursor 會展開標頭中的 ${env:NAME}，所以環境變數名稱請使用 NARWHAL_API_KEY。在 Codex 中，開啟 ~/.codex/config.toml，使用 [mcp_servers.narwhal] 這一節，設定 url = "https://api.narwhalapi.com/mcp" 和 bearer_token_env_var = "NARWHAL_API_KEY"；後一項指定存放金鑰的環境變數名稱。
5. 讀取工具清單 用 tools/list 取得可用工具；初始化時伺服器自稱 Narwhal API。下面的請求傳送的 Authorization 標頭與用戶端設定中的相同。工具呼叫的結果是結構化 JSON，錯誤則包含狀態、錯誤碼、詳情和請求 ID。
   請求工具清單

   curl -s -X POST https://api.narwhalapi.com/mcp \
     -H "Authorization: Bearer $NARWHAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

經濟資料方面，工具清單中有用於 CPI 的 economics_get_cpi、用於通膨的 economics_get_inflation、用於 GDP 成長的 economics_get_gdp_growth 和用於殖利率的 economics_get_yield_curve。大宗商品工具包括 commodities_get_spot_price 和 commodities_get_price_history。匯率方面，依需要的是匯率、貨幣換算還是匯率歷史，選用 fx_get_rates、fx_convert_currency 或 fx_get_rate_history。連線細節請參閱 MCP 指南。

在自己的代理程式程式碼中，可以用 MCP 用戶端函式庫連接端點，也可以把 REST 呼叫當作工具。REST 路徑使用相同的 Authorization 標頭和 API 金鑰。無論走哪條路徑，代理程式都能使用 Narwhal 的資料 API 取得假日、經濟日曆、經濟資料、大宗商品現貨價格、匯率和預測市場賠率。

無需程式碼，透過聊天應用程式連線

Claude 應用程式為部分組織提供了支援標頭的自訂連接器（測試版）。該連線方式請參閱 Claude 應用程式的 MCP 頁面。這裡的關鍵是對標頭的支援，因為 Narwhal 的端點從 Authorization 標頭接收 API 金鑰，聊天應用程式需要有辦法在 MCP 連線中傳送該標頭。

ChatGPT 應用程式連接的是無需登入或使用 OAuth 的伺服器，無法使用 Narwhal 的 API 金鑰標頭連線。如果你想在 ChatGPT 中詢問資料問題，可用的方案請參閱 Narwhal 的 AI 代理程式頁面。

該選哪種連線

代理程式會消耗我的額度嗎？

會。每次成功的 tools/call 在與 REST 相同的金鑰上計為 1 次呼叫，價格與對應的 REST 呼叫相同。初始化和 tools/list 免費。代理程式的資料呼叫和你的 REST 呼叫共用同一份額度。讀取工具清單與向工具請求資料是兩回事，所以可以在不消耗資料請求的情況下列出可用工具。

代理程式能修改資料嗎？

不能。Narwhal 的 MCP 工具都是唯讀的。代理程式可用 calendars_list_holidays 或 calendars_get_next_holiday 讀取假日，用 economics_list_releases 讀取發布日期。工具清單中還有用於預測市場資料的 predictions_list_topics、predictions_get_policy_path 和 events_list。

如果代理程式無法連線怎麼辦？

請使用結尾不帶斜線的 URL，以及格式為 Authorization: Bearer <key> 的標頭。URL 應為 https://api.narwhalapi.com/mcp，標頭中應放 NARWHAL_API_KEY 裡的金鑰。在 Claude Code 中，claude mcp list 可顯示伺服器是否已連線，也可以用 /mcp。金鑰錯誤會回傳 401 invalid_api_key，該錯誤的回應包含狀態、錯誤碼以及詳情和請求 ID。

實例：詢問美國 CPI 的下一個發布日期

截至 2026 年 10 月 24 日，美國 CPI 的下一次發布是 2026 年 11 月 10 日 13:30 UTC。把伺服器加入 Claude Code 後，提問 "美國 CPI 的下一次發布是什麼時候？"，代理程式會針對美國呼叫 economics_list_releases，並回答發布日期和時間。

先從有關發布日期的問題開始。Claude Code 針對美國使用 economics_list_releases 取得日曆答案，在這個 2026 年 10 月 24 日的例子中是 2026 年 11 月 10 日 13:30 UTC。該工具呼叫使用 1 次請求。如果你關心的是 CPI 的數值，則要用另一個專門的工具 economics_get_cpi；發布日期來自發布日曆。