連接器（MCP）

連接器係 LanMate 調用外部工具同服務嘅標準化通道，基於 MCP（Model Context Protocol）協議實現。透過設定 MCP 服務，LanMate 可以喺對話入面存取本地檔案系統、調用第三方 API、執行資料庫查詢等，將 AI 助理嘅能力延伸到你日常用嘅各類工具。

本文介紹 MCP 協議嘅基本概念、點樣加入同管理 MCP 服務，同埋使用過程中嘅注意事項。

乜嘢係連接器

MCP 係一套開放協議，用嚟規範 AI 助理同外部工具之間嘅通訊。每個 MCP 服務對外提供一組「工具」，啟用後 AI 助理就可以喺對話按需調用呢啲工具完成任務。

LanMate 支援 stdio 同 http 兩種傳輸模式，分別對應本地服務同遠端服務：

揀邊種模式取決於服務本身嘅提供方式：服務方畀一條可以執行嘅指令就用 stdio，畀一個可以存取嘅地址就用 http。

加入 MCP 服務

喺設定頁進入 MCP 設定，就可以查看當前已設定嘅全部服務，並進行加入、編輯同刪除操作。

加入前，請先由服務提供方攞呢個服務嘅接入資料：本地服務一般係啟動指令同所需參數，遠端服務一般係存取地址同認證方式。

加入一個新服務嘅步驟：

1. 打開設定頁，進入 MCP 設定。
2. 撳加入服務，填寫服務名稱（必填），並可以補充一段描述，方便日後認住呢個服務嘅用途。
3. 揀傳輸類型（stdio 或者 http）。
4. 按所揀模式填寫設定項：
   • stdio 模式：填寫啟動指令、參數同環境變數。指令用嚟喺本地啟動服務進程，環境變數可以用嚟傳入 API Key 等認證資料。
   • http 模式：填寫服務 URL 同 HTTP 標頭資料。認證資料透過 HTTP 標頭傳入。
5. 按需調整逾時時間（預設 30 秒，一般唔使改）。
6. 儲存設定。系統會自動嘗試連接呢個服務，連接成功就可以喺對話使用。

除咗表格填寫，設定介面仲支援 JSON 模式，慣咗直接編輯設定文字嘅用戶可以切換使用。

加入或者編輯服務嗰陣，系統會自動測試連接用唔用到，並可以查看呢個服務提供咗邊啲工具，方便確認設定係咪正確。就算測試連接失敗，都可以先儲存設定，等搵到原因後再透過編輯修正。

管理已有服務

喺 MCP 設定列表，每個服務都會顯示名稱同連接狀態（連接中、已連接、異常），方便快速了解各服務用唔用到。

已加入嘅 MCP 服務支援以下管理操作：

• 啟用/禁用：可以隨時開或者閂已設定嘅服務。禁用後服務設定保留，AI 助理唔會再調用佢嘅工具，重新啟用就可以恢復。
• 編輯：修改服務嘅設定資料（例如指令、URL、環境變數等），儲存後系統自動重新連接。
• 刪除：移除唔再需要嘅服務。刪除需要二次確認，確認後呢個服務嘅全部設定會被清除，而且唔可以恢復，請小心操作。

當服務連接出現異常嗰陣，通常同指令失效、地址變更或者認證資料過期有關，可以透過編輯修改設定，儲存後自動重新連接。

喺對話中使用

MCP 服務啟用後，AI 助理喺對話入面就可以調用佢提供嘅工具：

1. 喺 MCP 設定確認目標服務已啟用而且連接正常。
2. 返去對話，直接同 AI 助理講出你嘅需求。
3. AI 助理喺攞到授權後，調用已啟用服務提供嘅工具完成任務。

AI 助理淨係會調用已啟用服務嘅工具，未啟用或者未設定嘅服務唔會被存取。如果某項任務需要嘅能力暫時冇，可以先去 MCP 設定啟用對應服務，再返去對話繼續提問；唔再需要嗰陣，返去設定禁用就得，唔使刪除服務。

注意事項與安全建議

用 MCP 服務嗰陣，請注意以下事項：

• 設定本地儲存：MCP 服務嘅設定資料（指令、URL、環境變數等）儲存喺本地。
• 審慎啟用：自訂 MCP 服務嘅存取範圍由你嘅設定決定，LanMate 唔預設範圍，請審慎評估後先啟用。
• 來源可信：加入服務嗰陣，確保指令或者 URL 來源可信，唔好加入來源不明嘅服務。
• 保護敏感資料：環境變數或者 HTTP 標頭入面有敏感資料（例如 API Key）嗰陣，請注意妥善保護，避免洩漏。
• 及時清理：唔再用嘅服務，建議及時禁用或者刪除，減少唔必要嘅暴露面。

如果喺設定過程中遇到問題，可以先核對指令、URL 同認證資料係咪填啱，再透過編輯修正後重試連接。