企业微信有官方 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 条评论

登录 后参与评论

还没有评论,来抢沙发~