浏览全部文档

在 Codex 中使用 Codex 金融数据

Codex 可以通过 MCP 请求 Narwhal 数据，其命令行、IDE 扩展和桌面应用共用一份配置。设置 Bearer 令牌环境变量，即可连接经济指标、汇率和其他实时工具组。REST 和 MCP 使用同一个账户额度，每次成功调用计一次调用。

快速开始

  1. 从 https://narwhalapi.com/signup 获取免费密钥，并将其导出为 NARWHAL_API_KEY。
  2. 为所有项目打开 ~/.codex/config.toml，或为受信任的项目打开其中的 .codex/config.toml。
  3. 添加 Narwhal 服务器表，包含其 URL，并将 bearer_token_env_var 设置为变量名。
  4. 在已导出密钥的环境中启动 Codex，然后查询特定指标或货币汇率。

MCP 配置

[mcp_servers.narwhal] 表指明托管 URL 和保存你密钥的环境变量。把 NARWHAL_API_KEY 放入 bearer_token_env_var；Codex 读取该值并通过 Authorization Bearer 标头发送。

~/.codex/config.toml
[mcp_servers.narwhal]
url = "https://api.narwhalapi.com/mcp"
bearer_token_env_var = "NARWHAL_API_KEY"

共享的用户配置位于 ~/.codex/config.toml，受信任的项目可以有自己的 .codex/config.toml。请把密钥保存在启动 Codex 的进程环境中，文件里只保留变量名。

可用工具

Codex 通过这一个连接即可使用所有只读工具组。初始化和发现免费；每次成功的工具调用计为一次调用，从与 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

示例提示词

  • 获取美国最新的 GDP 增长值。
  • 显示英国可用的通胀历史。
  • 获取当前 USD/IDR 汇率。
  • 查找日本下一个公共假日。
  • 获取当前黄金现货价格。

常见工作流

为澳大利亚简报收集指标

economics_get_cpi_history 按期间获取澳大利亚 CPI，并标明该序列的指数基期。

开发时查看货币对

将 USD 作为基础货币、IDR 作为报价货币传给 fx_get_rate_bars，按默认的日线间隔获取已收盘的 K 线。将必填的 start 设为 2026-09-15，end 设为 2026-09-21。

回顾美国下一次 CPI 发布

哪一次美国 CPI 发布在你的会议之前？向 economics_list_releases 提供国家和最长 366 天的日期窗口，即可获得官方日历条目。

查看大宗商品价格以便分析

白银现货价格来自 commodities_get_spot_price，请求中需指定白银和报价货币。

提示

  • 如果用 codex mcp add 注册服务器，之后请在配置中添加 bearer_token_env_var，因为文档中的添加命令没有 Bearer 令牌参数。
  • 连接之前先设置 Bearer 变量；否则 Codex 默认尝试 OAuth 登录，而 Narwhal 的 MCP 没有 OAuth 登录。
  • 不要把密钥放进提示词、配置值和 URL；配置中只需要环境变量的名称。
  • 请使用确切的端点 https://api.narwhalapi.com/mcp，不带结尾斜杠，以避免让部分客户端出错的重定向。

常见问题

Codex 可以通过 API 密钥使用 Narwhal 吗？

是的，在 Narwhal 服务器表中把 bearer_token_env_var 设为 NARWHAL_API_KEY。在启动 Codex 的环境中导出实际密钥，Codex 就会发送 Authorization Bearer 标头。

Codex CLI 和桌面应用需要分别设置吗？

不需要。CLI、IDE 扩展和桌面应用共用 Codex 配置。用户文件适用于所有项目，而受信任的项目可以使用自己的配置文件。

添加服务器会启动 OAuth 登录吗？

Codex 默认尝试 OAuth，但配置了 Bearer 变量后会发送该令牌。Narwhal 需要该密钥，且 MCP 没有 OAuth 登录，因此连接之前请检查该变量。

故障排查

症状检查
Narwhal 没有出现在 Codex 中检查用户配置中的 [mcp_servers.narwhal]，或确认包含 .codex/config.toml 的项目已受信任。
Narwhal 返回 401 invalid_api_key缺少密钥或密钥错误时，Narwhal 会返回 401 invalid_api_key；请确认 NARWHAL_API_KEY 已在启动 Codex 的 shell 中导出。
Codex 尝试打开 OAuth 登录在服务器表中添加 bearer_token_env_var，并在启动 Codex 之前设置它所指定的环境变量。
添加命令已注册 URL，但调用失败打开 config.toml 并添加 Bearer 变量设置；文档中的添加命令只注册 URL，不包含该凭证设置。

此页面对你有帮助吗?