將 VS Code 連接到 Narwhal MCP

為 Narwhal 設定 Visual Studio Code 的遠端 MCP 伺服器項目，並使用安全的 Bearer 權杖預留位置。

Visual Studio Code 支援遠端 HTTP MCP 伺服器，設定檔為 .vscode/mcp.json。使用輸入變數安全地要求 API 金鑰，而不是將其儲存在工作區檔案中。

設定 VS Code

開啟 MCP: Open Workspace Folder MCP Configuration ；請從命令選擇區執行此命令，然後加入：

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}

當 VS Code 提示你提供 NARWHAL_API_KEY，透過輸入提示輸入金鑰。檔案本身不要保留憑證。請參閱 VS Code MCP 伺服器指南，了解目前用戶端行為。

驗證連線

開啟用戶端的 MCP 伺服器清單，確認 narwhal 已連線。在命令選擇區執行 MCP: List Servers。

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

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

保持金鑰私密

請透過 Cursor 或 VS Code 的安全變數／輸入儲存功能提供預留位置所需的值。請勿將實際使用的金鑰寫入並提交至 mcp.json，也不要將它貼到提示、放入 URL 或暴露在瀏覽器程式碼中。

每個請求都需要 Authorization: Bearer 標頭。請參閱身分驗證指南以了解金鑰儲存與輪替方式。