02 · 連接器
連接器是什麼
連接器是 WorkBuddy 與外部服務之間的橋。 配好之後，WorkBuddy 就能直接訪問和操作第三方服務——讀你的郵件、寫你的騰訊文件、查你的會議安排。
技術形態上分兩種：
- MCP + CLI（標準化協議）
- Skill + CLI（內建指令碼）
兩者在資料收集和權限邊界上遵循一致的原則，你日常使用時感受不到區別。
當前官方支援 QQ 郵箱、騰訊文件、騰訊樂享、騰訊會議、TAPD、騰訊網盤，並支援自定義連接器。
四類典型用法
| 場景 | 說明 | 示例 |
|---|---|---|
| 資料查詢 | 從外部資料來源獲取資訊 | 查資料庫、檢索文件 |
| 服務呼叫 | 呼叫第三方 API 完成操作 | 傳送郵件、建立日程 |
| 檔案管理 | 訪問雲端儲存與檔案系統 | 讀網盤檔案、上傳附件 |
| 訊息通知 | 與即時通訊工具整合 | 發企業微信 / 飛書訊息 |
在哪管理
左側導航欄點「连接器」進入管理頁面，能看到所有可用連接器。輸入框上也有快捷管理入口，不用來回切頁面。
示例：連線 QQ 郵箱
QQ 郵箱連接器支援收發、搜尋和整理 QQ 郵件——用自然語言讀取郵件內容、彙總郵件執行緒、管理資料夾。
流程五步：
- 點新增——在連接器管理頁找到 QQ 郵箱卡片，點右側的
+發起連線。 - 掃碼授權——系統跳轉到 QQ 郵箱授權頁顯示二維碼。用 QQ 郵箱 App（7.1.5 / 鴻蒙 0.2.9 及更新版本）掃碼。
- 確認權限——在手機端確認申請的訪問權限：
- 賬號資訊：獲取郵箱賬號基礎資訊
- 讀取郵件：讀取收件箱內近一個月的郵件
- 傳送郵件：代為傳送郵件
- 刪除郵件（可選）：已刪除郵件會移入「已刪除」資料夾
- 授權成功——手機端顯示成功。後續可在「設定 - 賬號 - 安全管理 - 登入裝置和授權碼 - 應用授權」中管理。
- 連線完成——回到 WorkBuddy，卡片旁出現綠色圓點，右側顯示啟用 / 停用開關。
授權成功時別關網頁
授權成功時要點瀏覽器彈窗中的「開啟」完成連線。取消或直接關掉網頁可能導致操作中斷，需要重新配置連接器。
示例：連線騰訊樂享
騰訊樂享連接器支援搜尋、建立和管理樂享知識庫中的文件，支援匯入 Markdown、按標籤整理內容、追蹤團隊文件的更新動態。
- 點新增——找到騰訊樂享卡片，點
+。 - 確認授權——授權確認頁會說明通過樂享知識庫 MCP，WorkBuddy 將能夠：按你擁有的權限訪問知識庫、搜尋查詢內容、協助建立與管理內容。確認後點「立即前往授權」。
- 登入樂享——支援微信登入、手機號登入。
- 授權成功——頁面顯示賬號資訊和 WorkBuddy 將獲取的權限，確認後點「繼續」。
- 連線完成——回到 WorkBuddy，卡片旁出現綠色圓點。
其它官方連接器的流程大同小異：找卡片 → 點 + → 跳轉授權 → 確認權限 → 回到客戶端看綠點。
自定義連接器
需要接入其它外部服務時，點連接器管理頁右上角的「自定义连接器」，安裝自定義的 MCP 服務。
配置方式與 MCP 配置類似，詳見 MCP 與外掛。
自定義連接器的範圍由你決定
官方免責宣告寫得很直白：自定義連接器的訪問範圍由你的配置決定，WorkBuddy 不預設範圍。 請審慎評估後再啟用。
也就是說，官方連接器的權限邊界是經過設計的，自定義連接器的邊界是你自己劃的。
斷開連接器
- 點已連線的連接器卡片，在彈窗中點左側的「解绑」。
- 系統提示已斷開，連接器恢復為未連線狀態。
QQ 郵箱這類還可以從服務方那邊撤銷：QQ 郵箱 App →「設定 - 賬號 - 安全管理 - 應用授權」。
定期清一遍
不再使用的連接器建議及時撤銷授權。憑據放著不用不會自己失效，但會一直是一把有效的鑰匙。
權限與資料邊界
官方列出的收集項：
| 收集項 | 型別 | 用途 |
|---|---|---|
| 第三方賬號標識 | 必要 | 郵箱地址、賬號 ID，用於在第三方服務中識別你 |
| 授權憑據 | 必要 | OAuth Access / Refresh Token，或你手填的 API 金鑰 |
| 第三方業務資料 | 必要 | 僅在你的指令觸發時按需讀取（郵件、文件、知識庫、會議、TAPD 資料等） |
| 使用者寫入資料 | 非必要 | 代發郵件、建立 / 編輯文件、建立會議等，需你明確指令確認 |
三條邊界規則：
- 每個連接器獨立授權——裝了郵箱不等於裝了文件
- 不主動定時抓取——只在你的指令觸發時讀
- 不超出你已有權限範圍——你在樂享裡看不到的文件，它也看不到
積分怎麼算
連接器自身的讀寫不消耗積分。
消耗發生在 WorkBuddy 對外部資料進行理解、彙總的時候。
這個區分挺重要：「把我今天的郵件列出來」很便宜；「讀完這 40 封郵件，按專案歸類，告訴我哪些需要今天回」就貴了——貴的是後半句。
安全建議
它以你本人的身份行動
連接器呼叫所產生的對第三方服務的訪問、讀寫、訊息傳送，均以你本人身份與授權範圍執行。
所以：涉及對外發送、內容修改前，再確認一次目標物件與內容。 一封發錯人的郵件是收不回來的。
- API 金鑰與 Token 是鑰匙。 妥善保管，避免在公共裝置或共享環境填寫。
- 定期檢查連接器狀態，確保服務正常執行。
- 第三方服務的可用性和內容真實性由其自身決定。 遇到介面異常或服務變更，先去看那家的服務狀態與協議。
常見問題
Q：連接器和技能怎麼選？
需要對接的是官方支援的服務（QQ 郵箱、騰訊文件、樂享、會議、TAPD、網盤）就用連接器——授權流程和權限邊界是現成的。其它服務走自定義連接器或 MCP。
Q：連接器斷開後，之前的任務記錄還在嗎？
在。斷開隻影響後續呼叫。
Q：專案裡的連接器和我個人的連接器是一回事嗎？
不是。專案裡的連接器按授權方式分「公共授权」（管理員配一次、全員共用同一套票據）和「个人授权」（每位成員各自授權自己的賬號，票據不共享）。協作任務中個人授權連接器全部停用，只有公共授權連接器可用。 詳見 專案與團隊協作。
下一步
03 MCP 與外掛——接入官方清單之外的任何服務。