開發者資源

Local MCP

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

Local 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 側邊欄中開啟自訂，找到 RunAPI 並啟用。若程序未啟動，請開啟輸出面板並選取 MCP Logs。

VS Code 將手動設定儲存在最上層的 servers 鍵下，並使用 type: "stdio"。

這些步驟適用於 Cascade 代理。Devin Local 使用 Devin CLI 設定。

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

詢問您的用戶端：

RunAPI 有哪些可用的圖像模型？

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

無需登入即可繼續使用探索工具。當您首次要求 RunAPI 建立 Task、擷取 Task 或查詢餘額時，讓用戶端呼叫 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。