zoom-skills

Zoom Developer Platform Skills

このリポジトリには、Web、モバイル、デスクトップ、サーバー環境にわたって、Zoom SDK、API、MCP サーバー、インテグレーションを使用して構築するためのスキルが含まれています。

リポジトリの注意事項

• general/references/sdk-upgrade-workflow.md - 変更履歴と RSS を活用した、バージョンごとに再利用可能な SDK アップグレードワークフロー
• リポジトリレベルのツール、プラグインのマニフェスト、メンテナンス用ドキュメントはパッケージングのルートにあります。スキルのみをインストールする場合は、この skills/ ツリーを移植可能な境界として扱ってください。

フォルダー構成

フォルダー	説明
zoom-general	ハブ - 製品を横断するユースケースと共通リファレンス
zoom-rest-api	REST API 呼び出し（600 以上のエンドポイント）
zoom-webhooks	リアルタイムイベント通知（HTTP）
zoom-websockets	リアルタイムイベント通知（WebSocket）
zoom-meeting-sdk	アプリへの Zoom ミーティングの組み込み（Web、React Native、Electron、Linux）
zoom-video-sdk	カスタムビデオ体験（Web、React Native、Flutter、Android、iOS、macOS、Unity、Linux）
zoom-plugin-sdk	IPC 経由でインストール済みの Zoom Workplace クライアントを操作する、macOS／Windows ネイティブのコンパニオンアプリ
zoom-apps-sdk	Zoom クライアント内で動作するアプリ
scribe	アップロード済みまたは保存済みのメディアを同期またはバッチで文字起こしする Zoom AI Services Scribe
summarizer	文字起こしの振り返り、要約、アクションアイテムを作成する Zoom AI Services Summarizer
translator	プレーンテキストとバッチファイルを翻訳する Zoom AI Services Translator
decisions	述語、制約付き選択、順序付きスコア、確率、画像比較に対応する Zoom AI Services Decisions
zoom-rtms	リアルタイムメディアストリーム（ライブ音声／動画／文字起こし）
zoom-team-chat	Team Chat のメッセージとチャンネル
virtual-agent	Virtual Agent のウェブ／モバイルチャット埋め込みとナレッジベース同期ワークフロー
contact-center	Contact Center アプリ、ウェブ埋め込み、ネイティブモバイル SDK 連携
phone	Zoom Phone API、Smart Embed、URI スキーム、ウェブフック、通話履歴の移行パターン
rivet-sdk	OAuth、ウェブフックイベント、型付き API エンドポイントラッパー向けの Rivet JavaScript サーバーフレームワーク
probe-sdk	Meeting SDK または Video SDK の参加フロー前に行う、ブラウザー／デバイス／ネットワークの準備状況診断
zoom-ui-toolkit	Video SDK 用の構築済み React コンポーネント
zoom-cobrowse-sdk	サポート向けの共同ブラウジング
zoom-oauth	OAuth 認証フロー（4 種類すべてのグラントタイプ）
zoom-mcp	統合 Zoom MCP サーバーと専用製品 MCP サーバーの親ルーター
zoom-mcp/whiteboard	ホワイトボードの作成、取得、共同編集者ツール
zoom-mcp/team-chat	Team Chat のメッセージ、ファイル、連絡先、セッション、チャンネル、メンバーツール
zoom-mcp/meetings	ミーティング検索、アセット、録画、録画リソース
zoom-mcp/canvas	Canvas のファイル、ブロック、共同編集者、コンテンツツール
zoom-mcp/tasks	タスク、コメント、担当者、共同編集者、ステップのツール
zoom-mcp/revenue-accelerator	ZRA の会話インテリジェンス、商談、顧客、コーチングデータ
zoom-mcp/admin	Admin MCP によるアカウント設定、グループ、ユーザー、権限の管理
zoom-mcp/productivity	AI Productivity Suite の Sheets ツール
zoom-mcp/contact-center-admin	Contact Center のユーザー、キュー、ロール、スキル、番号の管理

使用方法

1. 特定製品に関するタスクですか？ → その製品のフォルダー（例：meeting-sdk/）に移動します
2. 複数製品にまたがるタスク、または一般的なタスクですか？ → 一般的なユースケースについては zoom-general を確認します
3. 各フォルダーには SKILL.md があります → その製品の概要を把握するには、まずそこから始めます

Marketplace の前提条件： 多くの製品スキルでは、認証情報、スコープ、Webhook、SDK キーを用意する前に Zoom Marketplace アプリが必要です。タスクがアプリの作成、アプリの種類の選択、マニフェストの検証、スコープ、イベントサブスクリプション、認証情報の取得から始まる場合は、まず Marketplace アプリ管理に進み、その後、製品スキルに戻ります。 選択を自動化する場合は、 Marketplace テンプレートインデックスを確認します。 既存の General Apps にはマニフェスト更新ワークフローを使用します。S2S と Meeting SDK の項目は、General App マニフェストではなく、作成リクエストです。 外部 REST/MCP コネクターと、マニフェストで管理するアクションまたはトリガーには、適切な 機能フラグメントを完全な General App マニフェストに統合します。これは、Zoom がホストする MCP サーバーの OAuth 設定とは異なります。

スキルの検出（統合型）

このリポジトリでは、段階的な検出方式を使用します。

• エージェントは最初に SKILL.md のフロントマター（name、description、任意の triggers）を読み取ります。
• エージェントは、general/SKILL.md の「Choose Your Path」とキーワード／トリガーの照合に基づいて、意図に応じて振り分けます。
• エージェントは、振り分け先の選択後にのみ、スキルの全コンテンツを読み込みます。

スキルの振り分け精度を高めるには：

• description を具体的でキーワード豊富な内容にし、「use when...」を含めます。
• よくあるユーザーの言い回しに対応する実用的な triggers を追加します。
• Meeting SDK、Video SDK、REST API、MCP の意図でトリガーが重複しないようにします。

zoom-general（ハブ）

zoom-general フォルダーには、次の内容が含まれています。

• 複数製品にまたがるユースケース - 複数の Zoom 製品に関連するタスク
• 一般的なリファレンス - 認証、アプリの種類、スコープ
• 共有ドキュメント - SDK のメンテナンス、トラブルシューティング、Marketplace への公開

次の場合は zoom-general を使用します。

• 新しい Zoom 連携を始めるにあたり、適切な方法を選ぶ必要がある
• ユースケースが複数の Zoom 製品に関係する
• 一般的なプラットフォームのドキュメント（認証、スコープなど）が必要である

クイックリファレンス

目的	使用するスキル
明示的にリクエストを制御しながら、決定論的な自動化／設定／レポートを構築する	zoom-rest-api
Marketplace マニフェスト、Connect ルート、アクション、トリガーを作成または更新する	zoom-rest-api
イベント通知を受信する（HTTP プッシュ）	zoom-webhooks
イベント通知を受信する（WebSocket）	zoom-websockets
アプリに Zoom ミーティングを埋め込む	zoom-meeting-sdk
カスタムビデオ体験を構築する	zoom-video-sdk
ネイティブデスクトップアプリから、インストール済みの Zoom Workplace クライアントを操作する	zoom-plugin-sdk
Zoom クライアント内でアプリを構築する	zoom-apps-sdk
ライブ音声／ビデオ／トランスクリプトにアクセスする	zoom-rtms
アップロードまたは保存されたメディアファイルをテキストに文字起こしする	scribe
トランスクリプトのテキストを要約し、振り返り、要約、アクションアイテムを作成する	summarizer
プレーンテキストまたは保存済みのテキストファイルを翻訳する	translator
述語を評価し、固定の選択肢に分類し、順序付きレベルでスコアを付ける、または画像を比較する	decisions
Team Chat 連携を構築する	zoom-team-chat
Virtual Agent のチャット／キャンペーン体験を構築する	virtual-agent
Contact Center 連携（アプリ／ウェブ／モバイル）を構築する	contact-center
Zoom Phone 連携（Smart Embed、API、ウェブフック、URI 起動）を構築する	phone
Rivet ベースのサーバー連携を構築する（任意）	rivet-sdk
参加前にブラウザー／デバイス／ネットワークの事前診断を実行する	probe-sdk
既成のビデオ UI コンポーネントを使用する	zoom-ui-toolkit
サポート向けの共同ブラウジングを有効にする	zoom-cobrowse-sdk
OAuth 認証を実装する	zoom-oauth
AI を活用したミーティング検索、ミーティングアセットの取得、録画リソースの取得、または Zoom Canvas のワークフローを構築する	zoom-mcp
MCP ツールを通じて Zoom Team Chat を検索、送信、編集、または管理する	zoom-mcp/team-chat
MCP を通じて Zoom Canvas のファイル、ブロック、共同作業者、または共有を管理する	zoom-mcp/canvas
MCP ツールを通じて Zoom Tasks を管理する	zoom-mcp/tasks
MCP を通じて ZRA の会話および商談インテリジェンスを取得する	zoom-mcp/revenue-accelerator
MCP を通じて Zoom アカウントのユーザー、グループ、権限、または設定を管理する	zoom-mcp/admin
MCP を通じて AI Productivity Suite Sheets を編集または管理する	zoom-mcp/productivity
MCP を通じて Contact Center のユーザー、キュー、ロール、スキル、または番号を管理する	zoom-mcp/contact-center-admin
安定した API コアと AI ツールレイヤーを組み合わせて、エンタープライズ向け AI ワークフローを構築する	zoom-rest-api + zoom-mcp
一般的なガイダンス／複数製品にまたがるガイダンス	zoom-general

API と MCP の使い分け（Zoom 公式ガイダンス）

主な目的	使用するもの
自動化、設定、レポート、スケジュール済みジョブ、厳密な再試行／エラー制御	zoom-rest-api
AI との対話、動的なツール検出、クロスプラットフォームの AI ワークフロー	zoom-mcp
大規模なエンタープライズ向け AI 体験	zoom-rest-api + zoom-mcp

出典：https://developers.zoom.us/docs/mcp/apis-vs-mcp/

• 詳細：general/use-cases/apis-vs-mcp-routing.md
• MCP トランスポートに関する注記：Zoom が現在ホストしている MCP カタログでは、Streamable HTTP が使用されています（クライアント側のサポートが必要です）。

MCP サーバーモデル（Zoom ホスト型）

• Zoom が MCP サーバーとして機能し、Zoom プラットフォームのツール／データを外部 AI クライアントに公開します。
• MCP アクセスは OAuth のスコープが適用され、管理されています。
• 現在、製品別の MCP サーバーとして、Meetings、Chat、Canvas、Tasks、Whiteboard、Revenue Accelerator が提供されています。統合 Zoom MCP Server は、これらとは別のオールインワンの接続先です。
• 親エントリーポイントとして zoom-mcp を使用し、続けて Marketplace アプリの作成 → ユーザーの OAuth トークン取得 → 製品固有の MCP 子スキルの順に進みます。Marketplace アプリテンプレートから対応するアプリテンプレートを選択してください。

リソース

• 公式ドキュメント: https://developers.zoom.us/
• マーケットプレイス: https://marketplace.zoom.us/
• 開発者フォーラム: https://devforum.zoom.us/

運用

• raw-skill のインストール時の実行時やデバッグに関するガイダンスについては、各スキルディレクトリ内にある製品の RUNBOOK.md ファイルを使用してください。