企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
8 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

  1. 有官方實現,不用只靠第三方腳本:企業微信團隊已正式發佈官方命令行工具 @wecom/cli(倉庫 WecomTeam/wecom-cli),包內直接集成了標準的 stdio 模式 MCP Server 與配套 Agent Skills。
  2. 能力遠超傳統單向群通知:覆蓋消息收發、通訊錄檢索、在線文檔與智能表格讀寫、日程閒忙查詢、預約會議、待辦事項等核心辦公模組。
  3. 認證走「API 模式長連接智能機器人」:不用在公網架設帶固定 IP 的回調伺服器,終端運行 wecom-cli init 綁定後,憑證會加密儲存在本機(預設 ~/.config/wecom/bot.enc)。
  4. 企業級權限不裸奔:官方在鏈路裏疊加了人員權限與 AI 權限分離、敏感動作人工審批、授權到期自動回收與全鏈路日誌審計四道防線。

企業微信官方 CLI 與 MCP 能力一覽

圖:本站根據 企業微信開發者中心與 WeComTeam 官方倉庫 整理的示意圖

本文根據企業微信開發者中心官方文檔與騰訊企業微信團隊開源倉庫 WecomTeam/wecom-cli 整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是騰訊或企業微信官方網站。

適用於誰

  • 搜「企業 微信 有 mcp 嗎」「企業微信 mcp server 官方」「wecom cli 怎麼用」的人;
  • 以前只用過舊版群聊 Webhook 機器人(只能單向往群裏推文本,讀不了在線文檔和日程),想讓 Claude Code、Cursor 或 WorkBuddy 安全讀寫企微辦公數據的開發者;
  • 關心把 AI 接進企業微信後,通訊錄和內部文檔權限怎麼隔離、敏感操作怎麼留痕的管理員。

一、官方 @wecom/cli 和早期民間群機器人 MCP 差在哪

在官方發佈之前,GitHub 上有不少名字帶 wecom-mcp 的社區小工具,絕大多數只是把舊版「群機器人 Webhook 地址」包了一層——它們只能往指定群發消息,既不能查某個同事的閒忙日程,也讀不了企業微信在線文檔和智能表格。

企業微信官方推出的 @wecom/cli 則直接打通了企業微信底層的 AI 開放能力接口,具備兩個明顯工程優勢:

  • 免公網回調部署(長連接通道):過去調企業微信自建應用 API 往往要在雲伺服器上配域名、驗籤和固定出口白名單;現在基於智能機器人的長連接模式,在你自己的筆記本終端裏就能直接雙向通信;
  • 一份工具同時提供三種調用姿勢:人類或腳本直接敲 wecom-cli 子命令、掛載為 stdio MCP 服務(wecom-cli mcp-server),或者一鍵安裝官方預置技能包(配合 npx skills add 用法見 /guides/npx-skills-add-cli-install-skills)。

安裝配置 @wecom/cli 與 MCP 四步

圖:本站根據 WecomTeam/wecom-cli 官方文檔 整理的示意圖

二、四步完成安裝、登入初始化與本地驗證

第一步:通過 npm 全局安裝

確保本機已安裝 Node.js 環境,在終端執行:

bash
npm install -g @wecom/cli

第二步:在企微創建長連接智能機器人並執行 init

在終端運行初始化嚮導:

bash
wecom-cli init

按官方指南,你可以通過掃碼快捷完成綁定,也可以在企業微信工作台或管理後台進入「智能機器人」選擇手動創建:模式選 API 模式,連接方式勾選 使用長連接,設定好可見範圍與數據權限後,把拿到的 Bot ID 和 Secret 填入終端提示。校驗通過後,密鑰會加密落盤在本機配置目錄中,避免在項目源碼裏明文暴露。

第三步:在命令行跑通第一條業務查詢

CLI 採用統一的 wecom-cli <業務模組> <方法名> '<JSON參數>' 格式。裝進大模型前,先在終端手工敲一條幫助或測試命令確認權限已通:

bash
# 查看當前版本支持的全部模組(如 contact、doc、msg、schedule、meeting、todo)
wecom-cli --help

# 查看文檔模組下的具體方法說明
wecom-cli doc --help

# 示例:新建一份在線文檔
wecom-cli doc create_doc '{"doc_type": 3, "doc_name": "迭代排期彙總"}'

第四步:作為 MCP Server 接入 Claude Code 或 Cursor

驗證命令行暢通後,就能把它註冊成標準本地 stdio MCP 伺服器。內置服務會把各個模組下的方法自動映射成 <category>.<method> 格式的工具名:

bash
  claude mcp add wecom -s user -- wecom-cli mcp-server --transport stdio
  
json
  {
    "mcpServers": {
      "wecom": {
        "command": "wecom-cli",
        "args": ["mcp-server", "--transport", "stdio"]
      }
    }
  }
  

如果你平時在騰訊生態桌面工具鏈裏辦公,也可以順帶對照我們前面整理的 WorkBuddy 與 Codex 差異說明(見 /guides/workbuddy-vs-codex-difference);而在 Claude Code 終端裏高頻串聯企微文檔與代碼庫聯調時,個人官方訂閱額度說明可參考 /chongzhi/claude-code。

常見問題

Q:支持遠程 HTTP 方式把 wecom-cli mcp-server 暴露到公網給全組共用嗎?

按 WecomTeam/wecom-cli 倉庫說明,內置的 mcp-server 子命令目前專注本地 stdio 標準輸入輸出傳輸模式,綁定本機加密儲存的機器人授權。團隊成員使用時,應各自在受控工作機上按最小可見範圍初始化獨立授權,不要把個人初始化後的加密憑證文件拷給他人共用。

Q:AI 會不會不小心給全公司大群亂髮消息或刪掉別人的文檔?

受企業微信後台的機器人可見範圍與 AI 操作權限雙重約束:機器人只能訪問被明確授權的通訊錄範圍與自己有權限的文檔;同時管理員可在企微後台開啟敏感寫操作的人工審批確認與授權有效期,任何調用均可在後台審計日誌裏查到記錄。

相關教學

參考資料

  • 企業微信開發者中心官方文檔 — https://developer.work.weixin.qq.com/
  • WecomTeam/wecom-cli 官方 GitHub 倉庫 — https://github.com/WecomTeam/wecom-cli

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  2. 02

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  3. 03

    A2A 協議是什麼、怎麼用:Agent2Agent 智能體互聯規範、名片發現與 Python 接入流程

    A2A(Agent2Agent)是由 Google 發起並移交 Linux 基金會託管的開放智能體通信協議,用來讓不同團隊、不同框架開發的獨立智能體跨網絡互相派單協作。本文按官方規範講清 Agent Card、Task 狀態機與 Python SDK 接入步驟。

    Gemini其他 AI 工具0
  4. 04

    AutoGen 現在怎麼樣了?微軟官方演進路線與 Microsoft Agent Framework 入門

    搜 AutoGen 新教學常被 0.2、0.4、社區分支和 Semantic Kernel 繞暈。按微軟官方文檔,微軟已將 AutoGen 與 Semantic Kernel 兩支團隊合併推出統一的開源框架 Microsoft Agent Framework。本文講清現狀與 Python 快速上手。

    ChatGPT其他 AI 工具0
  5. 05

    CrewAI 多輪對話與記憶怎麼配:memory=True 三層記憶、人工介入與 Flows 狀態持久化

    剛用上 CrewAI 的人常疑惑 kickoff 跑完就結束,怎麼做多輪連續對話與跨次記憶。本文按官方文檔拆解 memory=True 的短期/長期/實體三層記憶、嵌入模型配置,以及用 Flows 狀態流和 @persist 搭建多輪會話的實戰寫法。

    其他 AI 工具0
  6. 06

    CrewAI 入門教學:Agent 角色、Task 任務、執行流程(Process)與第一個團隊示例

    CrewAI 是主打「擬人化角色分工」的 Python 多智能體開源框架。本文按官方文檔講清安裝要求、Agent(角色/目標/背景)、Task(任務描述與預期輸出)和 Process(順序接力與經理層級模式)的配合邏輯,並給出最小可運行代碼。

    其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~