大模型接入金融数据：让 LLM 智能体访问 Narwhal

用 MCP 连接智能体

Narwhal 的 MCP 使用 Streamable HTTP。REST 与 MCP 共用一个账户、一个 API 密钥和一份额度余额，所以 REST 用的密钥同样可以为智能体认证。REST 的基础 URL 是 https://api.narwhalapi.com，MCP 连接则是 https://api.narwhalapi.com/mcp。把端点 URL 交给 MCP 客户端，并在 Authorization 请求头中发送密钥。

1. 保存 API 密钥 在注册页获取免费密钥，并保存在环境变量 NARWHAL_API_KEY 中。端点只接受放在请求头里的密钥，格式为 Authorization: Bearer <key>。
2. 将 Narwhal 添加到 Claude Code 命令中使用 HTTP 传输和 Authorization 请求头。该命令以 narwhal 为名添加服务器，并从 NARWHAL_API_KEY 读取密钥。在 Claude Code 中，可用 claude mcp list 或 /mcp 查看服务器的连接情况。
   添加 MCP 服务器

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

3. 改用项目配置 在项目的 .mcp.json 中，除 URL 和请求头外还要加入 "type": "http"。把 Narwhal 的配置放在 mcpServers 下，服务器名称用 narwhal，headers 条目中放 Authorization 请求头。这是 Claude Code 的项目配置方式；上面的命令是命令行方式。
   项目的 .mcp.json

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

4. 在 Cursor 或 Codex 中设置连接 在 Cursor 中，项目用 .cursor/mcp.json，全局用 ~/.cursor/mcp.json，并设置 url 和 headers。Cursor 会展开请求头中的 ${env:NAME}，所以环境变量名请使用 NARWHAL_API_KEY。在 Codex 中，打开 ~/.codex/config.toml，使用 [mcp_servers.narwhal] 这一节，设置 url = "https://api.narwhalapi.com/mcp" 和 bearer_token_env_var = "NARWHAL_API_KEY"；后一项指定存放密钥的环境变量名。
5. 读取工具列表 用 tools/list 获取可用工具；初始化时服务器自称 Narwhal API。下面的请求发送的 Authorization 请求头与客户端配置中的相同。工具调用的结果是结构化 JSON，错误则包含状态、错误码、详情和请求 ID。
   请求工具列表

   curl -s -X POST https://api.narwhalapi.com/mcp \
     -H "Authorization: Bearer $NARWHAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

经济数据方面，工具列表中有用于 CPI 的 economics_get_cpi、用于通胀的 economics_get_inflation、用于 GDP 增长的 economics_get_gdp_growth 和用于收益率的 economics_get_yield_curve。大宗商品工具包括 commodities_get_spot_price 和 commodities_get_price_history。汇率方面，根据需要的是汇率、货币换算还是汇率历史，选用 fx_get_rates、fx_convert_currency 或 fx_get_rate_history。连接细节请参阅 MCP 指南。

在自己的智能体代码中，可以用 MCP 客户端库连接端点，也可以把 REST 调用当作工具。REST 路径使用相同的 Authorization 请求头和 API 密钥。无论走哪条路径，智能体都能使用 Narwhal 的数据 API 获取假日、经济日历、经济数据、大宗商品现货价格、汇率和预测市场赔率。

无需代码，通过聊天应用连接

Claude 应用为部分组织提供了支持请求头的自定义连接器（测试版）。该连接方式请参阅 Claude 应用的 MCP 页面。这里的关键是对请求头的支持，因为 Narwhal 的端点从 Authorization 请求头接收 API 密钥，聊天应用需要有办法在 MCP 连接中发送该请求头。

ChatGPT 应用连接的是无需登录或使用 OAuth 的服务器，无法使用 Narwhal 的 API 密钥请求头连接。如果你想在 ChatGPT 中询问数据问题，可用的方案请参阅 Narwhal 的 AI 智能体页面。

该选哪种连接

智能体会消耗我的额度吗？

会。每次成功的 tools/call 在与 REST 相同的密钥上计为 1 次调用，价格与对应的 REST 调用相同。初始化和 tools/list 免费。智能体的数据调用和你的 REST 调用共用同一份额度。读取工具列表与向工具请求数据是两回事，所以可以在不消耗数据请求的情况下列出可用工具。

智能体能修改数据吗？

不能。Narwhal 的 MCP 工具都是只读的。智能体可用 calendars_list_holidays 或 calendars_get_next_holiday 读取假日，用 economics_list_releases 读取发布日期。工具列表中还有用于预测市场数据的 predictions_list_topics、predictions_get_policy_path 和 events_list。

如果智能体无法连接怎么办？

请使用末尾不带斜杠的 URL，以及格式为 Authorization: Bearer <key> 的请求头。URL 应为 https://api.narwhalapi.com/mcp，请求头中应放 NARWHAL_API_KEY 里的密钥。在 Claude Code 中，claude mcp list 可显示服务器是否已连接，也可以用 /mcp。密钥错误会返回 401 invalid_api_key，该错误的响应包含状态、错误码以及详情和请求 ID。

实例：询问美国 CPI 的下一个发布日期

截至 2026 年 10 月 24 日，美国 CPI 的下一次发布是 2026 年 11 月 10 日 13:30 UTC。把服务器添加到 Claude Code 后，提问 "美国 CPI 的下一次发布是什么时候？"，智能体会针对美国调用 economics_list_releases，并回答发布日期和时间。

先从有关发布日期的问题开始。Claude Code 针对美国使用 economics_list_releases 获取日历答案，在这个 2026 年 10 月 24 日的例子中是 2026 年 11 月 10 日 13:30 UTC。该工具调用使用 1 次请求。如果你关心的是 CPI 的数值，则要用另一个专门的工具 economics_get_cpi；发布日期来自发布日历。