将 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 请求头。请参阅身份验证指南，了解密钥的存储和轮换。