---
title: Hosted MCP | RunAPI
description: 使用 OAuth 將 Claude Desktop、Cursor、VS Code、Windsurf 或其他 MCP 客戶端連接至 RunAPI。
url: https://runapi.ai/zh-HK/docs/resources/mcp/hosted.md
canonical: https://runapi.ai/zh-HK/docs/resources/mcp/hosted
locale: zh-HK
---

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

# Hosted MCP

Hosted MCP 是使用 RunAPI 工具的推薦方式。您的 MCP 客戶端直接連接到 RunAPI，因此無需安裝 Node.js 或保持本地進程運行。

使用此端點：

```text
https://mcp.runapi.ai/mcp
```

在下方選擇您的 MCP 客戶端。當客戶端在瀏覽器中開啟 RunAPI 時，請登入、選擇要使用的帳戶並批准存取。

## Claude Desktop

1.  開啟**Settings > Connectors**並新增自訂連接器。
2.  將其命名為**RunAPI**並輸入上方的端點。
3.  選擇**Connect**，並在瀏覽器中完成 RunAPI 授權。
4.  在對話中，開啟**+ > Connectors**並啟用 RunAPI。

若 RunAPI 未出現在對話中，請返回 **設定 >
Connectors**，重新連接並確認已為該對話啟用。

## 游標

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

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

在 Cursor 側邊欄中開啟 **Customize**，找到 RunAPI，啟用它，並在瀏覽器中完成授權。

RunAPI 應顯示為已連線並公開其工具。如有連線或身份驗證錯誤，請開啟**輸出**面板並選擇 **MCP Logs**。

## VS Code

1.  開啟命令列板，執行**MCP: Add Server**。
2.  選擇**HTTP**，輸入上方的端點，並將伺服器命名為**RunAPI**。
3.  啟動伺服器，出現提示時信任它，並在瀏覽器中完成授權。

RunAPI 工具應出現在 Chat 中。如有錯誤，請執行 **MCP: List Servers**，選擇 RunAPI，然後選擇 **Show Output**。

## Windsurf

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

1.  開啟**Devin Settings > Cascade > MCP Servers**，並編輯原始的 `~/.codeium/windsurf/mcp_config.json` 檔案。
2.  將 RunAPI 新增為遠端 HTTP 伺服器：

```json
{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}
```

1.  儲存檔案，重新整理 MCP 伺服器，啟用 RunAPI，並在瀏覽器中完成授權。

若工具未顯示，請開啟 MCP 設定，確認 RunAPI 已啟用，並重新連接。

## 其他 MCP 客戶端

將上方端點新增為 Streamable HTTP 伺服器。客戶端必須支援 Remote MCP 及以瀏覽器為基礎的 OAuth。出現提示時完成授權，然後在客戶端中啟用 RunAPI 工具。

## 驗證連線

詢問您的客戶端：

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

客戶端應呼叫 `list_models` 並返回可用的圖像模型。這可確認連接及工具分發正常運作。

## 改用 API 金鑰

OAuth 是推薦的方式。僅在無人值守的客戶端或 OAuth 不可用時才使用專用標準 API 金鑰；請按照[身份驗證指南](https://runapi.ai/zh-HK/docs/guides/authentication.md)建立一個。切勿將金鑰放入端點 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 Keys 頁面撤銷該金鑰。

## 疑難排解

* 身份驗證未完成：從客戶端重新連接 RunAPI 並再次完成瀏覽器流程。
* RunAPI 已連接但工具缺失：確認伺服器已啟用，移除後重新新增確切端點，然後開始新對話。
* 驗證問題失敗：查看上方對應章節所描述的客戶端日誌，然後在重試前重新連接 RunAPI。

需要讓客戶端在您的機器上啟動 RunAPI？[設定本地
MCP](https://runapi.ai/zh-HK/docs/resources/mcp/local.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": "Hosted MCP",
    "description": "使用 OAuth 將 Claude Desktop、Cursor、VS Code、Windsurf 或其他 MCP 客戶端連接至 RunAPI。",
    "url": "https://runapi.ai/zh-HK/docs/resources/mcp/hosted",
    "mainEntityOfPage": "https://runapi.ai/zh-HK/docs/resources/mcp/hosted"
  }
]
```