開發者資源

Hosted MCP

使用 OAuth 將 Claude Desktop、Cursor、VS Code、Windsurf 或其他 MCP 客戶端連接至 RunAPI。

Hosted MCP 是使用 RunAPI 工具的推薦方式。您的 MCP 客戶端直接連接到 RunAPI，因此無需安裝 Node.js 或保持本地進程運行。

使用此端點：

TEXT

https://mcp.runapi.ai/mcp

在下方選擇您的 MCP 客戶端。當客戶端在瀏覽器中開啟 RunAPI 時，請登入、選擇要使用的帳戶並批准存取。

Claude Desktop

若 RunAPI 未出現在對話中，請返回 設定 > Connectors，重新連接並確認已為該對話啟用。

將 RunAPI 新增至您的 Cursor mcp.json，例如專案層級的 .cursor/mcp.json：

JSON

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

在 Cursor 側邊欄中開啟 Customize，找到 RunAPI，啟用它，並在瀏覽器中完成授權。

RunAPI 應顯示為已連線並公開其工具。如有連線或身份驗證錯誤，請開啟輸出面板並選擇 MCP Logs。

RunAPI 工具應出現在 Chat 中。如有錯誤，請執行 MCP: List Servers，選擇 RunAPI，然後選擇 Show Output。

以下步驟適用於 Cascade 代理。Devin Local 使用 Devin CLI 配置。

開啟Devin Settings > Cascade > MCP Servers，並編輯原始的 ~/.codeium/windsurf/mcp_config.json 檔案。
將 RunAPI 新增為遠端 HTTP 伺服器：

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

若工具未顯示，請開啟 MCP 設定，確認 RunAPI 已啟用，並重新連接。

將上方端點新增為 Streamable HTTP 伺服器。客戶端必須支援 Remote MCP 及以瀏覽器為基礎的 OAuth。出現提示時完成授權，然後在客戶端中啟用 RunAPI 工具。

詢問您的客戶端：

有哪些 RunAPI 圖像模型可用？

客戶端應呼叫 list_models 並返回可用的圖像模型。這可確認連接及工具分發正常運作。

OAuth 是推薦的方式。僅在無人值守的客戶端或 OAuth 不可用時才使用專用標準 API 金鑰；請按照身份驗證指南建立一個。切勿將金鑰放入端點 URL 或提交至代碼庫。

Claude Desktop： 如果自訂連接器支援 Request headers，請新增一個 Authorization 標頭，值為 Bearer YOUR_API_KEY。
Cursor： 在 Cursor 應用程式可見的環境中設定 RUNAPI_API_KEY，然後在伺服器 headers 中使用 Authorization: Bearer ${env:RUNAPI_API_KEY}。遠端伺服器不會讀取 Cursor 的 envFile 設定。
VS Code： 在伺服器 Authorization 標頭中引用密碼類型的 ${input:...}，讓 VS Code 提示輸入並儲存金鑰，而不是將其寫入 mcp.json。
Windsurf： 在 ~/.codeium/windsurf/mcp_config.json 的 Authorization 標頭中引用 ${env:RUNAPI_API_KEY} 或 ${file:...}。

當客戶端退役或金鑰可能已外洩時，請從 API Keys 頁面撤銷該金鑰。

需要讓客戶端在您的機器上啟動 RunAPI？設定本地 MCP。