mcpField
Z
zoom-general

zoom-general

github.com/anthropics开发33.6k2.1k 次安装1 天前更新
代码仓库

关于 zoom-general

面向 Zoom 跨产品开发问题的技能，用于识别产品需求并串联合适的专用技能。它提供 API、SDK、事件、OAuth 与 MCP 的路由指引，并说明遇到相近路径时如何澄清需求。

主要功能

  1. 01识别 Zoom 产品信号
  2. 02选择主要技能并串联辅助技能
  3. 03区分 REST API、SDK 与 MCP 路径
  4. 04处理路由歧义与澄清
  5. 05提供常见集成场景索引

适用场景

  1. 01为会议创建和事件处理选择技能链
  2. 02区分确定性 API 自动化与 AI 工具编排
  3. 03规划 SDK 嵌入或自定义视频体验
  4. 04路由 Zoom MCP 与 Whiteboard MCP 需求

MCP 相关

该技能将 AI Agent 工具编排需求路由到 zoom-mcp，并提供 MCP 与 REST API 混合方案的判断指引；也包含 Zoom 托管 MCP 的传输和产品范围说明。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/anthropics/knowledge-work-plugins --skill zoom-general

安装后在 Claude Code 中输入/zoom-general确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

RUNBOOK.md
references/
app-types.md
authentication.md
authorization-patterns.md
automatic-skill-chaining-rest-webhooks.md
community-repos.md
distributed-meeting-fallback-architecture.md
environment-variables.md
interview-answer-routing.md
known-limitations.md
marketplace.md
meeting-webhooks-oauth-refresh-orchestration.md
query-routing-playbook.md
routing-implementation.md
scopes.md
sdk-logs-troubleshooting.md
sdk-upgrade-guide.md
sdk-upgrade-workflow.md
use-cases/
ai-companion-integration.md
ai-integration.md
apis-vs-mcp-routing.md
backend-automation-s2s-oauth.md
collaborative-apps.md
contact-center-app-lifecycle-and-context-switching.md
contact-center-integration.md
custom-meeting-ui-web.md
custom-video.md
customer-support-cobrowsing.md
electron-meeting-embed.md
embed-meetings.md

详细介绍

Zoom 通用（跨产品技能）

跨产品 Zoom 问题的背景参考。优先使用工作流技能，然后将本文件用于共享平台指导和路由细节。

zoom-general 如何路由复杂的开发者查询

将 zoom-general 用作分类和链式调用层：

  1. 检测查询中的产品信号
  2. 选择一个主技能
  3. 为认证、事件或部署相关环节附加次要技能
  4. 仅当两个路由匹配度相近时，才提出一个简短的澄清问题

最小实现：

type SkillId =
  | 'zoom-general'
  | 'zoom-rest-api'
  | 'zoom-webhooks'
  | 'zoom-oauth'
  | 'zoom-meeting-sdk-web-component-view'
  | 'zoom-video-sdk'
  | 'zoom-mcp';

const hasAny = (q: string, words: string[]) => words.some((w) => q.includes(w));

function detectSignals(rawQuery: string) {
  const q = rawQuery.toLowerCase();
  return {
    meetingCustomUi: hasAny(q, ['zoom meeting', 'custom ui', 'component view', 'embed meeting']),
    customVideo: hasAny(q, ['video sdk', 'custom video session', 'peer-video-state-change']),
    restApi: hasAny(q, ['rest api', '/v2/', 'create meeting', 'list users', 's2s oauth']),
    webhooks: hasAny(q, ['webhook', 'x-zm-signature', 'event subscription', 'crc']),
    oauth: hasAny(q, ['oauth', 'pkce', 'token refresh', 'account_credentials']),
    mcp: hasAny(q, ['zoom mcp', 'agentic retrieval', 'tools/list', 'semantic meeting search']),
  };
}

function pickPrimarySkill(s: ReturnType<typeof detectSignals>): SkillId {
  if (s.meetingCustomUi) return 'zoom-meeting-sdk-web-component-view';
  if (s.mcp) return 'zoom-mcp';
  if (s.restApi) return 'zoom-rest-api';
  if (s.customVideo) return 'zoom-video-sdk';
  return 'zoom-general';
}

function buildChain(primary: SkillId, s: ReturnType<typeof detectSignals>): SkillId[] {
  const chain = [primary];
  if (s.oauth && !chain.includes('zoom-oauth')) chain.push('zoom-oauth');
  if (s.webhooks && !chain.includes('zoom-webhooks')) chain.push('zoom-webhooks');
  return chain;
}

示例：

  • Create a meeting, configure webhooks, and handle OAuth token refresh -> zoom-rest-api -> zoom-oauth -> zoom-webhooks
  • Build a custom video UI for a Zoom meeting on web -> zoom-meeting-sdk-web-component-view

完整的 TypeScript 实现和交接约定，请参阅 references/routing-implementation.md。

选择你的路径

我想要……使用此技能
围绕真实 Zoom 会议构建自定义 Web UIzoom-meeting-sdk-web-component-view
构建确定性的自动化、配置和报告，并显式控制请求zoom-rest-api
接收事件通知（HTTP 推送）zoom-webhooks
接收事件通知（WebSocket，低延迟）zoom-websockets
在我的应用中嵌入 Zoom 会议zoom-meeting-sdk
构建自定义视频体验（Web、React Native、Flutter、Android、iOS、macOS、Unity、Linux）zoom-video-sdk
构建运行在 Zoom 客户端内的应用zoom-apps-sdk
使用 AI Services Scribe 转录已上传或已存储的媒体scribe
访问会议中的实时音频、视频和转录zoom-rtms
启用用于支持的协同浏览zoom-cobrowse-sdk
构建 Contact Center 应用和渠道集成contact-center
构建 Virtual Agent Web/移动端聊天机器人体验virtual-agent
构建 Zoom Phone 集成（Smart Embed、Phone API、webhooks、URI 流程）phone
构建 Team Chat 应用和集成zoom-team-chat
使用 Rivet 构建服务端集成（认证 + webhooks + API）rivet-sdk
在加入前运行浏览器、设备和网络预检诊断probe-sdk
为 Video SDK 添加预构建 UI 组件zoom-ui-toolkit
实现 OAuth 认证（所有授权类型）zoom-oauth
基于 Zoom 数据构建 AI 驱动的工具工作流（AI Companion/Agent）zoom-mcp
通过 Zoom Whiteboard MCP 构建 AI 驱动的白板工作流zoom-mcp/whiteboard
使用稳定 API 核心 + AI 工具层构建企业 AI 系统zoom-rest-api + zoom-mcp

规划检查点：Rivet SDK（可选）

当用户开始规划结合认证、webhooks 和 API 调用的服务端集成时，请先询问：

  • Rivet SDK is a Node.js framework that bundles Zoom auth handling, webhook receivers, and typed API wrappers.
  • Do you want to use Rivet SDK for faster scaffolding, or do you prefer a direct OAuth + REST implementation without Rivet?

根据回答进行路由：

  • 如果用户选择 Rivet：链式调用 rivet-sdk + oauth + rest-api。
  • 如果用户拒绝 Rivet：链式调用 oauth + rest-api（并按需加上 webhooks 或产品技能）。
SDK 与 REST 路由矩阵（硬性停止）
用户意图正确路径不要路由到
在应用 UI 中嵌入 Zoom 会议zoom-meeting-sdk仅使用 REST 的 join_url 流程
为真实 Zoom 会议构建自定义 Web UIzoom-meeting-sdk-web-component-viewzoom-video-sdk
构建自定义视频 UI/会话应用zoom-video-sdkMeeting SDK 或 REST 会议链接
获取浏览器加入链接/管理会议资源zoom-rest-apiMeeting SDK 加入实现

路由护栏：

  • 如果用户询问 SDK 嵌入/加入行为，请停留在 SDK 路径中。
  • 如果提示同时包含会议与自定义 UI/视频/布局/嵌入，优先使用 zoom-meeting-sdk-web-component-view。
  • 仅当用户构建的是自定义会话产品而非 Zoom 会议时，才使用 zoom-video-sdk。
  • 仅将 REST 路径用于资源管理、报表或链接分发，除非用户明确要求混合架构。
  • 有关可执行的分类/链式逻辑及错误处理，请参阅 references/routing-implementation.md。
API 与 MCP 路由矩阵（硬性停止）
用户意图正确路径原因
确定性的后端自动化、账户/用户配置、报表、定时任务zoom-rest-api显式的请求/响应控制与可重复的行为
AI Agent 动态选择工具、跨平台 AI 工具互操作zoom-mcpMCP 针对动态工具发现与 Agent 式工作流进行了优化
企业级 AI 架构（稳定核心 + 自适应 AI 层）zoom-rest-api + zoom-mcpAPI 负责执行核心系统操作；MCP 暴露经过筛选的 AI 工具/上下文

路由护栏：

  • 不要用仅 MCP 的路由替代确定性的后端 API。
  • 当任务属于 AI Agent 工具编排时，不要强制优先采用原始 REST 路由。
  • 当用户同时需要稳定自动化和 AI 驱动的交互时，优先采用混合路由。
  • MCP 远程服务基于 Streamable HTTP/SSE 工作；当目标客户端/Agent 支持 MCP 传输时（例如 Claude 或 VS Code），请使用此路径。
  • 不要设计按租户定制的 MCP 端点预配；Zoom MCP 端点在实例/集群级别共享。
  • 来源：https://developers.zoom.us/docs/mcp/library/resources/apis-vs-mcp/
歧义消解（路由前先询问）

当提示同时以相近的置信度匹配 API 路径和 MCP 路径时，在执行前请先提出一个简短的澄清问题：

  • 您需要确定性的 REST API 自动化、AI Agent 的 MCP 工具，还是两者的混合方案？

然后按以下方式路由：

  • 选择 REST → zoom-rest-api
  • 选择 MCP → zoom-mcp
  • 选择混合 → zoom-rest-api + zoom-mcp
MCP 可用性与拓扑说明
  • Zoom 托管的 MCP 访问仍在演进；文档表明 Zoom 将提供按产品划分的 MCP 服务（例如会议、Team Chat、白板）。
  • 使用 zoom-mcp 作为父级 MCP 入口。
  • 将白板相关的 MCP 请求路由到 zoom-mcp/whiteboard。
  • 当请求针对特定产品且存在 MCP 覆盖时，应优先路由到该 MCP 产品入口；否则使用 REST/SDK 技能进行确定性实现。
Webhooks 与 WebSockets

两者都用于接收事件通知，但实现方式不同：

对比项webhookszoom-websockets
连接方式向你的端点发送 HTTP POST持久化 WebSocket 连接
延迟较高较低
安全性需要公网端点无需暴露端点
设置较简单较复杂
最适合大多数场景实时性要求高、注重安全的场景

常见用例

Use CaseDescriptionSkills Needed
会议 + Webhooks + OAuth 刷新在同一套设计中创建会议、处理实时更新,并安全地刷新 OAuth 令牌zoom-rest-api + zoom-oauth + zoom-webhooks
Scribe 转录流水线使用快速模式或批处理作业,通过 AI Services Scribe 转录上传的文件或 S3 归档scribe + 可选 zoom-rest-api + 可选 zoom-webhooks
API 与 MCP 路由选择判断应路由到确定性的 Zoom API、由 AI 驱动的 MCP,还是两者结合的混合设计zoom-rest-api 和/或 zoom-mcp
自定义会议 UI(Web)在 Web 应用中,使用 Meeting SDK Component View 为真实的 Zoom 会议构建自定义视频界面zoom-meeting-sdk-web-component-view + zoom-oauth
会议自动化以编程方式创建、更新和删除会议zoom-rest-api
会议机器人构建可加入会议的机器人,用于 AI、转录或录制meeting-sdk/linux + zoom-rest-api + 可选 zoom-webhooks
高并发会议平台设计分布式会议创建与事件处理,包含重试、队列和对账机制zoom-rest-api + zoom-webhooks + zoom-oauth
录制与转录下载录制文件,获取转录文本zoom-webhooks + zoom-rest-api
录制下载流水线自动将录制文件下载到你自己的存储(S3、GCS 等)zoom-webhooks + zoom-rest-api
实时媒体流通过 WebSocket 获取实时音频、视频和转录内容zoom-rtms + zoom-webhooks
会议内应用构建在 Zoom 会议内运行的应用zoom-apps-sdk + zoom-oauth
React Native 会议嵌入将会议嵌入 iOS/Android React Native 应用zoom-meeting-sdk-react-native + zoom-oauth
原生 Meeting SDK 多平台交付在统一的认证与版本策略下,协调 Android、iOS、macOS 和 Unreal 的 Meeting SDK 实现zoom-meeting-sdk + 各平台技能
原生 Video SDK 多平台交付在统一的认证与版本策略下,协调 Android、iOS、macOS 和 Unity 的 Video SDK 实现zoom-video-sdk + 各平台技能
Electron 会议嵌入将会议嵌入桌面 Electron 应用zoom-meeting-sdk-electron + zoom-oauth
Flutter 视频会话在 Flutter 中构建自定义移动端视频会话zoom-video-sdk-flutter + zoom-oauth
React Native 视频会话在 React Native 中构建自定义移动端视频会话zoom-video-sdk-react-native + zoom-oauth
沉浸式体验使用 Layers API 实现自定义视频布局zoom-apps-sdk
协作应用在会议中实现实时共享状态zoom-apps-sdk
联络中心应用生命周期与上下文切换构建可处理互动事件和多互动状态的联络中心应用contact-center + zoom-apps-sdk
虚拟 Agent 营销活动 Web 与移动端封装在 Web 和原生移动端封装中交付由营销活动驱动的同一套机器人流程virtual-agent + contact-center
虚拟 Agent 知识库同步流水线使用网页同步或自定义 API 连接器,将外部知识内容同步到 Zoom 虚拟 Agentvirtual-agent + zoom-rest-api + zoom-oauth
Zoom Phone Smart Embed CRM 集成结合 Smart Embed 与 Phone API,构建 CRM 拨号和通话记录流程phone + zoom-oauth + zoom-webhooks
Rivet 事件驱动 API 编排器构建 Node.js 后端,通过 Rivet 模块客户端结合 Webhooks 与 API 操作rivet-sdk + zoom-oauth + zoom-rest-api
Probe SDK 预检就绪门禁在加入 Meeting SDK 或 Video SDK 之前,添加浏览器、设备和网络诊断及就绪策略probe-sdk + zoom-meeting-sdk 或 zoom-video-sdk

Complete Use-Case Index

前置条件

  1. Zoom 账户（Pro、Business 或 Enterprise）
  2. 已在 Zoom App Marketplace 中创建应用
  3. OAuth 凭据（Client ID 和 Secret）

参考资料

快速开始

  1. 前往 marketplace.zoom.us
  2. 点击 Develop → Build App
  3. 选择应用类型（参见 references/app-types.md）
  4. 配置 OAuth 和权限范围（scopes）
  5. 将凭据复制到你的应用中

详细参考

SDK 维护

资源

环境变量

运维

评论

支持 Markdown