Claude 桌面版 MCP：连接 Narwhal

Q: 如何把我的 Narwhal API 密钥提供给 Claude 应用？

选择“No sign-in”，在“Request headers”下添加 authorization，值为 Bearer YOUR_KEY。Claude 会原样发送这个值，所以密钥前要写上 Bearer 一词和一个空格。

如果你的组织拥有“Request headers”（一项仅向部分组织开放的 beta 功能），Claude 应用就可以连接 Narwhal。选择“No sign-in”，并把 API 密钥作为 authorization 请求头添加。如果“Add custom connector”对话框中没有“Request headers”，请改用 Claude Code，因为 Narwhal 的 MCP 不提供 OAuth 登录。

快速开始

在 https://narwhalapi.com/signup 获取免费的 Narwhal 密钥，不要把它写进提示词或 URL。
在“Claude web”或“Desktop”中，依次打开“Customize”“Connectors”和“Add custom connector”。
输入准确的 MCP URL，选择“No sign-in”，然后找到“Request headers”。
添加 authorization，值为 Bearer YOUR_KEY，其中要包含 Bearer 一词和一个空格，然后保存。
在对话中点击加号按钮，在“Connectors”下打开 Narwhal。

MCP 配置

连接器需要 HTTPS 服务器 URL、“No sign-in”认证方式和一个 authorization 请求头。Claude 会按你输入的内容原样发送请求头的值，不会自动加前缀，所以密钥前要写上 Bearer 和一个空格。

MCP 服务器 URL：https://api.narwhalapi.com/mcp 认证：No sign-in 请求标头：authorization 标头值：Bearer YOUR_NARWHAL_API_KEY 是否必填：是

Claude 会安全存储请求头的值，保存后不再显示。认证设置之后无法编辑；如需修改，请删除该连接器后重新添加。

可用工具

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

示例提示词

获取加拿大最新的 CPI 数值。
显示当前的 GBP/USD 汇率。
获取可用的棕榈油价格历史。
查一下美国下一次官方 CPI 的发布日期。
列出日本今年的公共假日。

常见工作流

准备一份加拿大 CPI 简报

加拿大 CPI 来自选择了加拿大的 economics_get_cpi，它会返回最新的总体指数值及其基期。

在对话中查看货币对

用 fx_convert_currency 把你的 GBP 金额换算成 USD，提供金额和两种货币，即可按当前参考汇率换算。

与 Claude 一起查看棕榈油观测数据

获取棕榈油价格历史。先用 commodities_list_palmoil_physical_series 找到序列，再把序列 ID 传给 commodities_get_palmoil_physical_observations，即可按原始周期获取观测数据。

围绕下一次 CPI 发布做安排

美国下一次 CPI 在何时发布？用 economics_list_releases，指定美国和最长 366 天的日期范围，即可查到预定日期。

提示

在“Team”和“Enterprise”套餐中，由“Owner”在“Organization settings”“Connectors”“Add”“Custom”下添加连接器，成员随后用自己的账号连接。
Claude 的“Free”套餐可以添加一个自定义连接器，但仍需要有“Request headers”的使用权限才能完成 Narwhal 的认证。
请使用标准的请求头名称 authorization；Anthropic 会审核自定义请求头名称，且最多允许四个请求头。
请求来自 Anthropic 的云端，因此服务器 URL 必须是公网 HTTPS；Narwhal 的托管端点满足这一要求。

常见问题

如何把我的 Narwhal API 密钥提供给 Claude 应用？

选择“No sign-in”，在“Request headers”下添加 authorization，值为 Bearer YOUR_KEY。Claude 会原样发送这个值，所以密钥前要写上 Bearer 一词和一个空格。

为什么我的 Claude 连接器对话框里没有“Request headers”？

你的组织暂时还没有该 beta 功能的使用权限。请改用 Claude Code 搭配 Bearer 密钥；Narwhal 的 MCP 没有可供替代选择的 OAuth 登录。

我可以修改 Claude 中已保存的认证设置吗？

不可以。认证设置保存后无法修改，请删除连接器后重新添加。Claude 会安全存储请求头的值，不会再次显示已保存的值。

故障排查

症状	检查
对话中没有出现 Narwhal	在该对话中点击加号按钮，选择“Connectors”，然后打开 Narwhal。如果使用“Team”或“Enterprise”，请确认“Owner”已添加该连接器。
连接器返回 `401 invalid_api_key`	请确认密钥有效，且请求头的值包含 `Bearer` 和一个空格。要修改已保存的认证设置，需重新创建连接器。
对话框中没有“Request headers”部分	你的组织没有该 beta 功能的使用权限。请使用 Claude Code，以同一个 Narwhal 密钥进行连接。
连接器无法连接到服务器	请严格使用 https://api.narwhalapi.com/mcp，末尾不要加斜杠；该 URL 必须能从 Anthropic 的云端访问。

此页面对你有帮助吗?