AIREITER想在選定模型前，先確認即時價格、基準測試、可用端點與文件？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 MCP | send-message 可測試指定模型 slug，並回傳 generation ID |
| 從自己的產品發出模型呼叫 | OpenRouter API | 你的應用程式可自行掌握金鑰、重試、提示詞與記錄 |
| 操作特定供應商的服務或帳戶 | 該供應商的官方 MCP | 它可能提供 OpenRouter 無法擁有的功能 |
| 在探索階段生成圖片 | 謹慎使用 OpenRouter MCP | generate-image 屬於推論操作，可能產生費用 |
OpenRouter 的官方公告提到即時模型資料、排名、價格、文件與測試推論功能。至於端點、工具與驗證行為，應以MCP 文件為準。
先設計決策流程，再來設定伺服器
最實用的工作方式是尋找、比較、測試、檢查。這能把「哪個模型最好？」轉為具體條件下的選擇。
- 尋找模型：依任務、價格、上下文、模態或供應商需求篩選模型。使用
list-models與list-benchmarks取得最新目錄和基準資料。 - 比較端點：對每個候選模型呼叫
list-model-endpoints，在資訊可用時查看供應商層級的價格、延遲、吞吐量與資料政策。 - 實際測試：以指定模型 slug 搭配
send-message執行相同提示詞。這一步可能產生推論費用。 - 檢查結果：將每個 generation ID 傳給
get-generation，查看 token 用量、成本與實際服務供應商。
可在 Claude Code 或 Cursor 使用以下提示詞：
使用 OpenRouter MCP，找出三個適合從法律文件擷取結構化資料的模型。
條件：至少 100k 上下文、支援工具呼叫，且輸入價格必須是目前可用方案中最低。
比較供應商與資料政策。接著使用 send-message，將以下完全相同的提示詞在最佳兩個候選模型上執行：
"從以下文字擷取所有合約續約日期。僅回傳 JSON，
包含名為 renewals 的陣列；每個項目須包含 party、date 與 evidence。"
測試後，對每個 generation ID 使用 get-generation，並報告實際成本與服務供應商。
在我核准候選模型前，不要呼叫模型。模型目錄查詢是唯讀操作，send-message 則可能產生推論費用，因此應在測試前要求核准。若要進行可重現的評估，請指定明確的模型與供應商；:free、:floor、:nitro、:online 等後綴在可用時代表路由偏好，不是固定的品質保證。
連接官方遠端伺服器
不需要在本機安裝任何東西。只要加入遠端端點、完成瀏覽器 OAuth，並授權一把與其他金鑰分開的 OpenRouter 專用金鑰即可。文件記載的預設值為 7 天到期、$10 消費上限，皆可在核准頁面修改。OpenRouter 採用含 PKCE 的 OAuth，因此你是在瀏覽器中授權，而不是把一般 API key 貼進用戶端設定檔。
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 listCursor 的MCP 文件說明了使用者層級與專案層級的設定方式。請依實際需求放在適當層級，且不要將個人驗證設定提交到共用儲存庫。
Claude Desktop 與 Claude Web
若 OpenRouter 未出現在 Claude 的 connector 目錄中，OpenRouter 的連線指南建議手動新增自訂遠端 connector：
- 開啟 Settings > Connectors > Customize > Connectors。
- 點選 +，再選擇 Add custom connector。
- 命名為
OpenRouter MCP。 - 在遠端 MCP 伺服器 URL 欄位輸入
https://mcp.openrouter.ai/mcp。 - OAuth 欄位保持空白，新增 connector 後開啟它，再點選 Connect。
- 完成 OpenRouter 的瀏覽器授權。
部分組織會停用自訂 connector。若你使用的是受管理帳戶且看不到這個選項，請詢問管理員。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 | 為其中一筆 generation 寫入回饋 |
挑選模型時，應直接說明決策規則，例如：「找出支援工具呼叫、上下文視窗為 64k 且成本最低的模型，然後顯示目前最快的可用端點。」文件列出的篩選條件包括價格、最低上下文長度、模型家族、作者、供應商、模態、支援參數、基準分數範圍、工具呼叫成功率、是否提供零資料保留，以及地區。
若要進行受控的模型測試，請指定 slug 並讓提示詞可重現：
使用 OpenRouter MCP send-message，模型指定為 "openai/gpt-4o"。
完全照以下使用者訊息送出，不要加入 system prompt：
"回傳一個包含 title 和 risks 鍵的 JSON 物件。分析以下版本說明：
[paste text here]"
顯示回應與 generation ID。不要執行其他模型。此 slug 僅為示例，請改用 list-models 確認仍可使用的模型。若要得到可稽核的比較結果，請明確要求查詢工具、回傳值與 generation 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 key 與點數，並不是位於 mcp.openrouter.ai 的官方託管服務。
實際專案中不能忽略的界線
| 考量項目 | 實際情況 | 建議做法 |
|---|---|---|
| 應用程式整合 | MCP 用於開發期間的研究與測試，不適合承接一般產品流量 | 正式程式碼直接呼叫 https://openrouter.ai/api/v1 |
| 推論計費 | send-message 與 generate-image 可能從 MCP 金鑰扣款；查詢工具不會發出推論呼叫 | 在完成測試前保留預設上限、要求核准，並檢查每個 generation ID |
| 原始碼與提示資料 | OpenRouter 的MCP 文件表示原始碼預設不會送出，但明確包含在計費呼叫中的內容可能會傳至選定模型 | 只送出測試真正需要的文字 |
| 供應商選擇 | 動態路由會隨價格、延遲或可用性變化，而改變實際服務供應商 | 若要可重現評估或符合特定資料政策，請固定供應商 |
「@OpenRouter 的 ori harness/cli 幫了大忙……p.s：也感謝 openrouter mcp，能快速查詢模型資訊 🫰」—— @CodewithP，X，描述的是模型資訊查詢的使用情境。
OpenRouter 的MCP cookbook也介紹反向使用方式：將 OpenRouter 模型作為其他 MCP 工具伺服器的 LLM 後端，而非把程式開發用戶端連接至 OpenRouter MCP。
第一次呼叫失敗時，從這裡排查
- 伺服器出現了，但工具驗證失敗。重新執行該用戶端專屬的 OAuth 步驟。專用金鑰的文件期限為 7 天，也可從 OpenRouter dashboard 中斷連線。
- 沒有開啟瀏覽器視窗。使用
claude mcp login openrouter、Claude Code 的/mcp操作、Cursor 的 MCP 設定，或 Claude connector 的Connect按鈕。 - Claude Desktop 找不到自訂 connector 選項。確認組織管理員是否已停用自訂 connector。
- 模型回答看起來像是舊資料。明確要求使用
list-models、list-benchmarks或list-model-endpoints，並要求回傳查詢到的值。 - 測試成本比預期高，或實際路由不同。使用
get-generation檢查 generation ID，再於下一次需要可重現性的測試中固定明確供應商。
FAQ
OpenRouter MCP 能呼叫所有 OpenRouter 模型嗎？
它可以測試即時目錄中公開的模型 slug，但仍受可用性、能力、點數與路由限制。請先以 list-models 確認 slug。
我可以同時在 Claude Desktop、Cursor 和 Claude Code 使用 OpenRouter MCP 嗎？
可以。你能在各用戶端加入相同的官方端點，並依各自文件完成設定與驗證流程。不過，共用設定中不應包含個人憑證。
我應該改裝社群的 openrouter-mcp 套件嗎？
只有在你需要官方託管伺服器未提供的本機 stdio 工作流程，或多模態編排能力時才應考慮。安裝前請先確認儲存庫、憑證處理方式、套件來源與維護狀態。
先從唯讀的模型目錄查詢開始；等模型、路由與支出界線都清楚後，再授權執行受控的推論呼叫。