瀏覽全部文件

將 Claude 連接到 Narwhal MCP

使用 Bearer 金鑰將 Claude Code 連接到 Narwhal 的遠端 MCP 端點,並了解目前自訂連接器的限制。

Claude Code 支援遠端 HTTP MCP 伺服器,並可傳送靜態 Bearer 標頭。以下命令會將權杖保留在環境變數中,讓 Claude 寫入本機伺服器設定。

Claude Code

執行此指令,保留變數預留位置外的引號,讓 Claude Code 能在連線時解析該變數:

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

此命令會設定託管的 Streamable HTTP 端點: https://api.narwhalapi.com/mcp。在執行 Claude Code 的環境中設定 NARWHAL_API_KEY,並妥善保管金鑰。

Claude 網頁版與桌面版連接器

Claude 的自訂遠端連接器流程接受伺服器 URL,並提供選用的 OAuth 設定。Narwhal 目前使用 Bearer API 金鑰驗證,且未發布 OAuth 流程,因此只加入 URL 無法驗證 Narwhal 連線。

使用上方指令執行 Claude Code,或使用 Cursor、VS Code 等能提供下列標頭的用戶端: Authorization 標頭。

Anthropic 的遠端連接器請求來自 Anthropic 的雲端基礎架構,因此端點必須可公開存取。請參閱 Claude MCP 文件 ,了解目前用戶端行為。

驗證連線

開啟用戶端的 MCP 伺服器清單,確認 narwhal 已連線。 如需命令列檢查,請執行 claude mcp get narwhal。

接著請用戶端列出可用的 Narwhal 工具。工具探索不會消耗資料配額;每次成功的 tools/call 消耗一次請求。

使用 主要 MCP 指南 ,查看公開工具清單、參數、回應格式與配額規則。