Zoom MCP

このClaudeプラグインにバンドルされているZoom MCPコネクタのガイダンスです。まず design-mcp-workflow または setup-zoom-mcp を優先し、その後ツール表面の詳細、認証の期待値、MCPの制約について、ここにルーティングしてください。

Zoom MCPサーバー

このプラグインは、mcp-us.zoom.us にあるZoomのホスト型MCPサーバーをバンドルしており、AIエージェントが以下にアクセスできます:

• セマンティックミーティング検索
• ミーティング連携アセット取得
• 録画リソース取得

Zoom Docsは別個のバンドルサーバーを通じて公開されています:

• zoom-docs-mcp (at mcp.zoom.us)
• Zoom Docs作成と取得用に特別に設計

メインのZoom MCPサーバーからの現在のツール名:

• get_meeting_assets
• search_meetings
• get_recording_resource
• recordings_list

一部のMCPクライアントはUIでサーバーツールに名前空間を付与する場合があります。例: 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はドキュメント化された実行パス

このプラグインのZoom MCPツール使用の実行パスとして、ユーザーレベルOAuthを備えた General app を使用してください。Server-to-Server OAuthを、ここでのサポート対象MCPAuthモデルとして信頼しないでください。

2. Zoom MCPはMCP固有の細粒度スコープを使用

Zoom MCPスコープセットは、古い広範なRESTスコープと同じではありません。 メインのZoom MCPサーバーの主要なスコープは以下の通りです:

• 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. ホワイトボードは別個のMCPサーフェス

Zoom MCPエンドポイントとホワイトボードMCPエンドポイントは別個です。ホワイトボード固有のリクエストは whiteboard/SKILL.md にルーティングしてください。

5. 決定論的なミーティングCRUD操作にはRESTを使用

現在のZoom MCPツールサーフェスは、決定論的なミーティング作成、更新、または削除ツールを公開していません。ユーザーが明示的なミーティングCRUD操作を必要とする場合は、../rest-api/SKILL.md にルーティングしてください。

サーバーエンドポイント

トランスポート	URL
Streamable HTTP (推奨)	https://mcp-us.zoom.us/mcp/zoom/streamable
SSE (フォールバック)	https://mcp-us.zoom.us/mcp/zoom/sse

専用Docs MCPサーバー:

トランスポート	URL
Streamable HTTP (推奨)	https://mcp.zoom.us/mcp/docs/streamable
SSE (フォールバック)	https://mcp.zoom.us/mcp/docs/sse

専用ホワイトボードMCPスキル:

• whiteboard/SKILL.md

検索と取得モデル

search_meetings は平文メタデータフィルターではなく、AI Companionの取得を使用します。このユースケースではライブMCPサーバーをレスポンススキーマとスコープ動作の権威的な情報源として使用してください。

最も重要な2つの結果ファミリーは:

• Recap指向の結果: AI概要、ミーティング連携ドキュメント、録画、および関連アセット
• 録画指向の結果: クラウド録画参照およびトランスクリプト対応リソース

メイン取得ワークフローについては 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

主要ワークフロー

ミーティングコンテンツを検索してからアセットを取得:

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"

Zoom Docを作成または取得:

• メインの zoom-mcp サーバーではなく、専用の zoom-docs-mcp サーバーを使用してください
• Zoom Docs MCPページのドキュメント化されたツールは:
  • create_file_with_content
  • get_file_content

エラーリファレンス

コード	意味	修正方法
401 Unauthorized	エンドポイントでのベアラートークンの欠落または拒否	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

ドキュメント

コンセプト

• concepts/mcp-architecture.md — MCPプロトコル、ホスト型エンドポイント、ディスカバリー、およびケイパビリティモデル
• concepts/oauth-setup.md — OAuthアプリ作成、MCP固有スコープ、AI Companion前提条件、トークンライフサイクル

例

• 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/tools.md — 現在のZoom MCPツールリファレンス
• references/error-codes.md — MCPおよびZoom APIエラーと修正方法
• whiteboard/SKILL.md — 専用ホワイトボードMCPスキル

トラブルシューティング

• troubleshooting/common-errors.md — スコープ失敗、エンドポイント混在、検索/録画問題

運用

• RUNBOOK.md — 5分間の実行前チェックおよびデバッグチェックリスト

関連スキル

• zoom-rest-api — 決定論的なREST APIアクセス、ミーティングCRUD含む
• zoom-oauth — OAuth実装パターン
• zoom-webhooks — イベント駆動型録画およびミーティングワークフロー
• zoom-rtms — アクティブミーティング中のライブメディアおよびトランスクリプトストリーム