連接器（MCP）
連接器是 LanMate 調用外部工具和服務的標準化通道，基於 MCP（Model Context Protocol）協定實現。透過設定 MCP 服務，LanMate 可以在會話中存取本地檔案系統、調用第三方 API、執行資料庫查詢等，將 AI 助理的能力延伸到你日常使用的各類工具上。
本文介紹 MCP 協定的基本概念、如何加入和管理 MCP 服務，以及使用過程中的注意事項。
什麼是連接器
MCP 是一套開放協定，用於規範 AI 助理與外部工具之間的通訊。每個 MCP 服務對外提供一組「工具」，啟用後 AI 助理即可在會話中按需調用這些工具完成任務。
LanMate 支援 stdio 和 http 兩種傳輸模式，分別對應本地服務和遠端服務：
| 傳輸模式 | 適用場景 | 主要設定項 |
|---|---|---|
| stdio | 本地執行的服務，由 LanMate 透過命令啟動 | 啟動命令、參數、環境變數 |
| http | 已部署在遠端的服務，透過網路存取 | 服務 URL、HTTP 標頭資訊 |
選擇哪種模式取決於服務本身的提供方式：服務方給出一個可執行命令時使用 stdio，給出一個可存取的網址時使用 http。
加入 MCP 服務
在設定頁中進入 MCP 設定，即可查看目前已設定的全部服務，並進行加入、編輯和刪除操作。
加入前，請先從服務提供方取得該服務的接入資訊：本地服務一般是啟動命令及所需參數，遠端服務一般是存取網址及認證方式。
加入一個新服務的步驟：
- 打開設定頁，進入 MCP 設定。
- 點擊加入服務，填寫服務名稱（必填），並可補充一段描述，便於日後識別該服務的用途。
- 選擇傳輸類型（stdio 或 http）。
- 按所選模式填寫設定項：
- stdio 模式：填寫啟動命令、參數和環境變數。命令用於在本地啟動服務程序，環境變數可用於傳入 API Key 等認證資訊。
- http 模式：填寫服務 URL 和 HTTP 標頭資訊。認證資訊透過 HTTP 標頭傳入。
- 按需調整逾時時間（預設 30 秒，一般無需修改）。
- 儲存設定。系統會自動嘗試連接該服務，連接成功即可在會話中使用。
除表單填寫外，設定介面還支援 JSON 模式，習慣直接編輯設定文字的使用者可以切換使用。
加入或編輯服務時，系統會自動測試連接是否可用，並可以查看該服務提供了哪些工具，便於確認設定是否正確。即使測試連接失敗，也可以先儲存設定，待排查原因後再透過編輯修正。
管理已有服務
在 MCP 設定列表中，每個服務都會顯示名稱和連接狀態（連接中、已連接、異常），方便快速了解各服務是否可用。
已加入的 MCP 服務支援以下管理操作：
- 啟用/停用：可隨時開啟或關閉已設定的服務。停用後服務設定保留，AI 助理不再調用其工具，重新啟用即可恢復。
- 編輯：修改服務的設定資訊（如命令、URL、環境變數等），儲存後系統自動重新連接。
- 刪除：移除不再需要的服務。刪除需二次確認，確認後該服務的全部設定將被清除，且無法復原，請謹慎操作。
當服務連接出現異常時，通常與命令失效、網址變更或認證資訊過期有關，可透過編輯修改設定，儲存後自動重新連接。
在會話中使用
MCP 服務啟用後，AI 助理在會話中即可調用其提供的工具：
- 在 MCP 設定中確認目標服務已啟用且連接正常。
- 回到會話，直接向 AI 助理描述你的需求。
- AI 助理在獲得授權後，調用已啟用服務提供的工具完成任務。
AI 助理僅會調用已啟用服務的工具，未啟用或未設定的服務不會被存取。如果某項任務需要的能力暫時缺少，可以先到 MCP 設定中啟用對應服務，再回到會話繼續提問；不再需要時，回到設定中停用即可，無需刪除服務。
注意事項與安全建議
使用 MCP 服務時，請注意以下事項：
- 設定本地儲存：MCP 服務的設定資訊（命令、URL、環境變數等）儲存在本地。
- 謹慎啟用：自訂 MCP 服務的存取範圍由你的設定決定，LanMate 不預設範圍，請謹慎評估後再啟用。
- 來源可信：加入服務時，確保命令或 URL 來源可信，不要加入來源不明的服務。
- 保護敏感資訊：環境變數或 HTTP 標頭中包含敏感資訊（如 API Key）時，請注意妥善保護，避免洩漏。
- 及時清理：對於不再使用的服務，建議及時停用或刪除，減少不必要的暴露面。
如在設定過程中遇到問題，可先核對命令、URL 與認證資訊是否填寫正確，再透過編輯修正後重試連接。