Zoom MCP: встречи, записи, расшифровки

Справочник по подключённому MCP-серверу Zoom: поиск по встречам, материалы встреч, записи и расшифровки, нужные права и ошибки.

СкиллAnthropic (партнёр: Zoom)ClaudeMITНужен терминалПроверка не требуетсяСлужебный: его вызывают другие скиллы

Скачать на русскомОригинал на английском (архив)Источник ↗

Что делает: Справочник по подключённому MCP-серверу Zoom: поиск по встречам, материалы встреч, записи и расшифровки, нужные права и ошибки.
Когда брать: Когда нужно найти встречу по содержанию, получить её итоги, запись или расшифровку либо разобраться с ошибками доступа к Zoom MCP.
Когда не брать: Если нужно создавать, менять или удалять встречи (для этого REST API), работать с Zoom Docs (отдельный сервер) или с Whiteboard (отдельный скилл).
Пример запроса: Найди встречи за прошлую неделю, где обсуждали планирование на четвёртый квартал, и достань расшифровку.
Нужно подключить: терминал, аккаунт Zoom с токеном OAuth
Работает лучше с: Zoom AI Companion (Smart Recording, Meeting Summary)

Входит в плагин zoom-plugin. В Cowork и Claude Code можно поставить плагин целиком.

Как включить

Скачайте архив и распакуйте его.
Положите папку zoom-mcp в ~/.claude/skills/.
Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.

Текст

---
name: zoom-mcp
description: Руководство по встроенным коннекторам Zoom MCP. Используй после маршрутизации в рабочий процесс MCP, когда планируешь или отлаживаешь доступ через инструменты к встречам, записям, материалам встреч и расшифровкам. Запросы по Zoom Docs направляй на отдельный MCP-сервер Docs, а запросы именно по Whiteboard — в `zoom-mcp/whiteboard`.
user-invocable: false
triggers:
  - "zoom mcp"
  - "zoom mcp server"
  - "zoom mcp tools"
  - "zoom tools/list"
  - "zoom tools/call"
  - "ai companion transcript"
  - "agentic retrieval"
  - "zoom semantic meeting search"
  - "zoom search meetings by content"
  - "zoom meeting assets mcp"
  - "zoom recording resource mcp"
  - "zoom docs via mcp"
  - "zoom transcript via mcp"
  - "meeting transcript via mcp"
---

Zoom MCP

Руководство по встроенному коннектору Zoom MCP в этом плагине Claude. Сначала обращайся к design-mcp-workflow или [setup-zoom-mcp](../setup-zoom-mcp/SKILL.md), а сюда переходи за подробностями об инструментах, требованиях к аутентификации и ограничениях, специфичных для MCP.

MCP-сервер Zoom

Этот плагин включает размещённый у Zoom MCP-сервер mcp-us.zoom.us, который даёт ИИ-агентам доступ к:

семантическому поиску по встречам
получению материалов, связанных со встречей
получению ресурсов записей

Zoom Docs доступны через отдельный встроенный сервер:

zoom-docs-mcp по адресу mcp.zoom.us
создан специально для создания и получения Zoom Docs

Текущие имена инструментов основного MCP-сервера Zoom:

get_meeting_assets
search_meetings
get_recording_resource
recordings_list

Некоторые MCP-клиенты добавляют к именам инструментов префикс сервера в интерфейсе, например zoom-mcp:recordings_list. Эталонными считай исходные имена инструментов, приведённые выше.

Работу с Zoom Docs через MCP веди через отдельный сервер zoom-docs-mcp.

Работа с Whiteboard через MCP описана в отдельном скилле [whiteboard/SKILL.md](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](references/tools.md).

4. Выполни первый полезный вызов:

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

Важные замечания

1. Задокументированный путь выполнения — пользовательский OAuth

Для работы с инструментами Zoom MCP в этом плагине используй General-приложение с OAuth на уровне пользователя. Не рассчитывай на Server-to-Server OAuth как на поддерживаемую модель аутентификации MCP.

2. Zoom MCP использует собственные детализированные права (scopes)

Набор прав Zoom MCP не совпадает со старыми широкими правами REST. Основные права для главного MCP-сервера Zoom:

ai_companion:read:search — поиск по Zoom Meeting, Zoom Chat и 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. Whiteboard — отдельная область MCP

Конечная точка Zoom MCP и конечная точка Whiteboard MCP — разные. Запросы именно по Whiteboard направляй в [whiteboard/SKILL.md](whiteboard/SKILL.md).

5. Для предсказуемых операций со встречами используй REST

Текущий набор инструментов Zoom MCP не содержит надёжных инструментов создания, изменения и удаления встреч. Если пользователю нужны явные операции CRUD со встречами, направляй его в [../rest-api/SKILL.md](../rest-api/SKILL.md).

Адреса серверов

Транспорт	URL
Streamable HTTP (рекомендуется)	`https://mcp-us.zoom.us/mcp/zoom/streamable`
SSE (запасной вариант)	`https://mcp-us.zoom.us/mcp/zoom/sse`

Отдельный MCP-сервер Docs:

Транспорт	URL
Streamable HTTP (рекомендуется)	`https://mcp.zoom.us/mcp/docs/streamable`
SSE (запасной вариант)	`https://mcp.zoom.us/mcp/docs/sse`

Отдельный скилл по Whiteboard MCP:

[whiteboard/SKILL.md](whiteboard/SKILL.md)

Модель поиска и получения данных

search_meetings использует поиск AI Companion, а не простой фильтр по метаданным. Схему ответа и поведение прав в этом случае определяет живой MCP-сервер: считай его эталоном.

Важнее всего два семейства результатов:

Результаты по итогам встречи: ИИ-резюме, связанные со встречей документы, записи и сопутствующие материалы
Результаты по записям: ссылки на облачные записи и ресурсы, из которых можно получить расшифровку

Основной порядок получения данных описан в [examples/transcript-retrieval.md](examples/transcript-retrieval.md).

Каталог инструментов

Инструмент	Основные параметры	Необходимое право
`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](references/tools.md)

Основные рабочие процессы

Найти содержимое встречи, затем получить материалы:

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

Справочник ошибок

Код	Значение	Что делать
`401 Unauthorized`	Токен доступа (bearer) отсутствует или отклонён конечной точкой	Задай `ZOOM_MCP_ACCESS_TOKEN`, затем перезапусти Claude или заново включи плагин
`-32001 Invalid access token`	Токен просрочен, повреждён или не хватает нужных прав	Обнови токен OAuth и проверь права, специфичные для MCP
`-32602 Can not found tool`	Запрошенного имени инструмента нет на активном MCP-сервере	Снова выполни `tools/list` и используй актуальные имена инструментов для этой конечной точки
`404`	Возможный ответ «ресурс не найден» от нижележащего сервиса	Найди цель заново через `search_meetings` или `recordings_list`

Полный справочник ошибок: [references/error-codes.md](references/error-codes.md)

Документация

Концепции

[concepts/mcp-architecture.md](concepts/mcp-architecture.md) — протокол MCP, размещённые конечные точки, обнаружение и модель возможностей
[concepts/oauth-setup.md](concepts/oauth-setup.md) — создание приложения OAuth, права для MCP, предварительные условия AI Companion, жизненный цикл токена

Примеры

[examples/transcript-retrieval.md](examples/transcript-retrieval.md) — рабочие процессы поиска, материалов и ресурсов записи
[examples/create-zoom-doc.md](examples/create-zoom-doc.md) — проверенный порядок создания Zoom Docs
[examples/search-and-act.md](examples/search-and-act.md) — поиск, просмотр материалов и передача операций CRUD в REST при необходимости
[examples/meeting-lifecycle.md](examples/meeting-lifecycle.md) — почему CRUD встреч относится к REST и как устроена передача из MCP в REST

Справочники

[references/tools.md](references/tools.md) — актуальный справочник инструментов Zoom MCP
[references/error-codes.md](references/error-codes.md) — ошибки MCP и Zoom API с решениями
[whiteboard/SKILL.md](whiteboard/SKILL.md) — отдельный скилл по Whiteboard MCP

Устранение неполадок

[troubleshooting/common-errors.md](troubleshooting/common-errors.md) — нехватка прав, путаница с конечными точками, проблемы с поиском и записями

Эксплуатация

[RUNBOOK.md](RUNBOOK.md) — пятиминутная предварительная проверка и чек-лист отладки

Связанные скиллы

[zoom-rest-api](../rest-api/SKILL.md) — предсказуемый доступ через REST API, включая CRUD встреч
[zoom-oauth](../oauth/SKILL.md) — схемы реализации OAuth
[zoom-webhooks](../webhooks/SKILL.md) — событийные рабочие процессы для записей и встреч
[zoom-rtms](../rtms/SKILL.md) — живые потоки медиа и расшифровок во время идущих встреч

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/zoom-mcp, лицензия MIT. Изменения: перевод на русский язык.

Оригинал на английском

---
name: zoom-mcp
description: Guidance for the bundled Zoom MCP connectors. Use after routing to an MCP workflow when planning or troubleshooting tool-based access to meetings, recordings, meeting assets, or transcripts. Route Zoom Docs requests to the dedicated Docs MCP server and Whiteboard-specific requests to `zoom-mcp/whiteboard`.
user-invocable: false
triggers:
  - "zoom mcp"
  - "zoom mcp server"
  - "zoom mcp tools"
  - "zoom tools/list"
  - "zoom tools/call"
  - "ai companion transcript"
  - "agentic retrieval"
  - "zoom semantic meeting search"
  - "zoom search meetings by content"
  - "zoom meeting assets mcp"
  - "zoom recording resource mcp"
  - "zoom docs via mcp"
  - "zoom transcript via mcp"
  - "meeting transcript via mcp"
---

# Zoom MCP

Guidance for the bundled Zoom MCP connector in this Claude plugin. Prefer `design-mcp-workflow` or [setup-zoom-mcp](../setup-zoom-mcp/SKILL.md) first, then route here for tool-surface details, auth expectations, and MCP-specific constraints.

# Zoom MCP Server

This plugin bundles Zoom's hosted MCP server at `mcp-us.zoom.us` for AI-agent access to:

- semantic meeting search
- meeting-linked asset retrieval
- recording resource retrieval

Zoom Docs are exposed through a separate bundled server:

- `zoom-docs-mcp` at `mcp.zoom.us`
- purpose-built for Zoom Docs creation and retrieval

Current tool names from the main Zoom MCP server:

- `get_meeting_assets`
- `search_meetings`
- `get_recording_resource`
- `recordings_list`

Some MCP clients namespace server tools in the UI, for example `zoom-mcp:recordings_list`.
Treat the raw tool names above as authoritative.

Zoom Docs-specific MCP work should use the dedicated `zoom-docs-mcp` server.

Whiteboard-specific MCP work is covered by the dedicated skill
[whiteboard/SKILL.md](whiteboard/SKILL.md).

## Quick Start

**1. Export the token expected by the bundled connector:**

```bash
export ZOOM_MCP_ACCESS_TOKEN="your_zoom_user_oauth_access_token"
```

**2. Enable or restart the plugin so Claude restarts the bundled MCP server definition.**

**3. Verify discovery:**
- Confirm the client can see `recordings_list`, `search_meetings`, `get_meeting_assets`,
  and `get_recording_resource`.
- If the client exposes raw protocol inspection, `tools/list` is the authoritative discovery source.
- The current catalog is documented in [references/tools.md](references/tools.md).

**4. Run the first useful call:**
```text
recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
  page_size: 10
```

## Critical Notes

**1. User OAuth is the documented execution path**

Use a **General app** with **user-level OAuth** as the execution path for Zoom MCP
tool use in this plugin. Do not rely on Server-to-Server OAuth as a supported MCP auth model here.

**2. Zoom MCP uses MCP-specific granular scopes**

The Zoom MCP scope set is not the same as the older broad REST scopes.
The key scopes for the main Zoom MCP server are:
- `ai_companion:read:search` — Search across Zoom Meeting, Zoom Chat, and Zoom Doc, returning the most relevant results based on the query
- `meeting:read:search` — Search and view meetings
- `meeting:read:assets` — View a meeting's assets
- `cloud_recording:read:list_user_recordings` — Lists all cloud recordings for a user.
- `cloud_recording:read:content` — read recording content scope
- `docs:write:import` — Create a new file by import
- `docs:read:export` — Read file content in Markdown format

For Zoom Docs MCP specifically, the official docs page shows these granular scopes for the documented tools:
- `docs:write:import` — Create a new file by import
- `docs:read:export` — Read file content in Markdown format

**3. AI Companion features are feature prerequisites, not scope substitutes**

Semantic meeting search, meeting assets, and recording-content retrieval depend on account
features such as **Smart Recording** and **Meeting Summary** for useful results. These feature
settings do not replace the required OAuth scopes.

**4. Whiteboard is a separate MCP surface**

The Zoom MCP endpoint and the Whiteboard MCP endpoint are separate. Route Whiteboard-specific
requests to [whiteboard/SKILL.md](whiteboard/SKILL.md).

**5. Use REST for deterministic meeting CRUD**

The current Zoom MCP tool surface does not expose deterministic
meeting create, update, or delete tools. If the user needs explicit meeting CRUD operations,
route to [../rest-api/SKILL.md](../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` |

Dedicated Docs MCP server:

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

Dedicated Whiteboard MCP skill:
- [whiteboard/SKILL.md](whiteboard/SKILL.md)

## Search and Retrieval Model

`search_meetings` uses AI Companion retrieval rather than a plain metadata filter. In this
use the live MCP server as authoritative for response schema and scope behavior.

Two result families matter most:

- **Recap-oriented results**: AI summary, meeting-linked documents, recordings, and related assets
- **Recording-oriented results**: cloud recording references and transcript-capable resources

Use [examples/transcript-retrieval.md](examples/transcript-retrieval.md) for the main retrieval
workflow.

## 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` |

\* Required parameter

Full parameter and output guidance: [references/tools.md](references/tools.md)

## Key Workflows

**Search meeting content, then retrieve assets:**
```text
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"
```

**List recordings, then retrieve recording resources:**
```text
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"
```

**Create or fetch a Zoom Doc:**
- use the dedicated `zoom-docs-mcp` server rather than the main `zoom-mcp` server
- official documented tools on the Zoom Docs MCP page are:
  - `create_file_with_content`
  - `get_file_content`

## Error Reference

| Code | Meaning | Fix |
|------|---------|-----|
| `401 Unauthorized` | Missing or rejected bearer token at the endpoint | Set `ZOOM_MCP_ACCESS_TOKEN`, then restart Claude or re-enable the plugin |
| `-32001 Invalid access token` | Token expired, malformed, or missing required scopes | Refresh OAuth token and verify the MCP-specific scopes |
| `-32602 Can not found tool` | Requested tool name is not exposed by the active MCP server | Re-run `tools/list` and use the current tool names for that endpoint |
| `404` | Possible downstream resource-not-found response | Re-discover the target with `search_meetings` or `recordings_list` |

Full error reference: [references/error-codes.md](references/error-codes.md)

## Documentation

### Concepts
- [concepts/mcp-architecture.md](concepts/mcp-architecture.md) — MCP protocol, hosted endpoints, discovery, and capability model
- [concepts/oauth-setup.md](concepts/oauth-setup.md) — OAuth app creation, MCP-specific scopes, AI Companion prerequisites, token lifecycle

### Examples
- [examples/transcript-retrieval.md](examples/transcript-retrieval.md) — Search/assets and recording-resource workflows
- [examples/create-zoom-doc.md](examples/create-zoom-doc.md) — Verified Zoom Docs creation flow
- [examples/search-and-act.md](examples/search-and-act.md) — Search, inspect assets, and hand off CRUD work to REST when needed
- [examples/meeting-lifecycle.md](examples/meeting-lifecycle.md) — Why meeting CRUD belongs in REST, plus the MCP-to-REST handoff pattern

### References
- [references/tools.md](references/tools.md) — Current Zoom MCP tool reference
- [references/error-codes.md](references/error-codes.md) — MCP and Zoom API errors with fixes
- [whiteboard/SKILL.md](whiteboard/SKILL.md) — Dedicated Whiteboard MCP skill

### Troubleshooting
- [troubleshooting/common-errors.md](troubleshooting/common-errors.md) — Scope failures, endpoint mixups, search/recording issues

### Operations
- [RUNBOOK.md](RUNBOOK.md) — 5-minute preflight and debugging checklist

## Related Skills

- [zoom-rest-api](../rest-api/SKILL.md) — Deterministic REST API access, including meeting CRUD
- [zoom-oauth](../oauth/SKILL.md) — OAuth implementation patterns
- [zoom-webhooks](../webhooks/SKILL.md) — Event-driven recording and meeting workflows
- [zoom-rtms](../rtms/SKILL.md) — Live media and transcript streams during active meetings

Источник: anthropics/knowledge-work-plugins / zoom-plugin / zoom-mcp ↗. Ссылка проверена 2026-10-10.

---
name: zoom-mcp
description: Руководство по встроенным коннекторам Zoom MCP. Используй после маршрутизации в рабочий процесс MCP, когда планируешь или отлаживаешь доступ через инструменты к встречам, записям, материалам встреч и расшифровкам. Запросы по Zoom Docs направляй на отдельный MCP-сервер Docs, а запросы именно по Whiteboard — в `zoom-mcp/whiteboard`.
user-invocable: false
triggers:
  - "zoom mcp"
  - "zoom mcp server"
  - "zoom mcp tools"
  - "zoom tools/list"
  - "zoom tools/call"
  - "ai companion transcript"
  - "agentic retrieval"
  - "zoom semantic meeting search"
  - "zoom search meetings by content"
  - "zoom meeting assets mcp"
  - "zoom recording resource mcp"
  - "zoom docs via mcp"
  - "zoom transcript via mcp"
  - "meeting transcript via mcp"
---

# Zoom MCP

Руководство по встроенному коннектору Zoom MCP в этом плагине Claude. Сначала обращайся к `design-mcp-workflow` или [setup-zoom-mcp](../setup-zoom-mcp/SKILL.md), а сюда переходи за подробностями об инструментах, требованиях к аутентификации и ограничениях, специфичных для MCP.

# MCP-сервер Zoom

Этот плагин включает размещённый у Zoom MCP-сервер `mcp-us.zoom.us`, который даёт ИИ-агентам доступ к:

- семантическому поиску по встречам
- получению материалов, связанных со встречей
- получению ресурсов записей

Zoom Docs доступны через отдельный встроенный сервер:

- `zoom-docs-mcp` по адресу `mcp.zoom.us`
- создан специально для создания и получения Zoom Docs

Текущие имена инструментов основного MCP-сервера Zoom:

- `get_meeting_assets`
- `search_meetings`
- `get_recording_resource`
- `recordings_list`

Некоторые MCP-клиенты добавляют к именам инструментов префикс сервера в интерфейсе, например `zoom-mcp:recordings_list`.
Эталонными считай исходные имена инструментов, приведённые выше.

Работу с Zoom Docs через MCP веди через отдельный сервер `zoom-docs-mcp`.

Работа с Whiteboard через MCP описана в отдельном скилле
[whiteboard/SKILL.md](whiteboard/SKILL.md).

## Быстрый старт

**1. Экспортируй токен, которого ждёт встроенный коннектор:**

```bash
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](references/tools.md).

**4. Выполни первый полезный вызов:**
```text
recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
  page_size: 10
```

## Важные замечания

**1. Задокументированный путь выполнения — пользовательский OAuth**

Для работы с инструментами Zoom MCP в этом плагине используй **General-приложение** с **OAuth на уровне пользователя**.
Не рассчитывай на Server-to-Server OAuth как на поддерживаемую модель аутентификации MCP.

**2. Zoom MCP использует собственные детализированные права (scopes)**

Набор прав Zoom MCP не совпадает со старыми широкими правами REST.
Основные права для главного MCP-сервера Zoom:
- `ai_companion:read:search` — поиск по Zoom Meeting, Zoom Chat и 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. Whiteboard — отдельная область MCP**

Конечная точка Zoom MCP и конечная точка Whiteboard MCP — разные. Запросы именно по Whiteboard направляй
в [whiteboard/SKILL.md](whiteboard/SKILL.md).

**5. Для предсказуемых операций со встречами используй REST**

Текущий набор инструментов Zoom MCP не содержит надёжных инструментов
создания, изменения и удаления встреч. Если пользователю нужны явные операции CRUD со встречами,
направляй его в [../rest-api/SKILL.md](../rest-api/SKILL.md).

## Адреса серверов

| Транспорт | URL |
|-----------|-----|
| Streamable HTTP (рекомендуется) | `https://mcp-us.zoom.us/mcp/zoom/streamable` |
| SSE (запасной вариант) | `https://mcp-us.zoom.us/mcp/zoom/sse` |

Отдельный MCP-сервер Docs:

| Транспорт | URL |
|-----------|-----|
| Streamable HTTP (рекомендуется) | `https://mcp.zoom.us/mcp/docs/streamable` |
| SSE (запасной вариант) | `https://mcp.zoom.us/mcp/docs/sse` |

Отдельный скилл по Whiteboard MCP:
- [whiteboard/SKILL.md](whiteboard/SKILL.md)

## Модель поиска и получения данных

`search_meetings` использует поиск AI Companion, а не простой фильтр по метаданным. Схему ответа и поведение прав
в этом случае определяет живой MCP-сервер: считай его эталоном.

Важнее всего два семейства результатов:

- **Результаты по итогам встречи**: ИИ-резюме, связанные со встречей документы, записи и сопутствующие материалы
- **Результаты по записям**: ссылки на облачные записи и ресурсы, из которых можно получить расшифровку

Основной порядок получения данных описан в [examples/transcript-retrieval.md](examples/transcript-retrieval.md).

## Каталог инструментов

| Инструмент | Основные параметры | Необходимое право |
|------|---------------|----------------|
| `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](references/tools.md)

## Основные рабочие процессы

**Найти содержимое встречи, затем получить материалы:**
```text
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"
```

**Получить список записей, затем ресурсы записи:**
```text
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`

## Справочник ошибок

| Код | Значение | Что делать |
|------|---------|-----|
| `401 Unauthorized` | Токен доступа (bearer) отсутствует или отклонён конечной точкой | Задай `ZOOM_MCP_ACCESS_TOKEN`, затем перезапусти Claude или заново включи плагин |
| `-32001 Invalid access token` | Токен просрочен, повреждён или не хватает нужных прав | Обнови токен OAuth и проверь права, специфичные для MCP |
| `-32602 Can not found tool` | Запрошенного имени инструмента нет на активном MCP-сервере | Снова выполни `tools/list` и используй актуальные имена инструментов для этой конечной точки |
| `404` | Возможный ответ «ресурс не найден» от нижележащего сервиса | Найди цель заново через `search_meetings` или `recordings_list` |

Полный справочник ошибок: [references/error-codes.md](references/error-codes.md)

## Документация

### Концепции
- [concepts/mcp-architecture.md](concepts/mcp-architecture.md) — протокол MCP, размещённые конечные точки, обнаружение и модель возможностей
- [concepts/oauth-setup.md](concepts/oauth-setup.md) — создание приложения OAuth, права для MCP, предварительные условия AI Companion, жизненный цикл токена

### Примеры
- [examples/transcript-retrieval.md](examples/transcript-retrieval.md) — рабочие процессы поиска, материалов и ресурсов записи
- [examples/create-zoom-doc.md](examples/create-zoom-doc.md) — проверенный порядок создания Zoom Docs
- [examples/search-and-act.md](examples/search-and-act.md) — поиск, просмотр материалов и передача операций CRUD в REST при необходимости
- [examples/meeting-lifecycle.md](examples/meeting-lifecycle.md) — почему CRUD встреч относится к REST и как устроена передача из MCP в REST

### Справочники
- [references/tools.md](references/tools.md) — актуальный справочник инструментов Zoom MCP
- [references/error-codes.md](references/error-codes.md) — ошибки MCP и Zoom API с решениями
- [whiteboard/SKILL.md](whiteboard/SKILL.md) — отдельный скилл по Whiteboard MCP

### Устранение неполадок
- [troubleshooting/common-errors.md](troubleshooting/common-errors.md) — нехватка прав, путаница с конечными точками, проблемы с поиском и записями

### Эксплуатация
- [RUNBOOK.md](RUNBOOK.md) — пятиминутная предварительная проверка и чек-лист отладки

## Связанные скиллы

- [zoom-rest-api](../rest-api/SKILL.md) — предсказуемый доступ через REST API, включая CRUD встреч
- [zoom-oauth](../oauth/SKILL.md) — схемы реализации OAuth
- [zoom-webhooks](../webhooks/SKILL.md) — событийные рабочие процессы для записей и встреч
- [zoom-rtms](../rtms/SKILL.md) — живые потоки медиа и расшифровок во время идущих встреч

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/zoom-mcp, лицензия MIT. Изменения: перевод на русский язык.