OpenRouter 入门与概览

MCP 服务器

2 分钟阅读

MCP

通过模型上下文协议（Model Context Protocol，MCP）将 AI 编码工具接入 OpenRouter

OpenRouter MCP 服务器 把 OpenRouter 接入你已经在使用的 AI 工具。连接后，你的助手可以拉取实时的 OpenRouter 数据（模型、价格、额度、排名和文档），并发送快速测试消息，全程无需离开编辑器。

这是由 OpenRouter 托管的远程服务器（无需本地安装）。你只需向 MCP 客户端添加一个 URL，并在浏览器中批准 OAuth 登录即可连接。

在开发时使用此 MCP。它让你的编程助手拉取实时的 OpenRouter 信息（有哪些模型、价格如何、你的额度余额），并发送快速测试消息，无需离开编辑器。要在应用中实际运行模型，请继续直接调用 OpenRouter API。

连接你的智能体

Claude Code
Codex CLI
OpenCode
Cursor CLI
Claude Desktop / Web

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

你也可以在会话中完成身份验证：运行 /mcp，选择 openrouter，然后点击 Authenticate（验证）。

将以下内容添加到 ~/.config/opencode/opencode.json。OpenCode 会在首次使用时自动运行 OAuth 流程，无需单独的登录步骤：

{
  "mcp": {
    "openrouter": {
      "type": "remote",
      "url": "https://mcp.openrouter.ai/mcp",
      "enabled": true
    }
  }
}

Cursor CLI（cursor-agent）读取与 IDE 相同的配置。将以下内容添加到 ~/.cursor/mcp.json，然后用 cursor-agent mcp list 验证。从 Cursor 的 MCP 设置中完成身份验证，或在首次使用工具时按提示操作：

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

OpenRouter 不在 Claude 的连接器目录中，因此请将其添加为自定义连接器：

前往 设置（Settings）> 连接器（Connectors）> 自定义（Customize）> 连接器（Connectors），点击 +，然后选择 添加自定义连接器（Add custom connector）。
在 名称（Name） 中输入 OpenRouter MCP，并将 远程 MCP 服务器 URL（Remote MCP server URL） 设为 https://mcp.openrouter.ai/mcp。OAuth 字段留空。
点击 添加（Add），然后打开该连接器并点击 连接（Connect） 以运行 OAuth 流程。

某些组织不允许添加自定义连接器，因此并非所有人都能看到此选项。如果看不到，请联系你的管理员。

并非所有客户端都会自动弹出身份验证；有些需要你在添加服务器后执行一次登录。触发后，浏览器会打开 OpenRouter 同意页面，你在此批准一把 仅用于本次连接的专用密钥，与其他密钥分开。该密钥 7 天后过期，并带有 $10 的消费限额（可在批准页面修改）。你可以随时断开连接。

你可以做什么

MCP 暴露以下工具。大多数是针对实时 OpenRouter 数据的只读查询。有两个例外：send-message 和 generate-image 会发起计费推理调用，send-feedback 会为你自己的某次生成写入反馈。

工具	功能
`send-message`	向任意模型发送消息并获取回复，用于测试提示词或比较模型
`generate-image`	根据文本提示词生成图像，并以图像内容块的形式内联返回
`list-models`	搜索 OpenRouter 的实时模型目录：自由文本搜索、排序（包括按 Artificial Analysis 的智力、编程和智能体指数以及 Design Arena ELO），并按用例、提示词 / 补全价格、最小上下文、模型年龄、基准指数范围、工具调用成功率、模型家族、作者、服务提供商、输入 / 输出模态、支持的参数，以及零数据保留（ZDR，Zero Data Retention）或地区进行筛选
`get-model`	按 `author/slug` 获取单个模型的完整详情（支持 `:variant` 后缀和别名）
`list-model-endpoints`	哪些服务提供商提供某模型，以及它们的价格、延迟、吞吐量和数据政策
`list-providers`	列出可用于路由偏好的服务提供商
`list-daily-model-rankings`	按 Token 量统计哪些模型使用最多、哪些正在上升
`list-app-rankings`	哪些应用贡献了最多的 OpenRouter 流量，可按分类筛选
`get-credits`	你账户的剩余额度
`get-generation`	特定生成 id 的费用、Token 计数和提供服务的服务提供商
`list-benchmarks`	来自 Artificial Analysis（智力、编程、智能体指数）和 Design Arena（两两对战 elo、胜率）的第三方质量分数
`list-task-classifications`	OpenRouter 流量的用途：按任务类型（代码生成、网络搜索、摘要等）的市场份额，以及每个任务的热门模型和宏观分类（Code、Data、Agent、General）汇总
`search-docs`	搜索完整的 OpenRouter 文档，以回答「我该如何……」类问题
`send-feedback`	报告你自己某次生成中的问题（分类 + 可选评论），发送给 OpenRouter 团队
`spawn-ori-eval`	获取使用 Ori 运行模型评测的说明（在固定的评测框架和模型上，用你自己的智能体和提示词），然后按说明执行
`install-ori-harness`	获取安装 Ori 评测框架的免参数步骤并按此执行
`ping`	健康检查，用于验证连接

为任务选择合适的模型

你描述一项任务，助手会据此推荐模型，推荐依据是实时数据，而不是模型过时的训练知识。send-message 会基于实时数据，因此助手不会凭记忆说出某个模型。对于任何「我该用哪个模型」的问题，它会交给实时的 list-benchmarks、list-daily-model-rankings 和 list-models 工具。合适的选择可能是最便宜的、最聪明的、最快的、某种特定模态，或某一家服务提供商。

按任务和权衡：

「现在最适合编程的模型是哪个？」
「最强的高难度推理模型，不考虑费用？」
「总结长文档性价比最好的模型？」

按模态（OpenRouter 支持的远不止文本）：

「有哪些嵌入模型，哪个最好？」
「你们支持重排序模型吗？推荐一个。」
「最好的文本转语音模型？语音转文本呢？」

按基准测试和服务提供商：

「哪个模型在 Artificial Analysis 智力指数上排名第一？」
「落地页设计最好的模型是哪个？」
「推荐一个模型，并告诉我应该路由到哪家服务提供商。」

你还可以做什么

「我在 OpenRouter 上还剩多少额度？」
「哪些应用向 OpenRouter 发送的流量最多？」
「如何把模型固定到特定服务提供商，例如 Bedrock？」
「向 GPT-5.5 发送一条测试消息，并告诉我花了多少钱。」
「用同一条提示词比较 Opus 4.8、DeepSeek v4 Pro、Gemini 3.5 Flash 和 GLM-5.2 的回答。」

send-message 理解模型 slug 后缀：添加 :online 进行网络搜索，:nitro 追求速度，:floor 选择最低价格，或在存在免费端点时使用 :free。每条回复都包含该次调用的生成 id，你可以把它传给 get-generation，查看确切费用以及由哪家服务提供商提供服务。只有在需要零方差时才固定服务提供商，例如运行评测或复现结果。

工作原理

发现与身份验证。 未认证的请求会返回 401，并指向 OpenRouter 的 OAuth 授权服务器。客户端完成注册，你批准同意页面，然后通过 PKCE 签发令牌。
专用密钥。 签发的令牌是一把标准的 OpenRouter API 密钥，标签为 OpenRouter MCP: <app name>，有效期 7 天，默认消费限额为 $10，因此你可以在控制台中找到并撤销它。
实时数据，无本地状态。 工具使用你的密钥代理公开的 OpenRouter API。不会在本地安装任何内容；除非你调用 send-message、generate-image 或 send-feedback，否则不会把源代码发送到任何地方。

故障排除

工具调用因身份验证错误失败。 重新执行对应客户端的身份验证步骤。密钥可能已过期（有效期 7 天）或已被断开。
登录没有自动弹出。 有些客户端需要手动触发。请使用上面各客户端的步骤。