浏览全部文档

为 Claude Code 接入 Claude Code 经济数据

Claude Code 可以通过一个托管的 MCP 连接请求 Narwhal 数据，每次成功的工具调用计为一次请求。添加 Bearer 密钥后，即可让终端智能体连接经济指标、货币汇率和其他实时工具组。网页版或桌面版客户端请参阅单独的 Claude 应用说明。

快速开始

  1. 从 https://narwhalapi.com/signup 获取免费密钥，并将其导出为 NARWHAL_API_KEY。
  2. 运行添加命令，使用 --scope user、HTTP 传输和 Authorization 标头，即可在所有项目中访问。
  3. 用 claude mcp list、claude mcp get narwhal 或会话内的 /mcp 检查连接。

MCP 配置

添加命令使用 --scope user 为所有项目注册 HTTP 端点和 Bearer 标头。使用 --scope project 时，Claude Code 会写入共享的 .mcp.json 条目，该条目必须包含 "type": "http"；只有 URL 而没有类型的条目会被跳过。

终端
claude mcp add --scope user --transport http narwhal https://api.narwhalapi.com/mcp \ --header 'Authorization: Bearer ${NARWHAL_API_KEY}'
.mcp.json
{
  "mcpServers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NARWHAL_API_KEY}"
      }
    }
  }
}

Claude Code 会展开标头中的 ${NARWHAL_API_KEY}，因此连接之前请把实际密钥放在环境变量中。来自共享 .mcp.json 的服务器需要在交互式会话中批准。

可用工具

Claude Code 通过同一个连接即可使用所有只读工具组。初始化和工具发现免费；每次成功的工具调用计为一次调用，从与 REST 共用的额度中扣费。

分组可查询的内容工具
经济指标可按国家查询 CPI、通货膨胀、失业率、劳动力参与率、GDP、GDP 增长和贸易数据；各指标的覆盖范围不同。economics_get_cpi economics_get_inflation economics_get_unemployment economics_get_labour_force_participation economics_get_gdp economics_get_gdp_growth economics_get_trade economics_get_cpi_history economics_get_inflation_history economics_get_unemployment_history economics_get_labour_force_participation_history economics_get_gdp_history economics_get_gdp_growth_history economics_get_trade_history economics_read_series_observations economics_search_catalogue economics_read_catalogue_series economics_read_catalogue_observations economics_read_catalogue_latest_batch economics_get_policy_rate economics_get_policy_rate_history economics_get_central_bank_reserves economics_get_central_bank_balance_sheet
货币汇率可查询某个货币对的当前汇率、历史汇率、货币换算和汇率 K 线。fx_get_rates fx_get_rate_history fx_convert_currency fx_get_rate_bars
大宗商品价格可查询黄金、白银、铂金、钯金、铜、WTI原油和布伦特原油的现货价格及其价格历史，以及棕榈油实物价格（毛棕榈油和棕榈鲜果串）。commodities_get_spot_price commodities_get_price_history commodities_list_palmoil_physical_series commodities_get_palmoil_physical_price commodities_get_palmoil_physical_observations commodities_list_physical_series commodities_get_physical_series commodities_get_physical_latest commodities_get_physical_observations
发布与事件在准备国家简报之前，可先查询官方经济数据的发布日期和事件详情。economics_list_releases economics_get_release events_list events_get
节假日可按国家查询公共假日、某一天的假日，或下一个假日。calendars_list_holidays calendars_get_holidays_on_date calendars_get_next_holiday
预测市场概率可查询预测市场的主题和事件（含数值型、极值型、时间型和二元结果）、它们的历史数据，以及按决策机构划分的政策路径。predictions_list_topics predictions_get_topic predictions_list_events predictions_get_scalar predictions_get_extreme predictions_get_timing predictions_get_binary predictions_get_scalar_history predictions_get_extreme_history predictions_get_timing_history predictions_get_binary_history predictions_get_policy_path predictions_get_policy_path_history
国债收益率通过同一个 Narwhal 连接，可查询美国、英国、德国、日本、加拿大、瑞典、挪威、澳大利亚和欧元区的政府债券收益率曲线。economics_get_yield_curve economics_get_yield_curve_history

示例提示词

  • 获取美国最新的通胀值。
  • 显示 USD/IDR 汇率的可用历史。
  • 使用当前 GBP/USD 汇率将 GBP 换算为 USD。
  • 查一下美国下一次官方 CPI 的发布日期。
  • 获取可用的棕榈油价格历史。

常见工作流

准备美国经济简报

美国最新的通胀值是多少？向 economics_get_inflation 指定国家，即可获得已公布的百分比变化。

开发时查看汇率

fx_get_rate_history 以 USD 为基础货币，["IDR"] 作为报价货币列表，start_date 设为 2026-09-01，end_date 设为 2026-09-07，获取历史汇率观测值。

查看棕榈油价格历史

用 commodities_list_palmoil_physical_series 选择棕榈油序列。把其序列 ID 传给 commodities_get_palmoil_physical_observations，即可按原生期间获取观测值；如果指定范围，需同时提供起止日期。

查看美国下一次 CPI 发布

会议之前，用美国和最长 366 天的日期窗口调用 economics_list_releases，查找官方 CPI 发布日期。

提示

  • 在添加或连接服务器之前，请确保终端环境对 Claude Code 可用；未设置的变量会发送其字面引用，并产生警告。
  • 在更改配置之前，先用 /mcp 区分 Connected、Needs authentication 和 Failed to connect。
  • 需要在多个项目间使用同一连接时选择 --scope user；配置属于项目时选择 --scope project。
  • 请使用确切的 URL https://api.narwhalapi.com/mcp，因为结尾斜杠引起的重定向会让部分客户端出错。

常见问题

如何让 Claude Code 访问经济数据？

将 Narwhal 添加为带有 Authorization Bearer 标头的 HTTP MCP 服务器。把密钥导出为 NARWHAL_API_KEY，连接服务器，然后请求某个国家的指标或历史序列。

Claude Code 会共用我的 REST 额度吗？

是的，REST 和 MCP 使用同一个账户、API 密钥和额度。每个账户在前 12 个月内每月可获得 10 美元免费额度，短时间窗口限制为每分钟 50 个请求。

我可以把项目配置放入版本控制吗？

可以，分享 .mcp.json 配置，并在标头中使用环境变量引用。不要把实际密钥写入文件、提示词和 URL，然后以交互方式运行 claude 并批准该项目服务器。

故障排查

症状检查
Narwhal 没有出现在服务器列表中检查 .mcp.json 条目中是否有 "type": "http"，然后检查 claude mcp get narwhal 和所选范围。
服务器一直停留在 Pending approval以交互方式运行 claude，并批准来自 .mcp.json 的项目服务器。
连接因 401 invalid_api_key 而失败检查 claude mcp get narwhal，并确认 NARWHAL_API_KEY 已在启动 Claude Code 的 shell 中导出。密钥错误或未启用时，Narwhal 会返回 401 invalid_api_key。
工具调用返回 402 或 429 错误检查代码是 rate_limit_exceeded 还是 insufficient_credits，然后按照错误与额度处理。

此页面对你有帮助吗?