跳轉到主要內容

什麼是自訂 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 美元的預算請求,並通知財務團隊進行審批。“

常見問題

建立自訂 MCP 伺服器需要開發技能。但是,MCP 規範很簡單,並且提供了範例實作來幫助您入門。
如果服務具有完善的 REST API 文件,您可能無需自訂 MCP 伺服器即可使用 Manus 的通用 API 呼叫功能。但是,自訂伺服器提供了更好的整合、更清晰的工具定義和更可靠的工作流。
自訂 MCP 伺服器應在幾秒鐘內回應大多數操作。較長的操作應使用非同步模式。Manus 將會逾時耗時過長的請求。
像對待任何其他內部服務一樣對待自訂 MCP 伺服器:版本控制、自動化測試、監控和定期更新。使伺服器與內部系統 API 的變更保持同步。