---
title: Local MCP | RunAPI
description: 以 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 用戶端在本機執行 RunAPI MCP Server。
url: https://runapi.ai/zh-TW/docs/resources/mcp/local.md
canonical: https://runapi.ai/zh-TW/docs/resources/mcp/local
locale: zh-TW
---

> HTML 版本: https://runapi.ai/zh-TW/docs/resources/mcp/local
> 代理程式網站索引: https://runapi.ai/llms.txt

# Local MCP

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

## 開始前的準備

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

以下每個用戶端均執行相同的指令：

```shell
npx -y @runapi.ai/mcp
```

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

## Claude Code

執行：

```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

1.  開啟命令選擇區並執行 **MCP: Add Server**。
2.  選擇 **Command (stdio)**，並輸入 `npx -y @runapi.ai/mcp`。
3.  將伺服器命名為 **RunAPI**，選擇其設定範圍，然後啟動。
4.  出現提示時信任該伺服器。若發生錯誤，請執行 **MCP: List Servers**，選取 RunAPI，然後選擇 **Show Output**。

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

## Windsurf

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

1.  開啟 **Devin Settings > Cascade > MCP Servers**。
2.  開啟位於 `~/.codeium/windsurf/mcp_config.json` 的原始 MCP 設定檔。
3.  使用上方 Cursor 範例中所示的 `npx` 指令與引數新增 RunAPI。
4.  儲存檔案、重新整理 MCP 伺服器，並啟用 RunAPI。

## 其他 MCP 用戶端

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

## 驗證連線

詢問您的用戶端：

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

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

## 需要時請登入

無需登入即可繼續使用探索工具。當您首次要求 RunAPI 建立 Task、擷取 Task 或查詢餘額時，讓用戶端呼叫 `login` 工具。它會在瀏覽器中開啟 RunAPI，並將憑證儲存至共用的本機設定。

若您偏好從終端機登入，請安裝 [RunAPI CLI](https://runapi.ai/zh-TW/docs/resources/cli.md) 並執行：

```shell
runapi login
```

對於無頭或 CI 用戶端，請遵循[身分驗證
指南](https://runapi.ai/zh-TW/docs/guides/authentication.md)建立專用標準 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](https://runapi.ai/zh-TW/docs/resources/mcp/hosted.md)。

---

## RunAPI 的更多內容

- [首頁](https://runapi.ai/zh-TW/.md)
- [模型目錄](https://runapi.ai/zh-TW/models.md)
- [價格](https://runapi.ai/zh-TW/pricing.md)
- [提供商](https://runapi.ai/zh-TW/models)
- [文件](https://runapi.ai/zh-TW/docs/guides)
- [SDK](https://runapi.ai/zh-TW/sdk.md)
- [CLI](https://runapi.ai/zh-TW/cli.md)
- [MCP Server](https://runapi.ai/zh-TW/mcp.md)
- [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md)
- [企業版](https://runapi.ai/zh-TW/contact.md)
- [聯絡我們](https://runapi.ai/zh-TW/contact.md)
- [服務條款](https://runapi.ai/zh-TW/terms.md)
- [隱私權](https://runapi.ai/zh-TW/privacy.md)
- [代理程式網站索引](https://runapi.ai/llms.txt)

聯絡我們: contact@runapi.ai

## 結構化資料

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-TWicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "TechArticle",
    "headline": "Local MCP",
    "description": "以 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 用戶端在本機執行 RunAPI MCP Server。",
    "url": "https://runapi.ai/zh-TW/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/zh-TW/docs/resources/mcp/local"
  }
]
```