開發者資源

本地 MCP

使用 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 客戶端在本地執行 RunAPI MCP Server。

本地 MCP 讓您的 MCP 客戶端在您的機器上啟動 RunAPI MCP Server。當客戶端不支援 Remote MCP 或您明確需要本地進程時，請使用此方式。

開始前

安裝 Node.js 並確認 npx 可用。您的 MCP 客戶端必須支援本地 stdio 伺服器。

以下每個客戶端均以相同命令啟動：

SHELL

npx -y @runapi.ai/mcp

您無需登入即可連線並使用目錄工具。

執行：

SHELL

claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

使用 -s user 令 RunAPI 在您的所有專案中均可使用。若 Claude Code 已在運行，請重新啟動，然後確認 RunAPI 已列示為 MCP 伺服器。

在 .cursor/mcp.json 或您的用戶 MCP 設定中的 mcpServers 下新增伺服器：

JSON

{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

在 Cursor 側邊欄中開啟 Customize，找到 RunAPI 並啟用。如果進程未啟動，請開啟 Output 面板並選擇 MCP Logs。

VS Code 將手動配置儲存在頂層 servers 鍵下，並使用 type: "stdio"。

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

新增一個名為RunAPI的本地 stdio 伺服器。將其指令設定為 npx，參數設定為 -y 和 @runapi.ai/mcp。儲存設定後重新啟動或重新整理客戶端。

詢問您的客戶端：

有哪些 RunAPI 圖像模型可用？

客戶端應呼叫 list_models 並返回可用的圖像模型。此公開探索工具不需要身份驗證。

在不登入的情況下繼續使用探索工具。當您首次要求 RunAPI 建立任務、取得任務或查詢餘額時，讓客戶端呼叫 login 工具。它會在瀏覽器中開啟 RunAPI 並將憑證儲存至共享本地配置。

若偏好從終端機登入，請安裝 RunAPI CLI 並執行：

SHELL

runapi login

對於無頭或 CI 客戶端，請依照身份驗證指南建立專用的標準 API 金鑰，然後透過客戶端的環境變數或密鑰設定以 RUNAPI_API_KEY 形式提供。環境金鑰優先於本機 MCP 登入所儲存的憑證。

找不到 npx：確認 node --version 和 npx --version 均能正常運行，然後完全重啟 MCP 客戶端以接收更新後的環境變數。
本地伺服器立即退出：在終端機執行 npx -y @runapi.ai/mcp，修正所報告的 Node.js 或套件錯誤，然後重啟客戶端。
RunAPI 工具未顯示：確認伺服器已啟用且命令使用 stdio，然後查看上方所描述的客戶端日誌。
已驗證的工具失敗：請客戶端呼叫 login 工具。若已設定 RUNAPI_API_KEY，請在重試本地 MCP 登入前更新或移除它。

希望在無本地 Node.js 程序的情況下連線？設定 Hosted MCP。