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

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

# 本地 MCP

本地 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 側邊欄中開啟 **Customize**，找到 RunAPI 並啟用。如果進程未啟動，請開啟 **Output** 面板並選擇 **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 建立任務、取得任務或查詢餘額時，讓客戶端呼叫 `login` 工具。它會在瀏覽器中開啟 RunAPI 並將憑證儲存至共享本地配置。

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

```shell
runapi login
```

對於無頭或 CI 客戶端，請依照[身份驗證
指南](https://runapi.ai/zh-HK/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-HK/docs/resources/mcp/hosted.md)。

---

## RunAPI 的更多內容

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

聯絡我們: contact@runapi.ai

## 結構化資料

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