什麼是自訂 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 伺服器包括:- 伺服器端點: 一個回應 MCP 協定請求的網頁服務
- 工具定義: Manus 可以執行動作的描述
- 身份驗證: 安全處理憑證和 API 密鑰
- 請求處理程序: 執行動作並返回結果的邏輯
範例:內部 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): 建立所有務
- “取得客戶 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 伺服器嗎?
建立自訂 MCP 伺服器需要開發技能。但是,MCP 規範很簡單,並且提供了範例實作來幫助您入門。
我可以使用現有 API 而無需建立自訂伺服器嗎?
我可以使用現有 API 而無需建立自訂伺服器嗎?
如果服務具有完善的 REST API 文件,您可能無需自訂 MCP 伺服器即可使用 Manus 的通用 API 呼叫功能。但是,自訂伺服器提供了更好的整合、更清晰的工具定義和更可靠的工作流。
是否有性能要求?
是否有性能要求?
自訂 MCP 伺服器應在幾秒鐘內回應大多數操作。較長的操作應使用非同步模式。Manus 將會逾時耗時過長的請求。
如何維護自訂 MCP 伺服器?
如何維護自訂 MCP 伺服器?
像對待任何其他內部服務一樣對待自訂 MCP 伺服器:版本控制、自動化測試、監控和定期更新。使伺服器與內部系統 API 的變更保持同步。