Zoom Automation via Rube MCP 是一套通过 Composio 的 Zoom 工具集,经由 Rube MCP 来自动执行 Zoom 操作的能力封装,涵盖会议排期、网络研讨会管理、云录制获取、参会者跟踪与用量报告等。
用途与前提
使用前需满足:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 配置 toolkit 为 zoom 的活动连接;每次操作应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。多数功能需要付费 Zoom 账号(Pro 或更高)。
设置方式
在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API key,添加端点即可使用;确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用;调用 RUBE_MANAGE_CONNECTIONS(toolkit 为 zoom);若连接不是 ACTIVE,按返回的授权链接完成 Zoom OAuth;确认连接状态为 ACTIVE 后再执行工作流。
核心工作流
-
创建与排期会议:依次可能使用 ZOOM_GET_USER(校验用户与许可证)、ZOOM_CREATE_A_MEETING(创建,必选)、ZOOM_GET_A_MEETING、ZOOM_UPDATE_A_MEETING、ZOOM_ADD_A_MEETING_REGISTRANT。关键参数包括 userId(用户级应用用 "me")、topic、type(1 即时、2 排期、3 无固定时间循环、8 固定时间循环)、start_time、timezone、duration、settings__auto_recording、settings__waiting_room、settings__join_before_host、settings__meeting_invitees。注意 start_time 必须在未来,Zoom 统一以 UTC 存储与返回;type 2 未设 start_time 会变为 30 天后过期的即时会议;join_url 与 start_url 需从创建响应中保存;start_url 2 小时后过期(custCreate 用户为 90 天);会议创建限 100 请求/天;嵌套设置名使用双下划线。
-
会议列表与管理:使用 ZOOM_LIST_MEETINGS(必选),可配合 ZOOM_GET_A_MEETING、ZOOM_UPDATE_A_MEETING。参数含 userId、type(scheduled、live、upcoming、upcoming_meetings、previous_meetings)、page_size、next_page_token、from/to。注意该列表不含即时会议且仅显示未过期的排期会议;查历史会议用 previous_meetings;需跟随 next_page_token 直至为空;token 15 分钟后过期;会议 ID 可能超过 10 位,应以长整型存储。
-
录制管理:使用 ZOOM_LIST_ALL_RECORDINGS(必选),可配合 ZOOM_GET_MEETING_RECORDINGS、ZOOM_DELETE_MEETING_RECORDINGS、ZOOM_LIST_ARCHIVED_FILES。参数含 from/to(yyyy-mm-dd,最长 1 个月)、meetingId、action(trash 可恢复,delete 永久)、include_fields(download_access_token)、trash。注意需账号启用云录制;以 / 开头或含 // 的 UUID 需双重 URL 编码;删除默认 trash,delete 为永久;受密码保护的录制下载 URL 需在 Authorization 头带 OAuth token;需 Pro 或更高。
-
参会者与报告:使用 ZOOM_GET_PAST_MEETING_PARTICIPANTS(必选),可配合 ZOOM_GET_A_MEETING、ZOOM_GET_DAILY_USAGE_REPORT、ZOOM_GET_A_MEETING_SUMMARY。参数含 meetingId(最新实例用 ID,特定场次用 UUID)、page_size、next_page_token。注意参会者接口仅适用于付费套餐的已完成会议;单人会议返回空;UUID 需双重编码;应持续分页;会议摘要需付费套餐并启用 AI Companion,免费账号返回 400;每日用量报告有严格限流。
-
网络研讨会:使用 ZOOM_LIST_WEBINARS(必选),可配合 ZOOM_GET_A_WEBINAR、ZOOM_ADD_A_WEBINAR_REGISTRANT。参数含 userId、type(scheduled、upcoming)、page_size、next_page_token。注意需 Pro 或更高并加购 Webinar;免费/基础账号无法使用;仅显示未过期研讨会;注册接口要求研讨会已启用注册。
常见模式与陷阱
ID 解析:用户级应用用 "me";会议 ID 为数字并作长整型存储;UUID 用于循环会议特定场次,必要时双重编码;occurrence ID 用于定位循环场次。分页:多数列表端点采用 token 分页,持续跟随 next_page_token,token 15 分钟过期,显式设置 page_size,不使用已弃用的 page_number。时间处理:内部统一 UTC,提供 timezone 字段以输入本地时间,ISO 8601 格式,日期字段用 yyyy-mm-dd。已知限制:多数录制与参会者功能需 Pro 或更高;Webinar 需加购;AI 摘要需 AI Companion;归档文件需 Zoom Support 启用归档。限流包括会议创建 100 次/天、每会议 24 小时内 100 次更新、参会者接口中等限流、用量报告严格限流、获取会议与录制为轻度限流、列表为中等限流。参数特性:嵌套设置用双下划线,start_url 2 小时过期,waiting_room 为 true 时 join_before_host 自动禁用,循环字段仅适用于 type 3 与 8,password 最多 10 字符且仅限字母数字与 @ - _ *。
快速参考
创建会议 ZOOM_CREATE_A_MEETING(userId、topic、start_time、type);获取详情 ZOOM_GET_A_MEETING(meetingId);更新 ZOOM_UPDATE_A_MEETING;列表 ZOOM_LIST_MEETINGS(userId、type、page_size);用户信息 ZOOM_GET_USER;录制列表 ZOOM_LIST_ALL_RECORDINGS(userId、from、to);获取录制 ZOOM_GET_MEETING_RECORDINGS;删除录制 ZOOM_DELETE_MEETING_RECORDINGS(meetingId、action);历史参会者 ZOOM_GET_PAST_MEETING_PARTICIPANTS(meetingId、page_size);每日用量 ZOOM_GET_DAILY_USAGE_REPORT;会议摘要 ZOOM_GET_A_MEETING_SUMMARY;研讨会列表 ZOOM_LIST_WEBINARS(userId、type);获取研讨会 ZOOM_GET_A_WEBINAR;会议注册 ZOOM_ADD_A_MEETING_REGISTRANT;研讨会注册 ZOOM_ADD_A_WEBINAR_REGISTRANT;归档文件 ZOOM_LIST_ARCHIVED_FILES(from、to)。