⚡

Zoom集成设置Skill zoom-setup

Zoom集成设置技能用于将Zoom账户连接到Dex平台，实现会议录制、调度和转录上下文的自动化访问，优化会议准备、处理和回顾工作流，包含关键词：Zoom集成、会议录制、转录、调度、Dex平台、工作流增强、OAuth认证、API集成。

DevOps 0 次安装 0 次浏览 更新于 3/20/2026

名称：zoom-setup 描述：将Zoom连接到Dex，以实现会议录制、调度和转录上下文 集成： id：zoom 名称：Zoom mcp_server：zoom-mcp 认证：oauth2 类别：会议 同步方向：双向 增强功能： - 技能：meeting-prep 能力：“显示与每位与会者的最后一次Zoom会议，提供录制摘要” - 技能：process-meetings 能力：“Zoom录制作为Granola的替代会议来源” - 技能：week-review 能力：“来自Zoom的会议时间统计（小时、数量、分布）” 新能力： - 名称：录制搜索 触发：“在/meeting-prep期间，搜索Zoom录制以查找与与会者的过去会议” - 名称：Zoom调度 触发：“直接从Dex调度Zoom会议，并需确认”

Zoom设置

将您的Zoom账户连接到Dex，使您的会议准备、回顾和process-meetings工作流能够直接访问Zoom录制、转录和调度。

此功能启用什么

一旦连接，Dex可以：

读取：

  • 列出过去会议的录制和转录
  • 通过关键词或参与者搜索会议内容
  • 获取参与者列表和会议元数据
  • 从录制中提取会议摘要和行动项

写入（始终需您确认）：

  • 调度Zoom会议（Dex在创建前会始终确认）
  • 将会议笔记或摘要添加到Zoom

技能增强：

  • 会议准备（/meeting-prep）显示：“您与Sarah的最后一次Zoom会议：1月15日。录制摘要可用。”
  • 处理会议（/process-meetings）可以直接处理Zoom录制，作为Granola的替代
  • 周回顾（/week-review）包括来自Zoom的会议时间统计

新能力：

  • 录制搜索： 在/meeting-prep期间，搜索Zoom录制以查找与与会者的过去会议并提供摘要

隐私

Dex访问您的Zoom账户以读取录制和调度会议。没有录制存储在本地。录制被提取、摘要化，并在会话后丢弃。只有您的账户可访问（范围限于您的OAuth登录）。OAuth令牌保留在您的机器本地，并被gitignore。

何时运行

  • 用户输入/zoom-setup
  • 用户询问连接Zoom
  • 用户希望在会议准备中获得Zoom录制上下文
  • 在/integrate-mcp期间，如果提到Zoom

设置流程

步骤1：检查是否已连接

  1. 检查System/integrations/config.yaml中的zoom.enabled: true
  2. 如果启用，尝试通过Zoom MCP进行测试查询（例如，列出最近录制）
  3. 如果健康且响应，跳转到步骤5（配置偏好）
  4. 如果工具不可用或出错，继续到步骤2

步骤2：智能Granola检测

在解释完整设置前，检查Granola是否已连接：

  1. 读取System/integrations/config.yaml中的granola部分
  2. 检查Granola MCP工具是否可用（尝试granola_check_available()）

如果Granola已连接：

您已经连接了Granola——它会自动捕获您的Zoom会议。

Zoom集成将添加：
- 直接从Dex调度会议
- 访问Zoom云录制（如果Granola错过一个）
- 参与者元数据（受邀与出席）

仍要连接吗？[是 / 暂时跳过]

如果用户说“暂时跳过”，确认并退出：

“没问题。Granola已覆盖您的会议捕获。随时运行/zoom-setup，如果您稍后想要调度或录制访问。”

如果用户说“是”（Granola已连接），继续并调整消息：

**让我们将Zoom连接到Dex。**

既然Granola处理会议捕获，Zoom添加调度和直接录制访问。

**您需要的：**
- 一个Zoom账户（Pro或更高版本用于云录制）
- 约3分钟完成OAuth流程

**准备好了吗？**

如果Granola未连接：

**让我们将Zoom连接到Dex。**

这使Dex能够访问您的Zoom录制、转录和调度。

**您需要的：**
- 一个Zoom账户（Pro或更高版本用于云录制）
- 约3分钟完成OAuth流程

**Dex将能够：**
- 访问您的Zoom录制和转录
- 通过关键词或参与者搜索会议内容
- 调度Zoom会议（需您确认）
- 用录制摘要丰富会议准备

**准备好了吗？**

等待确认。

步骤3：添加Zoom MCP服务器

检查用户的MCP配置。如果zoom-mcp未列出：

  1. 解释我们要添加的内容：
我需要将Zoom连接器添加到您的Dex配置中。

这使用一个MCP桥，通过OAuth连接到Zoom的API。
您的凭证保留在您的机器上。
  1. 添加到用户的.mcp.json（使用/dex-add-mcp技能或手动编辑）：
{
  "zoom-mcp": {
    "command": "npx",
    "args": ["-y", "zoom-mcp"],
    "env": {}
  }
}
  1. 告诉用户MCP服务器需要重启以使更改生效。

步骤4：通过OAuth认证

  1. 运行Zoom MCP服务器——这会启动OAuth流程
  2. 浏览器窗口打开以进行Zoom登录
  3. 用户授权请求的范围（录制、会议、用户）
  4. 令牌保存在本地

如果OAuth成功：

已连接！我可以看到您的Zoom账户。

如果失败：

OAuth流程未完成。请检查以下几点：

1. **浏览器是否打开？** 如果没有，尝试从终端输出复制URL
2. **您是否批准了所有权限？** Dex需要录制和会议访问
3. **需要Zoom Pro吗？** 云录制需要Pro（或更高）Zoom计划
4. **企业SSO？** 您的Zoom管理员可能限制OAuth应用

要重试吗？

重试最多2次，然后提供跳过并稍后返回。

步骤5：配置偏好

一旦连接，根据Granola状态确定功能默认值：

功能默认值（有Granola）：

  • zoom_recordings: false —— Granola处理转录；Zoom录制作为备份
  • zoom_scheduling: true —— 调度始终有用

功能默认值（无Granola）：

  • zoom_recordings: true —— 会议录制的主要来源
  • zoom_scheduling: true

然后询问调度行为：

**对于调度Zoom会议：**

您更喜欢：
1. **自动调度** —— 我会创建会议并显示链接
2. **每次询问** —— 我会在创建任何会议前确认

（您随时可以通过重新运行/zoom-setup更改此设置）

保存他们的偏好。将选择1映射到auto_schedule: true，选择2到auto_schedule: false。

步骤6：测试连接

运行快速测试以确认一切正常：

  1. 列出最近录制（过去7天）
  2. 验证会议列表访问

显示简要摘要：

**快速测试结果：**
- 录制：找到[N]个最近录制
- 会议列表：工作正常

一切看起来良好！

如果任一失败，在继续前进行故障排除。

步骤7：保存配置

写入System/integrations/config.yaml——更新zoom部分：

zoom:
  enabled: true
  configured_at: YYYY-MM-DD
  mcp_server: zoom-mcp
  auth_type: oauth2
  account: user@example.com
  granola_coexists: true   # 或false——跟踪Granola在设置时是否已连接
  features:
    zoom_recordings: true   # 如果Granola已连接则为false
    zoom_scheduling: true
    auto_schedule: false    # 或true基于用户偏好

如果文件已存在，仅更新zoom:部分。保留其他集成配置。

步骤8：确认能力增强

如果Granola已连接：

**Zoom已连接！**

以下是刚刚增强的内容：

- **会议准备**（`/meeting-prep`）现在包括Zoom上下文：
  - 当Granola转录不可用时，Zoom录制链接
  - 参与者出席情况（受邀与加入）
  - 直接从准备中调度

- **处理会议**（`/process-meetings`）获得Zoom回退：
  - 如果Granola错过会议，Zoom云录制介入
  - 相同输出格式（决策、行动项、关键点）

- **周回顾**（`/week-review`）现在包括Zoom统计：
  - 总会议小时数
  - 录制数量

Granola仍然是您的主要会议捕获工具。Zoom填补空白。

您随时可以通过运行`/zoom-setup`调整设置。

如果Granola未连接：

**Zoom已连接！**

以下是刚刚增强的内容：

- **会议准备**（`/meeting-prep`）现在显示Zoom录制上下文：
  - 与每位与会者的最后一次Zoom会议
  - 录制摘要（如果可用）
  - 参与者出席情况（受邀与加入）

- **处理会议**（`/process-meetings`）现在可以使用Zoom录制：
  - 直接从Zoom云录制提取转录
  - 相同输出格式（决策、行动项、关键点）

- **周回顾**（`/week-review`）现在包括Zoom会议统计：
  - 来自Zoom的总会议小时数
  - 本周录制数量
  - 会议分布

您随时可以通过运行`/zoom-setup`调整设置。

故障排除

OAuth令牌过期

Zoom OAuth令牌定期过期。如果您看到认证错误：

  1. 运行/zoom-setup以触发令牌刷新
  2. 如果刷新令牌也过期，您需要通过浏览器重新授权
  3. 这很少见——通常在长时间后或如果您在Zoom设置中撤销访问时发生

“未找到Zoom MCP”

服务器可能不在您的配置中。重新运行/zoom-setup，它将检测并修复此问题。

未找到录制

几种可能性：

  • 免费计划： 云录制需要Zoom Pro或更高版本
  • 录制禁用： 检查您的Zoom设置以确保云录制已启用
  • 保留策略： 您的Zoom管理员可能在一定时期后自动删除录制

企业Zoom限制

一些组织限制第三方应用的OAuth访问：

  1. 与您的IT管理员检查是否允许Zoom的OAuth
  2. 他们可能需要将zoom-mcp客户端ID列入白名单
  3. 一些组织要求OAuth应用的管理员预批准

速率限制

Zoom API有每秒和每日限制。如果您看到速率错误：

  1. 等待60秒并重试
  2. 如果持续，您可能达到账户级配额
  3. 在正常Dex使用中很少发生

重新配置

如果用户运行/zoom-setup但已配置：

  1. 通过测试查询检查当前状态
  2. 从System/integrations/config.yaml显示当前配置
  3. 提供选项：
    • 更改调度偏好（自动调度与每次询问）
    • 切换录制访问（特别是如果Granola状态更改）
    • 重新认证（如果令牌过期）
    • 断开Zoom连接

断开连接流程

如果用户想要断开连接：

  1. 更新System/integrations/config.yaml：
    zoom:
  enabled: false
  2. 确认：“Zoom已断开连接。您的会议准备和回顾将不再包括Zoom录制上下文。随时运行/zoom-setup以重新连接。”