将 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 指南 ,查看公共工具列表、参数、响应形式和配额规则。
文档