浏览全部文档

将 Cursor 连接到 Narwhal MCP

为 Narwhal 托管的 Streamable HTTP MCP 服务器配置 Cursor,并使用安全的 Bearer 令牌占位符。

Cursor 支持托管的 HTTP MCP 服务器,配置文件为 .cursor/mcp.json。以下配置使用 Narwhal Bearer 密钥的变量占位符。

配置 Cursor

创建或打开 .cursor/mcp.json (位于项目或用户配置中),然后添加:

.cursor/mcp.json
{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

确保启动 Cursor 的客户端可以访问该变量。保存文件后重启或重新加载 MCP 服务器。请参阅 Cursor MCP 配置指南 ,了解当前客户端行为。

验证连接

打开客户端的 MCP 服务器列表,确认 narwhal 已连接。 如需命令行检查,请运行 agent mcp list。

然后让客户端列出可用的 Narwhal 工具。工具发现不消耗数据配额;每次成功的 tools/call 消耗一次请求。

使用 主 MCP 指南 ,查看公共工具列表、参数、响应形式和配额规则。

妥善保管密钥

请通过 Cursor 或 VS Code 的安全变量/输入存储机制为占位符提供密钥。不要将真实密钥提交到 mcp.json,也不要将其粘贴到提示中、放入 URL 或暴露在浏览器代码中。

每个请求都需要 Authorization: Bearer 请求头。请参阅 身份验证指南 ,了解密钥的存储和轮换。