zoom-automation

Rube MCP による Zoom の自動化

Composio の Zoom ツールキットを通じて、ミーティングのスケジュール設定、ウェビナーの管理、クラウド録画の取得、参加者の追跡、利用状況のレポート作成など、Zoom の操作を自動化します。

前提条件

• Rube MCP に接続されていること（RUBE_SEARCH_TOOLS を利用可能）
• zoom ツールキットを指定した RUBE_MANAGE_CONNECTIONS を通じて、Zoom への有効な接続があること
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出すこと
• ほとんどの機能には有料の Zoom アカウント（Pro プラン以上）が必要です

セットアップ

Rube MCP を入手する：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。アカウントの OAuth、承認済みスコープ、有効な接続も引き続き必要です。サーバーを追加しても Zoom へのアクセス権は付与されません。ホスト設定の変更は、許可されている場合に限ります。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. zoom ツールキットを指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Zoom OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

書き込み操作の前に、ユーザー／アカウント、ミーティングの開催日時、タイムゾーン、宛先、録画への同意を確認してください。ミーティング一覧の取得は、招待、登録、自動録画、削除を許可するものではありません。ホストの start_url、録画ダウンロードトークン、署名付き URL は認証情報として扱い、公開したり、検証されていないリダイレクト先に認証情報を転送したりしないでください。承認済みの録画のみを、アクセス制限された保存先に取得してください。書き込みの成否が不明な場合は、再試行する前に現在の状態を確認してください。最新のスキーマ、利用上限、プランの権利が、静的な例より優先されます。

1. ミーティングの作成とスケジュール設定

使用する場面：ユーザーが特定の日時、時間、設定で新しい Zoom ミーティングを作成したい場合

ツールの呼び出し順序：

1. ZOOM_GET_USER - 認証済みユーザーを確認し、ライセンスの種類を確認します［前提条件］
2. ZOOM_CREATE_A_MEETING - トピック、日時、時間、設定を指定してミーティングを作成します［必須］
3. ZOOM_GET_A_MEETING - join_url を含むミーティングの詳細を取得します［任意］
4. ZOOM_UPDATE_A_MEETING - ミーティングの設定を変更するか、スケジュールを変更します［任意］
5. ZOOM_ADD_A_MEETING_REGISTRANT - 登録が有効なミーティングに参加者を登録します［任意］

主なパラメーター：

• userId：ユーザーレベルのアプリでは、常に "me" を使用します
• topic：ミーティングの件名
• type：1（即時）、2（スケジュール済み）、3（固定時刻なしの定期開催）、8（固定時刻の定期開催）
• start_time：ISO 8601 形式（UTC の場合は yyyy-MM-ddTHH:mm:ssZ、タイムゾーンフィールドを指定する場合は yyyy-MM-ddTHH:mm:ss）
• timezone：タイムゾーン ID（例："America/New_York"）
• duration：時間（分）
• settings__auto_recording："none"、"local"、"cloud" のいずれか
• settings__waiting_room：待機室を有効にするかどうかを指定するブール値
• settings__join_before_host：ホストより先に参加できるようにするかを指定するブール値（待機室が有効な場合は無効になります）
• settings__meeting_invitees：メールアドレスを含む招待者オブジェクトの配列

注意点：

• start_time は未来の日時である必要があります。Zoom は入力されたタイムゾーンにかかわらず、時刻を UTC で保存して返します
• type が 2 で start_time が設定されていない場合、即時ミーティングになり、30 日後に有効期限が切れます
• 参加者用の join_url とホスト用の start_url は作成時のレスポンスに含まれます。保存しておいてください
• start_url の有効期限は 2 時間です（custCreate ユーザーの場合は 90 日です）
• ミーティングの作成は 1 日あたり 100 件に制限されています
• 設定名のネストには、二重アンダースコアを使用します（例：settings__host_video）

2. ミーティングの一覧表示と管理

使用するタイミング：ユーザーが今後のミーティング、開催中のミーティング、過去のミーティングを確認したい場合

ツールの順序：

1. ZOOM_LIST_MEETINGS - 種類（スケジュール済み、開催中、今後、過去）でミーティングを一覧表示します［必須］
2. ZOOM_GET_A_MEETING - 特定のミーティングの詳細情報を取得します［任意］
3. ZOOM_UPDATE_A_MEETING - ミーティングの詳細を変更します［任意］

主なパラメーター：

• userId：認証済みユーザーには "me" を使用します
• type："scheduled"（デフォルト）、"live"、"upcoming"、"upcoming_meetings"、"previous_meetings"
• page_size：ページあたりのレコード数（デフォルトは30）
• next_page_token：前回の応答で取得したページネーショントークン
• from / to：日付範囲のフィルター

注意点：

• ZOOM_LIST_MEETINGS はインスタントミーティングを除外し、有効期限内のスケジュール済みミーティングのみを表示します
• 過去のミーティングには、type: "previous_meetings" を使用します
• ページネーション：すべての結果を取得するには、next_page_token が空になるまで常に次のページを取得します
• トークンの有効期限：next_page_token は15分後に有効期限が切れます
• ミーティング ID は10桁を超えることがあるため、標準の整数ではなく長整数として保存します

3. 録画を管理する

使用するタイミング：ユーザーがクラウド録画を一覧表示、取得、削除したい場合

ツールの順序：

1. ZOOM_LIST_ALL_RECORDINGS - 日付範囲内のユーザーのクラウド録画をすべて一覧表示します［必須］
2. ZOOM_GET_MEETING_RECORDINGS - 特定のミーティングの録画を取得します［任意］
3. ZOOM_DELETE_MEETING_RECORDINGS - 録画をゴミ箱に移動するか、完全に削除します［任意］
4. ZOOM_LIST_ARCHIVED_FILES - アーカイブされたミーティング／ウェビナーファイルを一覧表示します［任意］

主なパラメーター：

• userId：認証済みユーザーには "me" を使用します
• from / to：yyyy-mm-dd 形式の日付範囲（最長1か月）
• meetingId：特定の録画を取得するためのミーティング ID または UUID
• action：削除時は "trash"（復元可能）または "delete"（完全削除）
• include_fields：録画をダウンロードするための JWT を取得するには "download_access_token" を設定します
• trash：ゴミ箱内の録画を一覧表示するには true を設定します

注意点：

• 日付範囲の上限は1か月です。範囲がこれを超えると、API は from を自動調整します
• アカウントでクラウド録画を有効にする必要があります
• / で始まる UUID、または // を含む UUID は二重に URL エンコードする必要があります
• ZOOM_DELETE_MEETING_RECORDINGS のデフォルトのアクションは "trash"（復元可能）です。"delete" は完全削除です
• パスコードで保護された録画のダウンロード URL には、Authorization ヘッダーに OAuth トークンが必要です
• Pro プラン以上が必要です

4. ミーティング参加者とレポートを取得する

使用するタイミング：ユーザーが過去のミーティングの参加者を確認したい場合、または利用統計を取得したい場合

ツールの順序：

1. ZOOM_GET_PAST_MEETING_PARTICIPANTS - 終了したミーティングの参加者を一覧表示します［必須］
2. ZOOM_GET_A_MEETING - 今後のミーティングの詳細と登録情報を取得します［任意］
3. ZOOM_GET_DAILY_USAGE_REPORT - 日ごとの利用統計（ミーティング、参加者、分数）を取得します［任意］
4. ZOOM_GET_A_MEETING_SUMMARY - AI が生成したミーティングの概要を取得します［任意］

主なパラメーター：

• meetingId：ミーティング ID（最新の開催回）または UUID（特定の開催回）
• page_size：ページあたりのレコード数（デフォルトは30）
• next_page_token：参加者リストが大きい場合のページネーショントークン

注意点：

• ZOOM_GET_PAST_MEETING_PARTICIPANTS は、有料プランで終了したミーティングに対してのみ動作します
• 1人だけのミーティング（他の参加者がいない場合）では、結果は空になります
• UUID のエンコード：/ で始まる UUID、または // を含む UUID は二重にエンコードする必要があります
• 参加者が欠落しないよう、next_page_token が空になるまで必ずページネーションを行います
• ZOOM_GET_A_MEETING_SUMMARY には AI Companion が有効な有料プランが必要です。無料アカウントでは 400 エラーが返されます
• ZOOM_GET_DAILY_USAGE_REPORT には厳しいレート制限があるため、頻繁な呼び出しは避けてください

5. ウェビナーを管理する

使用する場面：ウェビナーの一覧表示や参加者の登録を希望している場合

ツールの実行順序：

1. ZOOM_LIST_WEBINARS - 予定済みまたは今後のウェビナーを一覧表示します［必須］
2. ZOOM_GET_A_WEBINAR - ウェビナーの詳細情報を取得します［任意］
3. ZOOM_ADD_A_WEBINAR_REGISTRANT - ウェビナーに参加者を登録します［任意］

主なパラメーター：

• userId：認証済みユーザーには "me" を指定します
• type："scheduled"（デフォルト）または "upcoming"
• page_size：1ページあたりのレコード数（デフォルトは30）
• next_page_token：ページネーション用のトークン

注意点：

• ウェビナー機能には、ウェビナーアドオン付きの Pro プラン以上が必要です
• 無料／Basic アカウントではウェビナーツールを使用できません
• 有効期限が切れていないウェビナーのみが表示されます
• ZOOM_ADD_A_WEBINAR_REGISTRANT を使用するには、ウェビナーで登録が有効になっている必要があります

よくあるパターン

ID の解決

• ユーザー ID：ユーザーレベルのアプリでは、認証済みユーザーを示すために常に "me" を使用します
• ミーティング ID：数値の ID（long 整数として保存）を使用します。最新の開催回に使用します
• ミーティング UUID：定期ミーティングの特定の開催回に使用します。/ で始まる場合、または // を含む場合は二重にエンコードします
• 開催回 ID：定期ミーティングの特定の開催回を指定する際に使用します

ページネーション

Zoom の一覧表示エンドポイントの大半では、トークンベースのページネーションが使用されます。

• next_page_token が空または存在しなくなるまで続けます
• トークンは15分後に有効期限が切れます
• page_size を明示的に設定します（デフォルトは30ですが、エンドポイントによって異なります）
• page_number は使用しないでください（多くのエンドポイントで非推奨です）

時刻の扱い

• Zoom はすべての時刻を内部で UTC として保存します
• 現地時間を入力する場合は、start_time とともに timezone フィールドを指定します
• ISO 8601 形式を使用します：yyyy-MM-ddTHH:mm:ssZ（UTC）または yyyy-MM-ddTHH:mm:ss（timezone フィールドと併用）
• 日付のみのフィールドには yyyy-mm-dd 形式を使用します

既知の注意点

プランの要件

• 録画および参加者に関する機能の大半には、Pro プラン以上が必要です
• ウェビナー機能にはウェビナーアドオンが必要です
• AI ミーティング要約には、AI Companion 機能を有効にする必要があります
• アーカイブ済みファイルには、Zoom Support による「Meeting and Webinar Archiving」の有効化が必要です

レート制限

• ミーティングの作成：1日あたり100リクエスト、24時間以内に1つのミーティングを更新できるのは100回までです
• ZOOM_GET_PAST_MEETING_PARTICIPANTS：中程度のスロットリングが発生します。一括処理では遅延を加えてください
• ZOOM_GET_DAILY_USAGE_REPORT：厳しいレート制限があります
• ZOOM_GET_A_MEETING、ZOOM_GET_MEETING_RECORDINGS：軽度のレート制限があります
• ZOOM_LIST_MEETINGS、ZOOM_LIST_ALL_RECORDINGS：中程度のレート制限があります

パラメーターに関する特殊事項

• ネストされた設定には、二重アンダースコア表記を使用します（例：settings__waiting_room）
• start_url の有効期限は2時間です。必要に応じて API 経由で更新してください
• waiting_room が true の場合、join_before_host は自動的に無効になります
• 定期ミーティングのフィールド（recurrence__*）は、タイプ 3 および 8 にのみ適用されます
• password フィールドは最大10文字で、英数字および @、-、_、* のみ使用できます

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
ミーティングを作成	ZOOM_CREATE_A_MEETING	userId、topic、start_time、type
ミーティングの詳細を取得	ZOOM_GET_A_MEETING	meetingId
ミーティングを更新	ZOOM_UPDATE_A_MEETING	meetingId、更新するフィールド
ミーティングを一覧表示	ZOOM_LIST_MEETINGS	userId、type、page_size
ユーザー情報を取得	ZOOM_GET_USER	userId
録画を一覧表示	ZOOM_LIST_ALL_RECORDINGS	userId、from、to
録画を取得	ZOOM_GET_MEETING_RECORDINGS	meetingId
録画を削除	ZOOM_DELETE_MEETING_RECORDINGS	meetingId、action
過去の参加者	ZOOM_GET_PAST_MEETING_PARTICIPANTS	meetingId、page_size
日次使用状況レポート	ZOOM_GET_DAILY_USAGE_REPORT	日付パラメーター
ミーティングの要約	ZOOM_GET_A_MEETING_SUMMARY	meetingId
ウェビナーを一覧表示	ZOOM_LIST_WEBINARS	userId、type
ウェビナーを取得	ZOOM_GET_A_WEBINAR	ウェビナー ID
ミーティングに登録	ZOOM_ADD_A_MEETING_REGISTRANT	meetingId、参加者の詳細
ウェビナーに登録	ZOOM_ADD_A_WEBINAR_REGISTRANT	ウェビナー ID、参加者の詳細
アーカイブファイルを一覧表示	ZOOM_LIST_ARCHIVED_FILES	from、to

使用する場合

このスキルは、概要に記載されているワークフローやアクションを実行する場合に適用できます。

例

ユーザーのリクエスト：

Rube MCP（Composio）を通じて、Zoom ミーティングの作成と管理、録画、ウェビナー、参加者の追跡を自動化してください。

制限事項

• このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、処理を中断して確認してください。