findscripter 何时使用
当你已确定要走 MCP 工具路径访问 Zoom 的会议、录制、会议资产或转录，需要规划工具面、对齐 OAuth 鉴权与作用域，或排查 MCP 特有报错时使用本条目。
适用：
- 用 AI Companion 做语义会议搜索（
search_meetings），按内容而非元数据过滤。 - 检索会议关联资产、列举/拉取云录制资源与转录。
- 对齐 MCP 专用 OAuth 作用域、排查 401 / -32001 / -32602 / 404。
不该用（负边界）：
- 需要确定性的会议增删改（create/update/delete）：当前 MCP 工具面不暴露这类工具，改走 Zoom REST API。
- 白板相关：走专用的 whiteboard skill / MCP 端点。
- Zoom Docs 的创建与读取：走独立的
zoom-docs-mcp服务器（mcp.zoom.us），而非主zoom-mcp服务器。 - 进入工具调用前，先经
design-mcp-workflow或setup-zoom-mcp完成路由与初始化，本条目只负责工具面细节、鉴权预期与 MCP 约束。
步骤
- 导出连接器所需的访问令牌。
- 启用或重启插件，让 Claude 重新加载捆绑的 MCP 服务器定义。
- 验证工具发现：确认客户端能看到
recordings_list、search_meetings、get_meeting_assets、get_recording_resource。若客户端支持原始协议检视，以tools/list为权威发现来源（部分客户端会给工具加命名空间，如zoom-mcp:recordings_list，但以裸工具名为准）。 - 跑通第一个有用调用（见示例）。
- 选定目标后链式检索：先搜索/列举，再按返回的
meetingId/UUID 拉资产或录制资源。 - 命中报错时对照「注意事项」中的错误表定位并修复。
指令
导出令牌（bash）：
export ZOOM_MCP_ACCESS_TOKEN="your_zoom_user_oauth_access_token"
服务器端点：
| 服务器 | Transport | URL |
|---|---|---|
| 主 Zoom MCP | Streamable HTTP（推荐） | https://mcp-us.zoom.us/mcp/zoom/streamable |
| 主 Zoom MCP | SSE（回退） | https://mcp-us.zoom.us/mcp/zoom/sse |
| Zoom Docs MCP | Streamable HTTP（推荐） | https://mcp.zoom.us/mcp/docs/streamable |
| Zoom Docs MCP | SSE（回退） | https://mcp.zoom.us/mcp/docs/sse |
工具目录（* 为必填参数）：
| 工具 | 关键参数 | 所需作用域 |
|---|---|---|
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 |
Zoom Docs MCP 官方文档化工具：create_file_with_content、get_file_content。
示例
第一个有用调用（列举近一周录制）：
recordings_list
userId: "me"
from: "2026-03-01"
to: "2026-03-06"
page_size: 10
搜索会议内容，再取资产：
search_meetings
q: "Q4 planning discussion"
from: "2026-03-01"
to: "2026-03-06"
→ 选定一个返回的会议
→ get_meeting_assets meetingId: "MEETING_ID_OR_UUID"
列举录制，再取录制资源（含转录能力的资源）：
recordings_list
userId: "me"
from: "2026-03-01"
to: "2026-03-06"
→ 选定一个录制目标
→ get_recording_resource meetingId: "MEETING_UUID_OR_RECORDING_ID"
注意事项
- 鉴权路径：使用 General app + 用户级 OAuth 作为本插件 Zoom MCP 工具调用的执行路径；不要把 Server-to-Server OAuth 当作受支持的 MCP 鉴权模型。
- MCP 用的是细粒度专用作用域，与旧的宽 REST 作用域不同。主服务器关键作用域：
ai_companion:read:search（跨 Meeting/Chat/Doc 语义搜索）、meeting:read:search、meeting:read:assets、cloud_recording:read:list_user_recordings、cloud_recording:read:content；Zoom Docs MCP：docs:write:import、docs:read:export。 - AI Companion 功能是「前置条件」而非作用域替代：语义搜索、会议资产、录制内容检索依赖账号开启 Smart Recording、Meeting Summary 等功能才能有有用结果；这些功能设置不能替代必需的 OAuth 作用域。
search_meetings走 AI Companion 检索而非纯元数据过滤；以在线 MCP 服务器为响应 schema 与作用域行为的权威。两类结果最重要：复盘类（AI 总结、会议关联文档、录制及相关资产）与录制类（云录制引用、可转录资源）。
错误参考：
| Code | 含义 | 修复 |
|---|---|---|
401 Unauthorized |
端点缺失或拒绝 bearer token | 设置 ZOOM_MCP_ACCESS_TOKEN，重启 Claude 或重新启用插件 |
-32001 Invalid access token |
令牌过期/格式错误/缺所需作用域 | 刷新 OAuth 令牌并核对 MCP 专用作用域 |
-32602 Can not found tool |
工具名未被当前 MCP 服务器暴露 | 重跑 tools/list，对该端点使用当前工具名 |
404 |
下游资源未找到 | 用 search_meetings 或 recordings_list 重新发现目标 |
互见
- 平台/mcp：
design-mcp-workflow、setup-zoom-mcp（先路由/初始化，再到本条目）。 - Zoom REST API：确定性会议 CRUD（创建/更新/删除会议）走 REST。
- Zoom OAuth：OAuth 实现模式与令牌生命周期。
- Zoom Whiteboard MCP：白板专用 MCP skill。
- Zoom Webhooks / RTMS：事件驱动的录制/会议流，及会中实时媒体与转录流。
采编自 anthropics/knowledge-work-plugins（Apache-2.0）。