外掛與 MCP | LanSphere 使用手冊

外掛與 MCP

外掛與 MCP 服務是 LanSphere 擴充能力的兩大入口:外掛為平台補充模型與工具,MCP 服務則讓應用以標準協定呼叫外部系統的能力。借助兩者,你編排的工作流、對話流與智慧體可以連接大模型供應商、企業內部系統以及藍信的協作能力。

本文介紹外掛商店與系統外掛的使用、自訂工具的建立、MCP 服務的接入與設定,以及平台預置的藍信 MCP 工具集,適合開發人員與管理員閱讀。

私有化部署說明

LanSphere 為私有化獨立部署。外掛商店提供的是官方維護的外掛安裝包,不連接外部社群市場;常用的模型外掛與工具外掛已內建,開箱即用。

外掛商店

入口:左側選單 →「外掛管理」→「從外掛商店安裝」。

外掛分類

商店中的外掛分為四類:

類型 說明
模型 接入大模型供應商,為應用與知識庫提供模型能力
工具 提供可被工作流、智慧體呼叫的具體功能
Agent 策略 面向智慧體的策略類外掛
擴充 其他平台能力擴充

瀏覽與詳情

外掛卡片包含圖示、標題、開發商、描述與類型。點擊卡片可開啟詳情彈出視窗,檢視版本、開發商與富文字詳細介紹。

安裝與更新

外掛按鈕有三種狀態:

  • 安裝外掛:尚未安裝,點擊即可安裝。
  • 已安裝:目前版本已就緒。
  • 更新外掛:檢測到新版本時顯示,同時在「外掛管理」頁出現「新版本」標識,可一鍵「更新至 vX」。

權限

  • 商店瀏覽與安裝:開發人員及以上角色。
  • 外掛刪除與 API Key 授權設定:管理員或擁有者。

系統外掛設定

已安裝的外掛在「外掛管理」中進行啟用、停用與設定。以模型外掛為例:

  1. 開啟對應模型外掛的設定頁。
  2. 填寫該供應商的 API Key。
  3. 啟用所需的模型。

設定完成後,模型即可在「模型列表」與應用編排中選用。

自訂工具

當系統外掛無法滿足需求時,你可以將內部或第三方 API 封裝為自訂工具,供工作流與智慧體呼叫。

建立流程

  1. 基礎資訊:填寫名稱、類型與描述。
  2. 輸入 / 輸出參數:定義工具的輸入與輸出參數。
  3. 呼叫邏輯:設定 API 位址、請求方式與參數映射。
  4. 測試並儲存:測試通過後儲存,工具即可被呼叫。

列表支援「我建立的」篩選,便於定位本人建立的工具。

刪除規則

  • 你可刪除本人建立的工具,刪除前需二次風險確認:工具被引用會導致關聯應用異常。
  • 非本人建立的工具隱藏編輯入口;已刪除工具的前端引用處會顯示失效提示。

MCP 服務

MCP(Model Context Protocol)是讓應用以標準協定呼叫外部系統能力的介面規範。透過 MCP 服務,你可以把外部系統封裝為工具,在工作流與智慧體中統一呼叫,而無需關心各系統介面細節。

入口:左側選單 →「MCP 服務」(該入口僅開發人員及以上角色可見)。

新增 MCP 服務

  1. 服務位址:填寫 MCP 服務的存取位址。
  2. 授權設定:OAuth 動態用戶端註冊開關預設開啟;如關閉,需將 OAuth 重新導向 URL 設定為 /console/api/mcp/oauth/callback
  3. 請求標頭設定:按需新增自訂 HTTP Header,可設定多條。
  4. 基礎設定:逾時時間與 SSE 讀取逾時時間,不填則使用系統預設。

儲存後服務即出現在列表中,支援「我建立的」篩選。

權限

  • 開發人員可建立 MCP 服務,並刪除本人建立的服務。
  • 管理員可刪除所有 MCP 服務。

藍信 MCP 工具集

平台預置了藍信 MCP 工具集,直接打通藍信的協作能力,應用無需額外開發即可傳送訊息、管理群組、查通訊錄、排行程、開會議、傳檔案。這是 LanSphere 作為藍信旗下平台的差異化能力,全部工具如下:

分組 工具
訊息 傳送私聊訊息、傳送群聊訊息、傳送應用通知訊息、取得訊息記錄、撤回訊息
群組 建立群、取得群詳情、取得群成員、更新群成員
通訊錄 取得人員基本資料、搜尋人員
行事曆 取得主行事曆、建立行程、查詢行程、更新行程、取得行程列表
視訊會議 建立會議、取得進行中與已預約會議列表、歷史會議列表、會議錄影列表及下載連結
媒體檔案 上傳媒體檔案、下載媒體檔案、取得下載路徑

借助這組工具,你可以輕鬆實現諸如「定時彙總資料後推送到專案群」「按姓名找人並傳送通知」「查詢行程後自動建立會議」等政企辦公場景,應用與組織協作流程天然銜接。

在工作流與智慧體中使用 MCP 工具

MCP 服務新增完成後,即可在兩類應用中呼叫其工具。

在工作流中呼叫

  1. 開啟目標工作流的編排畫布。
  2. 新增工具類節點,在四類工具中選擇「MCP」。
  3. 在彈出的工具列表中選擇目標服務與具體工具,完成節點設定。

工作流中的 MCP 呼叫是確定性的:流程執行到該節點時按設定執行,適合固定編排的自動化場景。

在智慧體中呼叫

  1. 進入目標智慧體的「應用開發 → 工具設定」。
  2. 選擇「MCP 服務」分類,勾選所需服務與工具。
  3. 儲存後,大模型將按使用者意圖自動決策呼叫時機。

智慧體中的 MCP 呼叫是自主決策的:是否呼叫、呼叫哪個工具由大模型根據對話內容判斷,適合開放式任務。

提示:「MCP 服務」選單與智慧體入口僅開發人員及以上角色可見;權限相關說明詳見《成員與權限》。

相關閱讀

  • 《SKILL 技能》:將 MCP 服務工具包裝為技能,供智慧體標準化複用。
  • 《工作流》:工具類節點與畫布操作。
  • 《成員與權限》:外掛安裝刪除與 API Key 設定的角色要求。