zoom-mcp

Zoom MCP

この Claude プラグインにバンドルされている Zoom MCP コネクターのガイダンスです。まず design-mcp-workflow または setup-zoom-mcp を優先して利用し、その後、ツールの詳細、認証要件、MCP 固有の制約についてはここを参照してください。

Zoom MCP サーバー

このプラグインには、AI エージェントが次の操作を行うための Zoom のホスト型 MCP サーバー mcp-us.zoom.us がバンドルされています。

• ミーティングのセマンティック検索
• ミーティングに関連付けられたアセットの取得
• 録画リソースの取得

Zoom Docs は、別のバンドル済みサーバーを通じて提供されます。

• mcp.zoom.us の zoom-docs-mcp
• 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 ツールを使用する際は、General app とユーザーレベルの OAuthを実行方法として使用してください。ここでは、Server-to-Server OAuth がサポート対象の MCP 認証方式であることを前提にしないでください。

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. Whiteboard は独立した MCP サーフェスです

Zoom MCP エンドポイントと Whiteboard MCP エンドポイントは別々です。Whiteboard 固有の リクエストは 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

専用の Whiteboard MCP スキル：

• whiteboard/SKILL.md

検索と取得のモデル

search_meetings は、単純なメタデータフィルターではなく、AI Companion の取得機能を使用します。この用途では、応答スキーマとスコープの動作について、稼働中の MCP サーバーを正式な情報源として使用してください。

特に重要な結果は、次の 2 種類です。

• 要約向けの結果：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"
→ 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-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 — 専用の Whiteboard MCP スキル

トラブルシューティング

• troubleshooting/common-errors.md — スコープのエラー、エンドポイントの取り違え、検索や録画に関する問題

運用

• RUNBOOK.md — 事前確認とデバッグのチェックリスト（5 分）

関連スキル

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