结论先说
- 有官方实现,不用只靠第三方脚本:企业微信团队已正式发布官方命令行工具
@wecom/cli(仓库WecomTeam/wecom-cli),包内直接集成了标准的stdio模式 MCP Server 与配套 Agent Skills。 - 能力远超传统单向群通知:覆盖消息收发、通讯录检索、在线文档与智能表格读写、日程闲忙查询、预约会议、待办事项等核心办公模块。
- 认证走「API 模式长连接智能机器人」:不用在公网架设带固定 IP 的回调服务器,终端运行
wecom-cli init绑定后,凭证会加密保存在本机(默认~/.config/wecom/bot.enc)。 - 企业级权限不裸奔:官方在链路里叠加了人员权限与 AI 权限分离、敏感动作人工审批、授权到期自动回收与全链路日志审计四道防线。

图:本站根据 企业微信开发者中心与 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子命令、挂载为stdioMCP 服务(wecom-cli mcp-server),或者一键安装官方预置技能包(配合npx skills add用法见 /guides/npx-skills-add-cli-install-skills)。

图:本站根据 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> 格式的工具名:
- 在 Claude Code 中一行命令添加(更多范围参数见 /guides/claude-code-mcp-setup):
bash
claude mcp add wecom -s user -- wecom-cli mcp-server --transport stdio
- 在 Cursor 的
mcp.json中添加(位置说明见 /guides/cursor-mcp-config-json):
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 操作权限双重约束:机器人只能访问被明确授权的通讯录范围与自己有权限的文档;同时管理员可在企微后台开启敏感写操作的人工审批确认与授权有效期,任何调用均可在后台审计日志里查到记录。
相关教程
- /guides/claude-code-mcp-setup:Claude Code MCP 配置与管理教程
- /guides/cursor-mcp-config-json:Cursor
mcp.json配置与连接排错 - /guides/npx-skills-add-cli-install-skills:用
npx skills add安装官方技能包指南 - /guides/workbuddy-vs-codex-difference:腾讯云 WorkBuddy 与 OpenAI Codex 对比
参考资料
- 企业微信开发者中心官方文档 — https://developer.work.weixin.qq.com/
WecomTeam/wecom-cli官方 GitHub 仓库 — https://github.com/WecomTeam/wecom-cli
0 条评论
还没有评论,来抢沙发~