> ## Documentation Index
> Fetch the complete documentation index at: https://manus.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 自訂 MCP 伺服器

> 與您的內部工具和專有系統建構整合

## 什麼是自訂 MCP 伺服器？

自訂 MCP 伺服器允許您將 Manus 的整合能力擴展到預建的連接器之外。如果您的組織使用內部工具、專有 API 或標準 MCP 連接器未涵蓋的專業服務，您可以建構一個自訂伺服器，將 Manus 連接到這些系統。

自訂 MCP 伺服器充當 Manus 與您的內部基礎設施之間的橋樑，實現與預建連接器相同的無縫多應用程式工作流程——但它是根據您的特定工具和要求量身定制的。

## 為什麼要建構自訂 MCP 伺服器？

### 內部系統

許多組織依賴自訂建構的工具、內部資料庫或專有軟體。自訂 MCP 伺服器允許 Manus 與這些系統整合，將內部資料引入您的 AI 工作流程。

**範例**：

* 內部 CRM 或客戶資料庫
* 專有專案管理工具
* 自訂分析平台
* 帶有 API 的舊系統

### 專業服務

一些第三方服務沒有預建的 MCP 連接器。如果您使用專業工具或利基服務，您可以建構一個自訂伺服器將其連接到 Manus。

**範例**：

* 行業特定軟體
* 標準連接器未涵蓋的區域服務
* 沒有官方整合的新興平台

### 自訂業務邏輯

自訂 MCP 伺服器可以實現超出簡單 API 呼叫的業務特定邏輯、資料轉換或驗證規則。這允許您在 Manus 整合中強制執行組織策略和工作流程。

**範例**：

* 資料更新前的審批工作流程
* 根據內部標準進行資料驗證
* 自訂身份驗證或安全要求
* 組織特有的多步驟流程

## 自訂 MCP 伺服器的工作原理

自訂 MCP 伺服器是一種輕量級服務，實現了模型上下文協定規範。它公開了 Manus 可以呼叫的端點，用於讀取資料、執行操作或在您的系統中執行自訂邏輯。

### 架構

**您的內部系統** ↔**自訂 MCP 伺服器** ↔**Manus**

MCP 伺服器位於 Manus 和您的內部系統之間，將 Manus 請求轉換為您工具中的操作，並以 Manus 理解的格式傳回結果。

### 協定

自訂 MCP 伺服器實現了一個標準化的協定，它定義了：

* **工具**: Manus 可以執行的操作（例如，“get\_customer\_data”，“update\_project\_status”）
* **資源**: Manus 可以讀取的資料（例如，文件、記錄、檔案）
* **提示詞**: 常見操作的預定義範本

## 建構一個自訂 MCP 伺服器

### 先決條件

* **API** 存取您想要整合的系統
* **開發環境** (Node.js、Python 或任何可以執行網頁伺服器的語言)
* **了解 MCP 規範** (可在 Manus 文件中取得)

### 基本實作

一個最小的自訂 MCP 伺服器包括：

1. **伺服器端點**: 一個回應 MCP 協定請求的網頁服務
2. **工具定義**: Manus 可以執行動作的描述
3. **身份驗證**: 安全處理憑證和 API 密鑰
4. **請求處理程序**: 執行動作並返回結果的邏輯

### 範例：內部 CRM 整合

這是一個用於內部 CRM 的自訂 MCP 伺服器的概念範例：

**公開的工具**:

* `get_customer_info(customer_id)`: 檢索客戶詳情
* `update_customer_notes(customer_id, notes)`: 新增備註到客戶記錄
* `search_customers(query)`: 搜尋客戶資料庫
* `create_follow_up_task(customer_id, task_description, due_date)`: 建立所有務

**身份驗證**: 用於您的內部 CRM 的 API 密鑰或 OAuth 權杖

**部署**: 託管在您的基礎設施或安全的雲端環境中

部署後，您將此自訂伺服器連接到 Manus，它會與預建的連接器一起出現。然後您可以使用自然語言提示，例如：

* "取得客戶 ID 12345 的客戶資訊"
* "搜尋舊金山地區的客戶"
* "使用我們最近的對話更新客戶 67890 的備註"

## 連接自訂 MCP 伺服器

### 步驟 1：部署您的伺服器

將您的自訂 MCP 伺服器託管在您控制的基礎設施上。確保它可以透過 HTTPS 存取，並採取了適當的安全措施。

### 步驟 2：新增到 Manus

在 Manus 中，導覽到**Settings → Integrations → Custom MCP Servers** 並點擊**Add Server**。

### 步驟 3：提供伺服器詳情

輸入以下資訊：

* **伺服器名稱**: 描述性名稱（例如，「內部 CRM」、「分析平台」）
* **伺服器 URL**: 託管您的 MCP 伺服器的 HTTPS 端點
* **身份驗證**: 需要 API 金鑰、Bearer 權杖或其他憑證

### 步驟 4：測試連線

Manus 將驗證它是否可以與您的伺服器通訊並檢索可用工具的列表。

### 步驟 5：開始使用

連線後，您的自訂工具將出現在 Manus 的可用集成中。在提示詞中引用它們，就像引用預建連接器一樣。

## 安全考量

### 身份驗證

自訂 MCP 伺服器應實施強大的身份驗證：

* 使用 API 金鑰、OAuth 權杖或其他安全方法
* 切勿在 URL 或日誌中暴露憑證
* 定期輪換憑證

### 授權

實施適當的授權檢查：

* 驗證請求使用者是否具有存取資料的權限
* 如果適用，強制執行基於角色的存取控制 (RBAC)
* 記錄所有存取嘗試以供稽核

### 資料傳輸

* 所有通訊均使用 HTTPS
* 加密靜態和傳輸中的敏感資料
* 實施速率限制以防止濫用

### 網路安全

* 在您的安全網路邊界內部署 MCP 伺服器
* 使用防火牆和存取控制來限制誰可以存取伺服器
* 對於高度敏感的集成，考慮使用 VPN 或專用網路連線

## 最佳實踐

### 工具設計

**保持工具專注**：每個工具應執行一個明確的動作。不要使用單個 “manage\_customer” 工具，而是為 “get\_customer”、“update\_customer”、“delete\_customer” 建立單獨的工具。

**提供清晰的描述**：Manus 使用工具描述來理解何時使用每個工具。編寫清晰、具體的描述，解釋工具的作用以及何時適用。

**優雅地處理錯誤**：返回有意義的錯誤訊息，幫助 Manus（和使用者）了解出了什麼問題以及如何修復。

### 效能

**優化回應時間**：Manus 等待 MCP 伺服器回應。透過快取資料、使用高效查詢和避免不必要的處理來保持操作快速。

**實施逾時**：為 API 呼叫設定合理的逾時時間，以防止如果您的內部系統緩慢或無回應時 Manus 無限期等待。

**對耗時的任務使用非同步操作**：如果操作耗時超過幾秒鐘，請考慮立即返回任務 ID，並提供一個單獨的工具來檢查狀態。

### 監控

**記錄所有請求**：追蹤 Manus 正在請求什麼以及您的伺服器如何回應。這有助於偵錯和理解使用模式。

**監控效能**：追蹤回應時間、錯誤率和使用量，以便在問題影響使用者之前識別它們。

**設定警報**：如果您的 MCP 伺服器無回應或開始返回錯誤，您將收到通知。

## 範例使用情境

### 內部知識庫

**情境**: 您的組織擁有包含公司政策、程序和文件的內部維基或知識庫。

**自訂 MCP 伺服器**: 提供用於搜尋知識庫、檢索特定文章和尋找相關文件的工具。

**Manus 工作流**: "在我們的內部知識庫中搜尋費用報銷政策，並總結重點。"

***

### 自訂分析平台

**情境**: 您擁有一個專有的分析平台，用於追蹤標準工具中不可用的業務指標。

**自訂 MCP 伺服器**: 公開用於查詢指標、產生報告和檢索歷史資料的工具。

**Manus 工作流**: "提取我們第四季度的客戶獲取成本資料，並建立與第三季度比較的趨勢分析。"

***

### 舊有系統整合

**情境**: 您的組織依賴於沒有現代 API 或整合的舊有系統。

**自訂 MCP 伺服器**: 作為舊有系統的包裝器，將現代 API 呼叫轉換為舊有系統可以理解的格式。

**Manus 工作流**: "檢查舊有系統中產品 SKU 98765 的庫存水平，如果庫存低於 100 件，則建立重新訂購請求。"

***

### 多步驟審批工作流

**情境**: 您的組織需要針對某些操作（例如，預算請求、資料存取）的審批工作流。

**自訂 MCP 伺服器**: 實作建立審批請求、檢查審批狀態和執行已批准操作的工具。

**Manus 工作流**: "為行銷活動建立一份 50,000 美元的預算請求，並通知財務團隊進行審批。"

## 常見問題

<AccordionGroup>
  <Accordion title="我需要成為開發人員才能建立自訂 MCP 伺服器嗎？" icon="sparkles">
    建立自訂 MCP 伺服器需要開發技能。但是，MCP 規範很簡單，並且提供了範例實作來幫助您入門。
  </Accordion>

  <Accordion title="我可以使用現有 API 而無需建立自訂伺服器嗎？" icon="sparkles">
    如果服務具有完善的 REST API 文件，您可能無需自訂 MCP 伺服器即可使用 Manus 的通用 API 呼叫功能。但是，自訂伺服器提供了更好的整合、更清晰的工具定義和更可靠的工作流。
  </Accordion>

  <Accordion title="是否有性能要求？">
    自訂 MCP 伺服器應在幾秒鐘內回應大多數操作。較長的操作應使用非同步模式。Manus 將會逾時耗時過長的請求。
  </Accordion>

  <Accordion title="如何維護自訂 MCP 伺服器？">
    像對待任何其他內部服務一樣對待自訂 MCP 伺服器：版本控制、自動化測試、監控和定期更新。使伺服器與內部系統 API 的變更保持同步。
  </Accordion>
</AccordionGroup>