03 · MCP 與外掛

MCP 是什麼

MCP（Model Context Protocol，模型上下文協議）用於把外部工具和服務接進 WorkBuddy，讓 AI 獲得傳送通知、連線業務系統、訪問資料來源這些擴充套件能力。

官方的比喻是「AI 的 USB 介面」——就像電腦通過 USB 連外設，MCP 讓 AI 連各種外部工具和資料來源。

WorkBuddy 已經把 MCP 配置整合到介面裡，不需要編碼、不需要手動改配置檔案，視覺化操作就能完成接入。

它帶來什麼

能力	說明
上下文共享	向模型提供檔案內容、資料庫記錄、業務資訊等上下文
工具呼叫	把檔案讀寫、介面呼叫、訊息傳送等能力暴露給模型
可組合工作流	多個工具和服務通過 MCP 串聯，組成自動化流程
資料控制	支援本地或受控方式執行，兼顧靈活性與安全性

想找現成的 MCP 服務，可以去騰訊雲 MCP 市場看看開放生態裡有什麼。

兩個配置級別

級別	適用場景	配置檔案路徑
使用者級	配置一次，所有專案複用	`~/.workbuddy/mcp.json`
專案級	僅當前專案生效，互不影響	`<项目目录>/.workbuddy/mcp.json`

怎麼選：

頻繁跨專案使用的能力 → 使用者級。企微機器人通知、公共知識庫這類，配一次全域性能用。
僅特定專案需要的專屬服務 → 專案級。客戶 A 的 CRM 介面不應該出現在客戶 B 的專案裡。

完整示例：接入企微機器人

以企業微信機器人（WeCom Bot）為例走一遍完整流程。這是官方推薦的入門 MCP——路徑清晰、結果立刻可見。

1）獲取 WebHook URL

在企業微信群裡：新增群機器人 → 獲取 WebHook URL。

地址長這樣：

text

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

2）開啟 MCP 配置入口

側邊欄「插件」→ 右上角「MCP 服务器」→「配置 MCP」。

3）填寫 mcp.json

把下面這段粘進編輯器，把 your-webhook-url 換成實際地址後儲存：

json

{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

4）確認狀態

儲存後看 MCP Server 的狀態指示燈：

狀態	含義
🟢 綠色	連線成功，可正常使用
🔴 紅色	配置異常，檢查配置內容、命令環境或地址

5）用起來

配好之後用自然語言描述需求就行，WorkBuddy 會自動呼叫對應的 MCP Server：

text

请通过企业微信机器人通知：正式产品已发布，请 @张三 进行验收。

適用場景

場景	說明
釋出通知	版本上線後自動通知專案群相關人員
任務提醒	把待辦、驗收、協作事項同步到企微群
流程打通	連線 WorkBuddy 任務處理與外部平臺
能力擴充套件	通過更多 MCP Server 呼叫豐富的外部服務

最佳實踐

配置建議

公共能力配使用者級——通知類能力配置一次，多專案複用
專屬接入配專案級——獨立配置，避免互相影響
從成熟示例起步——先接 WeCom Bot 這種路徑清晰的，跑通了再折騰複雜的
描述儘量明確——說清通知物件、內容、是否需要 @，呼叫效果更穩定

安全提示

妥善保管 WebHook URL——它就是機器人的呼叫憑證，洩露了任何人都能往你的群裡發訊息
檢查 JSON 格式——配置失敗時優先確認括號、引號是否完整。這是最常見的失敗原因
關注狀態指示燈——綠色可用，紅色需排查

外掛：把一組能力打包

外掛用於打包分發一組相關能力。 一個外掛可以同時包含技能、外部工具連線、快捷指令、自動化規則等元件，安裝後統一使用。

外掛由什麼組成

元件	說明	示例
技能（Skills）	教會 AI 完成某類任務的方法與流程	—
MCP 連線	對接外部服務	連線郵箱、網盤
快捷指令（Slash Commands）	在對話方塊輸入簡短命令觸發功能	輸入 `/周报` 一鍵生成周報
自動化規則（Hooks）	在特定時機自動執行操作	生成檔案後自動檢查格式
智慧體（Agents）	針對特定任務的專屬 AI 助手	—

不同外掛包含的元件數量可能不同，但安裝與使用方式保持一致。

外掛市場

瀏覽推薦外掛，按需一鍵安裝。已安裝的可以啟用、停用、更新。點外掛卡片進行單獨管理：

更新——獲取外掛最新版本
啟用 / 停用——按需開關

外掛市場支援關鍵詞搜尋。

外掛 vs 技能怎麼選

需要單一能力 → 裝技能。需要一整套配合工作的能力（比如「週報」這件事需要一個技能 + 一個快捷指令 + 一條定時規則）→ 找外掛。

外掛的價值是省掉你自己組裝的功夫，代價是你要一次性接受它帶的全部元件。裝之前看清楚元件清單。

自定義模型

順帶說一下模型接入，因為它和 MCP 一樣屬於「把外部東西接進來」這一類。

在設定 → 模型裡通過圖形介面管理自定義模型，不需要操作配置檔案。配置儲存後自動持久化；選擇標準供應商時，工具呼叫、圖片輸入等能力標記會自動寫入。

三種接入方式

提供商接入。 從提供商列表中選擇，URL、模型列表、能力標記會自動填充，只需補全 API Key。支援騰訊雲 Token Plan（個人版 / 企業版多個套餐檔位）、各家 Coding Plan，以及主流廠商的預設入口。

本地部署。 接 Ollama——開源的本地大模型執行工具，裝好後一行命令拉取並執行開源模型，預設監聽 11434 埠，自動提供相容 OpenAI 協議的介面。適合三種場景：

資料隱私 / 內網合規：程式碼與對話內容不出本機
零成本試用：不消耗 Token、不用付費 API Key
離線可用：飛機上、內網開發機、沒網的環境

自定義。 服務不在列表裡，手填 URL、API Key 與模型名。

自定義協議

當模型服務使用非標準 URL 路徑（比如經過閘道器或代理層封裝）時，在高階配置裡開啟「自定义协议」開關：

狀態	行為
關閉（預設）	使用標準 `/chat/completions` 路徑，自動校驗並補全介面地址
開啟	直接使用你填寫的介面地址發起請求，跳過路徑校驗與自動補全

費用不走積分

自定義模型產生的全部費用（Token、訂閱）由你向第三方支付。WorkBuddy 只作通訊鏈路，把你的輸入直接轉發給該模型，輸出由該模型直接返回。

使用過程中可能持續觸發模型呼叫，建議密切關注你在第三方的賬戶費用，避免出現超出預期的支出——這部分開銷在 WorkBuddy 的積分賬單裡是看不到的。

老配置仍然有效

已經通過 ~/.codebuddy/models.json 配置的自定義模型在介面升級後仍可正常使用，並可通過 UI 檢視、編輯或刪除，不需要再直接操作配置檔案。

常見問題

Q：MCP Server 一直是紅燈怎麼辦？

按順序排查：JSON 格式（括號、引號、逗號）→ command 指定的執行時裝了沒（uvx、npx 之類）→ URL 或憑證對不對 → 網路能不能到目標地址。

Q：MCP 和連接器是一回事嗎？

連接器是產品層的概念，官方連接器背後有一部分就是 MCP 實現的。自定義連接器本質上就是讓你接自己的 MCP 服務。你可以把連接器理解成「官方已經幫你配好的 MCP」。

Q：專案級配置會被同步到團隊成員嗎？

專案級 mcp.json 在專案目錄下，跟著專案走。但專案的連接器授權分公共和個人兩種，憑據的處理規則不同，見專案與團隊協作。

下一步

04 專家與專家團——給它一個專業身份。

03 · MCP 與外掛 ​

MCP 是什麼 ​

它帶來什麼 ​

兩個配置級別 ​

完整示例：接入企微機器人 ​

1）獲取 WebHook URL ​

2）開啟 MCP 配置入口 ​

3）填寫 mcp.json ​

4）確認狀態 ​

5）用起來 ​

適用場景 ​

最佳實踐 ​

外掛：把一組能力打包 ​

外掛由什麼組成 ​

外掛市場 ​

自定義模型 ​

三種接入方式 ​

自定義協議 ​

常見問題 ​

下一步 ​