瀏覽全部文件

Claude app MCP:連接 Claude 應用程式到 Narwhal

當您的組織已取得「Request headers」(僅開放部分組織的 Beta 功能)時,Claude 應用程式即可連接到 Narwhal。請選擇「No sign-in」,並將 API 金鑰加入授權標頭。如果「Add custom connector」對話框中沒有「Request headers」,請改用 Claude Code,因為 Narwhal 的 MCP 不提供 OAuth 登入。

快速開始

  1. 請至 https://narwhalapi.com/signup 取得免費的 Narwhal 金鑰,並避免把金鑰放進提示詞與網址中。
  2. 在「Claude web」或「Desktop」中,依序開啟「Customize」、「Connectors」與「Add custom connector」。
  3. 輸入完整正確的 MCP 網址,選擇「No sign-in」,然後找到「Request headers」。
  4. 新增 authorization,值為 Bearer YOUR_KEY,其中須包含 Bearer 一字與一個空格,然後儲存。
  5. 在對話中點選加號按鈕,並於「Connectors」下開啟 Narwhal。

MCP 設定

連接器需要 HTTPS 伺服器網址、「No sign-in」驗證方式,以及一個 authorization 請求標頭。Claude 會原封不動送出您輸入的標頭值,不會自動加上前綴,因此請在金鑰前加上 Bearer 與一個空格。

「Add custom connector」
MCP 伺服器網址:https://api.narwhalapi.com/mcp 驗證:無需登入 請求標頭:authorization 標頭值:Bearer YOUR_NARWHAL_API_KEY 必填:是

Claude 會安全地儲存標頭值,儲存後不會再次顯示。驗證設定之後無法編輯,若需要變更,請移除連接器後重新新增。

可用的工具

啟用連接器後,Claude 應用程式透過一個連線即可使用所有唯讀工具組。初始化和探索免費,每次成功呼叫計為一次呼叫,從與 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

提示詞範例

  • 請幫我查詢加拿大最新的 CPI 數值。
  • 請顯示目前 GBP/USD 的匯率。
  • 請取得現有的棕櫚油價格歷史資料。
  • 請幫我找出美國下一次官方公布 CPI 的日期。
  • 請列出日本今年的國定假日。

常見工作流程

準備加拿大 CPI 簡報

加拿大的 CPI 來自 economics_get_cpi,並選擇加拿大作為國家。它會回傳最新的整體指數值及其指數基期。

在對話中查詢貨幣對

使用 fx_convert_currency 將您的 GBP 金額換算為 USD,只要提供金額與兩種貨幣,即可依目前的參考匯率進行換算。

與 Claude 一起檢視棕櫚油觀測資料

取得棕櫚油價格歷史資料。先用 commodities_list_palmoil_physical_series 找出數列,再將其數列 ID 傳給 commodities_get_palmoil_physical_observations,即可依原始期別取得觀測資料。

依下一次 CPI 公布時間安排規劃

美國下一次公布 CPI 是什麼時候?請以美國為條件,搭配最長 366 天的日期區間,使用 economics_list_releases 查出預定日期。

使用提示

  • 在「Team」與「Enterprise」方案中,由「Owner」在「Organization settings」的「Connectors」下,選擇「Add」再選「Custom」來新增連接器;成員接著用自己的帳號連線。
  • 「Free」方案可新增一個自訂連接器,但您仍須能使用「Request headers」,才能完成 Narwhal 的驗證。
  • 請使用標準的標頭名稱 authorization;Anthropic 會審核自訂標頭名稱,且最多允許四個標頭。
  • 請求來自 Anthropic 的雲端,因此伺服器網址必須是公開的 HTTPS;Narwhal 的代管端點符合這項要求。

常見問題

要如何把我的 Narwhal API 金鑰提供給 Claude 應用程式?

請選擇「No sign-in」,並在「Request headers」下新增 authorization,值為 Bearer YOUR_KEY。Claude 會原封不動送出該值,因此金鑰前要有 Bearer 一字與一個空格。

為什麼我的 Claude 連接器對話框中沒有「Request headers」?

您的組織尚未取得該 Beta 功能的使用權限。請改用 Claude Code 搭配 Bearer 金鑰;Narwhal 的 MCP 沒有可供替代選擇的 OAuth 登入。

已儲存的驗證設定可以在 Claude 中變更嗎?

不行,驗證設定儲存後就無法變更,請移除連接器後重新新增。Claude 會安全地儲存標頭值,且不會再次顯示已儲存的值。

故障排查

症狀檢查
對話中沒有出現 Narwhal請在該對話中點開加號按鈕,選擇「Connectors」並開啟 Narwhal。若使用「Team」或「Enterprise」,請確認已有「Owner」新增該連接器。
連接器回傳 401 invalid_api_key請確認金鑰仍有效,且標頭值包含 Bearer 與一個空格。若要變更已儲存的驗證設定,請重新建立連接器。
對話框中沒有「Request headers」區塊您的組織尚未取得此 Beta 功能的使用權限。請改用 Claude Code,以同一把 Narwhal 金鑰連線。
連接器無法連到伺服器請完全照 https://api.narwhalapi.com/mcp 輸入,結尾不要加斜線;此網址必須能從 Anthropic 的雲端連線。

此頁面對你有幫助嗎?