AIREITER

OpenRouter MCP：配置、模型调用与真实取舍

最后更新: 2026-08-25 01:25:39

OpenRouter MCP 是一个托管式 Model Context Protocol 服务器，适合用来查找和测试模型：智能体可以先查看实时价格、基准测试、端点和文档，再决定是否采用某个模型。但在生产环境中，它并不能替代 OpenRouter API。

先说结论：OpenRouter MCP 到底改变了什么

官方服务器地址为 https://mcp.openrouter.ai/mcp。Claude Code、Cursor 或 Claude Desktop 等兼容客户端可以通过远程 HTTP 连接它，让智能体直接在对话中调用 OpenRouter 工具。它的价值在于帮助智能体研究和测试模型目录；真正用于应用或供应商账户的生产任务，仍应交给生产 API 或供应商自有 MCP。

如果你需要……应该使用……原因
按价格、上下文长度、模态、基准测试或供应商寻找当前可用模型OpenRouter MCP它查询实时模型目录和端点数据
让候选模型实际运行一段提示词OpenRouter MCPsend-message 可以测试指定的模型 slug，并返回生成 ID
在自己的产品中上线模型调用OpenRouter API应用可以自行控制密钥、重试、提示词和日志
运营某个供应商专属的服务或账户该供应商的官方 MCP它可以提供 OpenRouter 不拥有的能力
在探索阶段生成图片谨慎使用 OpenRouter MCPgenerate-image 属于推理操作，可能产生费用

OpenRouter 的官方公告介绍了实时模型数据、排名、价格、文档和测试推理能力。关于端点、工具和认证机制，请以 MCP 文档为准。

先设计工作流，再连接服务器

最实用的模式是发现、比较、测试、检查。这样一来，“哪个模型最好”就不再是泛泛而谈的问题，而会变成一个有明确约束条件的选择过程。

  1. 发现：按照任务、价格、上下文长度、模态或供应商要求筛选模型。使用 list-models 和 list-benchmarks 获取当前目录及基准测试数据。
  2. 比较：对每个候选模型调用 list-model-endpoints，查看可用时的供应商级价格、延迟、吞吐量和数据政策信息。
  3. 测试：使用 send-message，以指定模型 slug 运行同一段提示词。这一步可能产生推理费用。
  4. 检查：把每个生成 ID 传给 get-generation，查看 token 数量、成本和实际提供服务的供应商。

你可以在 Claude Code 或 Cursor 中使用下面这段提示词：

Use OpenRouter MCP to find three models for extracting structured data from
legal documents. Requirements: at least 100k context, tool calling, and the
lowest available input price. Compare providers and data policies. Then use
send-message to run this exact prompt against the best two candidates:

"Extract every contract renewal date from the text below. Return only JSON
with an array named renewals, each item containing party, date, and evidence."

After the tests, use get-generation for each generation ID and report the
actual cost and serving provider. Do not call a model until I approve the
candidates.

测试前要明确要求审批：目录查询是只读操作，而 send-message 可能产生推理费用。若要进行可重复的评测，请指定具体模型和供应商；:free、:floor、:nitro 和 :online 等后缀（在可用时）表示路由偏好，并不代表固定的质量保证。

连接官方远程服务器

无需在本地安装任何东西。添加远程端点，完成浏览器 OAuth，然后授权一个与其他密钥分开的专用 OpenRouter 密钥。文档中的默认设置是 7 天有效期和 $10 消费上限，这些选项可以在授权页面修改。OpenRouter 使用带 PKCE 的 OAuth，因此你可以在浏览器中完成授权，不必把普通 API 密钥粘贴到客户端配置里。

Claude Code

运行：

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

第一条命令会注册远程 HTTP 服务器，第二条命令会打开 OAuth 流程。在 Claude Code 会话中，Claude Code MCP 文档也支持使用 /mcp：选择 OpenRouter 服务器并完成认证。

可以先用只读请求测试连接，例如：“使用 OpenRouter MCP，列出两个当前可用且上下文长度至少为 128k 的模型，并显示它们的输入价格。”

Cursor

将远程服务器添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

如果服务器没有出现，请重新加载 Cursor。认证可以从 Cursor 的 MCP 设置启动，也可能在第一次调用工具时启动。官方文档中的 CLI 命令是 cursor-agent；使用下面的命令检查配置是否生效：

cursor-agent mcp list

Cursor 的 MCP 文档介绍了用户级和项目级配置。请根据实际使用范围选择配置层级，不要把包含个人认证信息的配置提交到共享代码仓库。

Claude Desktop 和 Claude Web

如果 Claude 的连接器目录中没有 OpenRouter，OpenRouter 的连接指南建议添加自定义远程连接器：

  1. 打开Settings > Connectors > Customize > Connectors。
  2. 点击+，然后选择Add custom connector。
  3. 将名称设为 OpenRouter MCP。
  4. 在远程 MCP 服务器 URL 中输入 https://mcp.openrouter.ai/mcp。
  5. OAuth 字段留空，添加连接器后打开它，再点击Connect。
  6. 在浏览器中完成 OpenRouter 授权。

部分组织会禁用自定义连接器。如果托管账户中没有这个选项，请联系管理员。Anthropic 的 MCP 文档介绍了客户端侧的协议概念。

哪些操作可以放心交给它

OpenRouter MCP 的大多数官方工具都是实时查询。与其死记完整工具清单，不如按副作用来理解它们。

工具类别示例计费或副作用
目录和基准测试list-models、get-model、list-benchmarks、list-daily-model-rankings只读查询
端点和路由list-model-endpoints、list-providers只读查询
文档和账户search-docs、get-credits、get-generation只读查询
测试推理send-message计费的模型调用
图片探索generate-image计费的生成操作
反馈send-feedback为你的一次生成写入反馈

筛选模型时，要先说清楚决策规则：“寻找支持工具调用、上下文窗口为 64k 且成本最低的模型，然后展示当前最快的可用端点。”官方支持的筛选条件包括价格、最小上下文长度、模型系列、作者、供应商、模态、支持的参数、基准测试范围、工具调用成功率、零数据保留可用性和区域。

如果要进行受控的模型测试，请指定 slug，并让提示词保持可复现：

Use OpenRouter MCP send-message with model "openai/gpt-4o".
Send exactly this user message and do not add a system prompt:

"Return a JSON object with keys title and risks. Analyze this release note:
[paste text here]"

Show me the response and the generation ID. Do not run another model.

这里的 slug 只是示例；实际使用时，请选择 list-models 确认可用的 slug。要让比较结果可审计，应明确要求返回查询工具、查询值和生成 ID，不要直接接受未经验证的模型推荐。

OpenRouter MCP 与供应商官方 MCP 怎么选

OpenRouter MCP 是跨供应商的模型信息与测试层。如果操作属于某个供应商的产品、账户或数据平面，那么该供应商的官方 MCP 通常更合适。

决策因素OpenRouter MCP供应商官方 MCP
模型选择通过一个目录比较多个供应商的模型通常围绕某一家供应商的模型或服务
价格和路由比较跨供应商的价格、端点和回退选项使用供应商自己的账户和路由规则
领域操作仅限 OpenRouter 暴露的工具更适合操作供应商自有的文件、项目、任务或账户
可移植性一个远程端点即可支持多个 MCP 客户端客户端配置方式和供应商覆盖范围因服务而异
凭据边界带有效期和上限的专用 OpenRouter OAuth 密钥供应商专属的 OAuth 或 API 凭据
生产应用流量继续使用 OpenRouter API使用供应商 API 或其支持的生产集成方式

如果你要回答的是“我该用哪个模型或路由”，就选择 OpenRouter MCP；如果问题是“我能在这个供应商的服务里做什么”，就选择供应商官方 MCP。两者也可以同时接入同一个智能体，以便组合使用两类能力。

社区开发的本地或多模态 MCP 服务器属于另一类方案。OpenRouter 的 Works With OpenRouter 页面介绍了一个支持多个客户端以及文本、图片、音频和视频工作流的服务器；它需要 OpenRouter API 密钥和账户余额，并不是运行在 mcp.openrouter.ai 上的官方托管服务。

真实项目中必须看清的边界

关注点实际情况建议做法
应用集成MCP 用于开发阶段的研究和测试，不适合承载普通产品流量在生产代码中直接调用 https://openrouter.ai/api/v1
推理计费send-message 和 generate-image 可能消耗 MCP 密钥中的余额；查询工具不会发起推理调用测试完成前保留默认上限，要求人工审批，并检查每个生成 ID
源代码和提示词数据OpenRouter 的 MCP 文档称默认不会发送源代码，但在计费调用中明确包含的内容可能会传给所选模型测试时只发送必要文本
供应商选择随着价格、延迟或可用性变化，动态路由可能更换实际提供服务的供应商为了可复现评测或满足特定数据政策，固定供应商

“@OpenRouter 的 ori harness/cli 真是帮了大忙……顺便也感谢 openrouter mcp，让我能快速查模型信息 🫰”——@CodewithP 在 X 上分享了模型信息查询场景。

OpenRouter 的 MCP cookbook还介绍了另一种用法：让 OpenRouter 模型作为其他 MCP 工具服务器的 LLM 后端，而不是把编程客户端连接到 OpenRouter MCP。

第一次调用失败时，按这个顺序排查

  1. 服务器出现了，但工具认证失败。重新执行对应客户端的 OAuth 步骤。这个专用密钥的文档有效期为 7 天，也可以从 OpenRouter 控制台断开。
  2. 浏览器窗口没有打开。使用 claude mcp login openrouter、Claude Code 的 /mcp 操作、Cursor 的 MCP 设置，或 Claude 连接器中的Connect按钮。
  3. Claude Desktop 没有自定义连接器选项。确认组织管理员是否禁用了自定义连接器。
  4. 模型回答看起来过时。明确要求调用 list-models、list-benchmarks 或 list-model-endpoints，并要求返回实际查询值。
  5. 测试费用或路由与预期不符。使用 get-generation 检查生成 ID，然后在下一轮可复现测试中固定具体供应商。

常见问题

OpenRouter MCP 能调用任意 OpenRouter 模型吗？

它可以测试实时目录中暴露的模型 slug，但仍会受到可用性、能力、余额和路由限制。请先用 list-models 确认 slug。

我可以同时在 Claude Desktop、Cursor 和 Claude Code 中使用 OpenRouter MCP 吗？

可以在每个客户端中添加同一个官方端点，并分别按照客户端文档完成配置和认证。共享配置中不要放入个人凭据。

我应该改装社区提供的 openrouter-mcp 包吗？

只有在你需要官方托管服务器不提供的本地 stdio 工作流或多模态编排时，才有必要考虑。事先确认代码仓库、凭据处理方式、软件包来源和维护状态。

先从只读的目录查询开始；只有在模型、路由和消费边界都明确之后，再授权受控的推理调用。