Claude app MCP:連接 Claude 應用程式到 Narwhal
當您的組織已取得「Request headers」(僅開放部分組織的 Beta 功能)時,Claude 應用程式即可連接到 Narwhal。請選擇「No sign-in」,並將 API 金鑰加入授權標頭。如果「Add custom connector」對話框中沒有「Request headers」,請改用 Claude Code,因為 Narwhal 的 MCP 不提供 OAuth 登入。
快速開始
- 請至 https://narwhalapi.com/signup 取得免費的 Narwhal 金鑰,並避免把金鑰放進提示詞與網址中。
- 在「Claude web」或「Desktop」中,依序開啟「Customize」、「Connectors」與「Add custom connector」。
- 輸入完整正確的 MCP 網址,選擇「No sign-in」,然後找到「Request headers」。
- 新增
authorization,值為Bearer YOUR_KEY,其中須包含 Bearer 一字與一個空格,然後儲存。 - 在對話中點選加號按鈕,並於「Connectors」下開啟 Narwhal。
MCP 設定
連接器需要 HTTPS 伺服器網址、「No sign-in」驗證方式,以及一個 authorization 請求標頭。Claude 會原封不動送出您輸入的標頭值,不會自動加上前綴,因此請在金鑰前加上 Bearer 與一個空格。
MCP 伺服器網址:https://api.narwhalapi.com/mcp 驗證:無需登入 請求標頭:authorization 標頭值:Bearer YOUR_NARWHAL_API_KEY 必填:是Claude 會安全地儲存標頭值,儲存後不會再次顯示。驗證設定之後無法編輯,若需要變更,請移除連接器後重新新增。
可用的工具
啟用連接器後,Claude 應用程式透過一個連線即可使用所有唯讀工具組。初始化和探索免費,每次成功呼叫計為一次呼叫,從與 REST 共用的額度中扣費。
| 群組 | 可查詢的內容 | 工具 |
|---|---|---|
| 經濟指標 | 可依國家查詢 CPI、通貨膨脹、失業率、勞動力參與率、GDP、GDP 成長率與貿易資料;各指標的涵蓋範圍不同。 | economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ |
| 貨幣匯率 | 可查詢貨幣對的即時匯率、歷史匯率、貨幣換算與匯率 K 線。 | fx_ fx_ fx_ fx_ |
| 大宗商品價格 | 可查詢黃金、白銀、白金、鈀金、銅、WTI原油與布蘭特原油的現貨價格及歷史價格,以及實體棕櫚油價格(粗棕櫚油與棕櫚鮮果串)。 | commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ |
| 公布時程與事件 | 在規劃國家簡報之前,可先查詢官方經濟資料的公布日期與事件詳情。 | economics_ economics_ events_ events_ |
| 國定假日 | 可依國家查詢國定假日、特定日期的假日,或下一個假日。 | calendars_ calendars_ calendars_ |
| 預測市場機率 | 可查詢預測市場的主題與事件(包含數值、極值、時間與二元結果)、其歷史資料,以及各主管機關的政策路徑。 | predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ |
| 政府公債殖利率 | 透過同一個 Narwhal 連線,可查詢美國、英國、德國、日本、加拿大、瑞典、挪威、澳洲與歐元區的公債殖利率曲線。 | economics_ economics_ |
提示詞範例
- 請幫我查詢加拿大最新的 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 的雲端連線。 |
此頁面對你有幫助嗎?