開發者資源

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 未出現在對話中，請返回設定 > 連接器，重新連線並確認已為該對話啟用。

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

JSON

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

在 Cursor 側邊欄中開啟自訂，找到 RunAPI 並啟用，然後在瀏覽器中完成授權。

RunAPI 應顯示為已連線並公開其工具。若發生連線或身分驗證錯誤，請開啟 Output 面板並選取 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 金鑰」頁面撤銷該金鑰。

需要用戶端在您的機器上啟動 RunAPI？請設定 Local MCP。