Zoom MCP 会议生命周期管理REST 承担 CRUD、MCP 承担语义检索的分工与混合模式实践【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins导读在 knowledge-work-plugins 仓库的 Zoom 插件中Zoom MCP 服务器mcp-us.zoom.us为 AI Agent 提供语义化会议检索、会议资产与录制资源获取等能力但不暴露确定性的会议创建、更新、列举与删除工具。本文以 zoom-mcp/examples/meeting-lifecycle.md 为骨架结合仓库内 Zoom MCP 工具目录、OAuth 配置与 REST API 文档讲清何时用 MCP、何时改走 REST的边界并给出可复制的 MCP→REST 混合调用模式帮助你为 Agent 设计正确的会议生命周期路由策略。MCP 工具面的现状没有确定性的 CRUD 工具当前 Zoom MCP 的托管服务器对 AI Agent 暴露的能力集中在检索与内容获取方向。根据 zoom-mcp/SKILL.md 与 zoom-mcp/references/tools.md主 MCP 服务器只公开四个工具工具关键参数所需 Scopesearch_meetingsq、from、to、page_size、next_page_tokenmeeting:read:searchget_meeting_assetsmeetingId必填meeting:read:assetsget_recording_resourcemeetingId必填、types、clip_num、play_time、raw_passcode、encode_passcodecloud_recording:read:contentrecordings_listuserId必填、from、to、meeting_id、trash、trash_type、page_size、next_page_tokencloud_recording:read:list_user_recordings仓库文档明确记录在一次探测中主 MCP 服务器并未暴露list_meetings、get_meeting、create_meeting、get_user_profile、list_available_tools等被误传的旧工具名见 references/tools.md 的 Discovery Notes。这一点与 meeting-lifecycle.md 开篇的判断完全一致MCP 不提供确定性的 create / update / list / delete 会议工具。如果你需要会议生命周期管理建会、改期、删除、确定性列举请直接路由到 REST API skillrest-api/SKILL.md而不要假设 MCP 表面存在会议 CRUD。Zoom MCP 擅长什么语义检索与内容获取MCP 的价值不在改数据而在找到内容并拿回相关资源。依据 meeting-lifecycle.mdZoom MCP 适合处理以下场景对会议的语义搜索search_meetings不是简单的标题过滤而是基于 AI Companion 检索的内容级搜索覆盖会议内容、纪要关联资产与录制相关产物见 concepts/mcp-architecture.md 的 Retrieval Model会议关联资产检索get_meeting_assets返回某个会议的摘要、录制引用、关联文档、白板链接等资产包录制资源检索get_recording_resource返回含转写时间线、摘要片段、下一步行动片段、播放 URL 等录制相关资源recordings_list按用户/时间范围列举云端录制从 Markdown 创建 Zoom Docs注意这一步要走独立的zoom-docs-mcp服务器mcp.zoom.us/mcp/docs/streamable工具为create_file_with_content与get_file_content而不是主zoom-mcp服务器。完整的检索工作流按主题搜索 → 取资产与按录制列举 → 取录制资源两条路径见 examples/transcript-retrieval.md 和 examples/search-and-act.md。必须改走 REST 的操作确定性 CRUD当用户要求的是确定性的资源管理时应使用 REST API创建会议POST /v2/users/{userId}/meetings对应meetingCreate见 rest-api/references/meetings.md改期或更新会议PATCH /v2/meetings/{meetingId}部分字段更新成功返回 204确定性列举已排定的会议GET /v2/users/{userId}/meetings?typescheduledpage_size30支持next_page_token分页删除会议或单次实例DELETE /v2/meetings/{meetingId}可选occurrence_id删除周期性会议的单次发生。这些端点全部基于https://api.zoom.us/v2基础地址并且要求 REST 层面的 scope如meeting:write、meeting:read。完整可运行的 curl 与 Node.js 示例Create → Update → Get → List → Delete含 webhook 事件集成见 rest-api/examples/meeting-lifecycle.md。混合模式MCP 先行发现REST 随后管理meeting-lifecycle.md 给出的核心编排建议是当用户从会议内容/纪要意图出发时先用 MCP 完成发现与内容获取只有当下一步动作变成确定性的资源管理步骤时再切换到 REST。典型调用序列如下1. search_meetings q: client onboarding from: 2026-03-01 to: 2026-03-06 2. get_meeting_assets meetingId: MEETING_ID_OR_UUID 3. 如果用户随后想改期或删除该会议 则路由到 zoom-rest-api在那里执行 CRUD 操作。这一模式在 examples/search-and-act.md 中同样被强调search_meetings拿到目标会议 →get_meeting_assets检查资产 → 遇到create / reschedule / update settings / delete类需求时明确路由到 rest-api/SKILL.md。实际工程中还可以扩展为更完整的混合管线MCP 语义搜索用户只记得上季度关于某主题的会用search_meetings按关键词与时间窗找回MCP 资产/录制检查get_meeting_assets或get_recording_resource确认目标并取回纪要、转写、录制引用REST 确定性操作用户要求把这会改到周五下午或删掉 3 月 10 号的周会切换到 REST 执行PATCH /v2/meetings/{meetingId}或DELETE /v2/meetings/{meetingId}可选事件驱动闭环借助 webhook 事件meeting.created、meeting.updated、meeting.deleted、meeting.started、meeting.ended、recording.completed驱动后续自动化参见 rest-api/examples/meeting-lifecycle.md 的 Webhook Integration 章节。应当路由到 REST 的示例 Prompt仓库文档给出了四类典型的、Agent 应判定为改走 REST的用户表述见 meeting-lifecycle.mdCreate a 45-minute design review for next Tuesday.—— 新建会议 →POST /v2/users/{userId}/meetings设置type: 2定时会议、duration: 45、start_timeMove my Q1 planning meeting to Friday at 3pm Pacific.—— 改期 →PATCH /v2/meetings/{meetingId}更新start_time与timezoneDelete the team sync meeting scheduled for March 10th.—— 删除 →DELETE /v2/meetings/{meetingId}Show me all my scheduled meetings for this week.—— 确定性列举 →GET /v2/users/{userId}/meetings?typescheduled配合时间过滤。反向地如果用户表述是找一下关于某主题的会并总结拉取上周全员会的录制资源则留在 MCP 侧即可。为什么是这种分工仓库证据链1. 工具目录与 Scope 设计主 Zoom MCP 服务器通过 OAuth protected-resource 元数据声明的 scope 家族为见 concepts/mcp-architecture.md 与 references/tools.mdai_companion:read:search—— 跨会议/聊天/文档的语义搜索meeting:read:search、meeting:read:assets—— 会议搜索与资产读取cloud_recording:read:list_user_recordings、cloud_recording:read:content—— 录制列举与内容读取docs:write:import、docs:read:export—— Zoom Docs 导入/导出。全部是read / 内容侧scope没有任何meeting:write一类的写权限这与CRUD 不在 MCP 表面的定位互为印证。而 REST API skill 明确要求meeting:write、meeting:read才能做会议管理见 rest-api/SKILL.md 的 Prerequisites 与 rest-api/examples/meeting-lifecycle.md。2. 认证模型差异MCP 走General app 用户级 OAuthtoken 由插件通过 .mcp.json 中以Authorization: Bearer ${ZOOM_MCP_ACCESS_TOKEN}注入到https://mcp-us.zoom.us/mcp/zoom/streamableStreamable HTTP另有 SSE fallbackREST 侧则更常使用 Server-to-Server OAuth 做服务端自动化。注意MCP 使用的粒度化 scope 与旧的宽泛 REST scope 不是同一套配置 token 时务必核对 MCP 专属 scope见 concepts/oauth-setup.md。3. 错误码印证references/error-codes.md 记录了 MCP 协议层错误-32001无效 access token、-32602找不到工具、-32603调用处理失败以及各工具缺失 scope 时的精确报错如search_meetings缺meeting:read:search、get_meeting_assets缺meeting:read:assets。当 Agent 试图在 MCP 上执行不存在的工具时-32602 Can not found tool会直接出现——这正是不要在 MCP 上做 CRUD最直观的运行时证据。REST 侧落地要点与常见陷阱把 CRUD 落到 REST 后以下要点来自 rest-api/examples/meeting-lifecycle.md 与 rest-api/SKILL.md值得在实现路由时一并考虑会议类型type: 1即时会议、type: 2定时会议、type: 3周期性无固定时间/PMI、type: 8周期性固定时间me关键字规则用户级 OAuth 应用必须用me代替userIdServer-to-Server OAuth 应用禁止用me需显式传 host 用户 ID 或邮箱Meeting ID 与 UUID以/开头或含//的 UUID 需要双重 URL 编码时间格式yyyy-MM-ddTHH:mm:ssZ表示 UTC无Z时表示本地时间配合timezone字段限流与配额限流按账号共享而非按应用隔离单个用户每天的会议创建/更新操作硬限制为100 次UTC 00:00 重置批量操作应分摊到不同 host 用户删除响应PATCH/DELETE成功通常返回 204 No Content周期性会议可通过occurrence_id只删单次。# 以用户级 OAuth 为例创建 45 分钟定时会议对应上文第一个示例 Prompt curl -X POST https://api.zoom.us/v2/users/me/meetings \ -H Authorization: Bearer ACCESS_TOKEN \ -H Content-Type: application/json \ -d { topic: Design Review, type: 2, start_time: 2026-09-22T15:00:00Z, duration: 45, timezone: America/Los_Angeles, settings: { join_before_host: false, waiting_room: true } }给 Agent 的路由决策清单综合 meeting-lifecycle.md 与 examples/search-and-act.mdAgent 可按以下规则决策用户意图走哪条路关键工具/端点按讨论内容/主题/时间范围找会议MCPsearch_meetings→get_meeting_assets取某会议的纪要、关联文档、录制引用MCPget_meeting_assets取转写/摘要/播放类录制资源MCPrecordings_list→get_recording_resource从纪要生成 Zoom DocsMCPDocs 专用服务器create_file_with_content创建 / 改期 / 更新设置 / 删除会议RESTPOST/PATCH/DELETE /v2/meetings...确定性列举本周已排定会议RESTGET /v2/users/{userId}/meetings?typescheduled记住一条总原则MCP 负责发现与理解REST 负责确定性的增删改查。先判断用户是否真的需要资源管理操作再决定路由能最大程度避免-32602 Can not found tool一类的误调用也让 Agent 的会议生命周期处理既快又稳。延伸阅读zoom-mcp/SKILL.md主 MCP 服务器完整工具目录、端点、错误速查zoom-mcp/references/tools.md各工具参数与实时 schema 注意事项zoom-mcp/examples/transcript-retrieval.mdMCP 检索两条主路径zoom-mcp/examples/search-and-act.md搜索-行动模式与 REST 交棒时机zoom-mcp/concepts/oauth-setup.mdMCP 专属 scope 与 token 生命周期rest-api/SKILL.mdREST API 总览、base URL、限流与陷阱rest-api/examples/meeting-lifecycle.md会议 CRUD 完整可运行示例与 webhook 集成【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考