zoom-mcp

Zoom MCP

本 Claude 插件中内置的 Zoom MCP 连接器使用指南。请优先使用 design-mcp-workflow 或 setup-zoom-mcp，然后再转到此处了解工具接口细节、认证要求以及 MCP 相关约束。

Zoom MCP 服务

本插件内置了 Zoom 托管的 MCP 服务，地址为 mcp-us.zoom.us，供 AI Agent 访问以下功能：

• 语义化会议搜索
• 会议关联资产检索
• 录制资源检索

Zoom Docs 通过一个单独的内置服务提供：

• zoom-docs-mcp，地址为 mcp.zoom.us
• 专为 Zoom Docs 的创建与检索而构建

主 Zoom MCP 服务当前的工具名称：

• get_meeting_assets
• search_meetings
• get_recording_resource
• recordings_list

部分 MCP 客户端会在界面中为服务工具添加命名空间，例如 zoom-mcp:recordings_list。 请以上述原始工具名称为准。

与 Zoom Docs 相关的 MCP 工作应使用专用的 zoom-docs-mcp 服务。

与白板相关的 MCP 工作由专门的技能 whiteboard/SKILL.md 负责。

快速开始

1. 导出内置连接器所需的令牌：

export ZOOM_MCP_ACCESS_TOKEN="your_zoom_user_oauth_access_token"

2. 启用或重启插件，使 Claude 重新启动内置的 MCP 服务定义。

3. 验证工具发现：

• 确认客户端可以看到 recordings_list、search_meetings、get_meeting_assets 和 get_recording_resource。
• 如果客户端支持原始协议检查，tools/list 是权威的发现来源。
• 当前工具目录记录在 references/tools.md 中。

4. 执行第一个有效调用：

recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
  page_size: 10

关键注意事项

1. 文档记载的执行路径是用户 OAuth

在本插件中，使用 General 应用 并采用 用户级 OAuth 作为 Zoom MCP 工具调用的执行路径。请勿将 Server-to-Server OAuth 作为此处受支持的 MCP 认证模式。

2. Zoom MCP 使用 MCP 专用的细粒度权限范围

Zoom MCP 的权限范围集合与较早的宽泛 REST 权限范围不同。 主 Zoom MCP 服务的关键权限范围包括：

• ai_companion:read:search：跨 Zoom 会议、Zoom 聊天和 Zoom Doc 搜索，根据查询返回最相关的结果
• meeting:read:search：搜索并查看会议
• meeting:read:assets：查看会议的资产
• cloud_recording:read:list_user_recordings：列出用户的所有云端录制
• cloud_recording:read:content：读取录制内容的权限范围
• docs:write:import：通过导入创建新文件
• docs:read:export：以 Markdown 格式读取文件内容

具体到 Zoom Docs MCP，官方文档页面列出了所记载工具对应的以下细粒度权限范围：

• docs:write:import：通过导入创建新文件
• docs:read:export：以 Markdown 格式读取文件内容

3. AI Companion 功能是功能前提，而非权限范围的替代

语义化会议搜索、会议资产和录制内容检索要想获得有用的结果，依赖于账户功能，例如 智能录制（Smart Recording） 和 会议摘要（Meeting Summary）。这些功能设置无法替代所需的 OAuth 权限范围。

4. 白板是独立的 MCP 接口

Zoom MCP 端点与白板 MCP 端点是分开的。涉及白板的请求请转至 whiteboard/SKILL.md。

5. 确定性的会议增删改请使用 REST

当前的 Zoom MCP 工具接口不提供确定性的会议创建、更新或删除工具。如果用户需要明确的会议增删改操作，请转至 ../rest-api/SKILL.md。

Server Endpoints

Transport	URL
Streamable HTTP (recommended)	https://mcp-us.zoom.us/mcp/zoom/streamable
SSE (fallback)	https://mcp-us.zoom.us/mcp/zoom/sse

专用 Docs MCP 服务：

Transport	URL
Streamable HTTP (recommended)	https://mcp.zoom.us/mcp/docs/streamable
SSE (fallback)	https://mcp.zoom.us/mcp/docs/sse

专用 Whiteboard MCP skill：

• whiteboard/SKILL.md

Search and Retrieval Model

search_meetings 使用 AI Companion 检索，而不是普通的元数据过滤。在这种 用法中，请以在线 MCP 服务为准，了解响应结构和范围行为。

最重要的两类结果：

• Recap 类结果：AI 摘要、与会议关联的文档、录制和相关资源
• 录制类结果：云端录制引用和支持转录的资源

主要检索流程请参阅 examples/transcript-retrieval.md。

Tool Catalog

Tool	Key Parameters	Required Scope
get_meeting_assets	meetingId*	meeting:read:assets
search_meetings	q, from, to, page_size, next_page_token	meeting:read:search
get_recording_resource	meetingId*, types, clip_num, play_time, raw_passcode, encode_passcode	cloud_recording:read:content
recordings_list	userId*, from, to, meeting_id, trash, trash_type, page_size, next_page_token	cloud_recording:read:list_user_recordings

* 必填参数

完整的参数和输出说明：references/tools.md

Key Workflows

搜索会议内容，然后获取资源：

search_meetings
  q: "Q4 planning discussion"
  from: "2026-03-01"
  to: "2026-03-06"
→ choose a returned meeting
→ get_meeting_assets  meetingId: "MEETING_ID_OR_UUID"

列出录制，然后获取录制资源：

recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
→ choose a recording target
→ get_recording_resource  meetingId: "MEETING_UUID_OR_RECORDING_ID"

创建或获取 Zoom Doc：

• 请使用专用的 zoom-docs-mcp 服务，而不是主 zoom-mcp 服务
• Zoom Docs MCP 页面上官方记载的工具包括：
  • create_file_with_content
  • get_file_content

Error Reference

Code	Meaning	Fix
401 Unauthorized	端点缺少或拒绝 bearer token	设置 ZOOM_MCP_ACCESS_TOKEN，然后重启 Claude 或重新启用插件
-32001 Invalid access token	Token 已过期、格式错误或缺少所需 scope	刷新 OAuth token，并检查 MCP 相关 scope
-32602 Can not found tool	请求的工具名称未由当前 MCP 服务提供	重新运行 tools/list，并使用该端点当前的工具名称
404	可能是下游资源未找到的响应	使用 search_meetings 或 recordings_list 重新查找目标

完整错误参考：references/error-codes.md

Documentation

Concepts

• concepts/mcp-architecture.md — MCP 协议、托管端点、发现机制和能力模型
• concepts/oauth-setup.md — OAuth 应用创建、MCP 专用 scope、AI Companion 前提条件、token 生命周期

Examples

• examples/transcript-retrieval.md — 搜索/资源和录制资源流程
• examples/create-zoom-doc.md — 已验证的 Zoom Docs 创建流程
• examples/search-and-act.md — 搜索、检查资源，并在需要时将 CRUD 工作交给 REST
• examples/meeting-lifecycle.md — 会议 CRUD 为何应使用 REST，以及 MCP 到 REST 的交接模式

References

• references/tools.md — 当前 Zoom MCP 工具参考
• references/error-codes.md — MCP 和 Zoom API 错误及修复方法
• whiteboard/SKILL.md — 专用 Whiteboard MCP skill

故障排查

• troubleshooting/common-errors.md — 权限范围失败、端点混淆、搜索与录制问题

运维

• RUNBOOK.md — 5 分钟预检与调试清单

相关 Skills

• zoom-rest-api — 确定性的 REST API 访问，包括会议的增删改查
• zoom-oauth — OAuth 实现模式
• zoom-webhooks — 事件驱动的录制与会议工作流
• zoom-rtms — 会议进行期间的实时媒体与转录流