mcpField
Z
zoom-general

zoom-general

github.com/anthropics開発33.6k2.1k 回インストール1 日前に更新
リポジトリ

zoom-general について

Zoom の複数製品に関する開発課題を分類し、適切な専門スキルを組み合わせるスキルです。API、SDK、イベント、OAuth、MCP のルーティングと、判断が分かれる場合の確認方法を案内します。

主な機能

  1. 01Zoom 製品に関する要件の検出
  2. 02専門スキルの選定と連携
  3. 03REST、SDK、MCP の経路の区別
  4. 04曖昧なルーティングの確認
  5. 05一般的な連携シナリオの索引

活用シーン

  1. 01会議作成とイベント処理のスキル選定
  2. 02決定的な API 自動化と AI ツール連携の選択
  3. 03SDK 埋め込みやカスタム動画体験の計画
  4. 04Zoom MCP と Whiteboard MCP のリクエスト振り分け

MCP 対応

AI エージェントによるツール連携を zoom-mcp に振り分け、REST API と MCP の併用設計も案内します。Zoom が提供する MCP のトランスポートと製品範囲に関する情報も含みます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/anthropics/knowledge-work-plugins --skill zoom-general

インストール後、Claude Code で/zoom-generalを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

RUNBOOK.md
references/
app-types.md
authentication.md
authorization-patterns.md
automatic-skill-chaining-rest-webhooks.md
community-repos.md
distributed-meeting-fallback-architecture.md
environment-variables.md
interview-answer-routing.md
known-limitations.md
marketplace.md
meeting-webhooks-oauth-refresh-orchestration.md
query-routing-playbook.md
routing-implementation.md
scopes.md
sdk-logs-troubleshooting.md
sdk-upgrade-guide.md
sdk-upgrade-workflow.md
use-cases/
ai-companion-integration.md
ai-integration.md
apis-vs-mcp-routing.md
backend-automation-s2s-oauth.md
collaborative-apps.md
contact-center-app-lifecycle-and-context-switching.md
contact-center-integration.md
custom-meeting-ui-web.md
custom-video.md
customer-support-cobrowsing.md
electron-meeting-embed.md
embed-meetings.md

詳細

Zoom General（クロスプロダクトスキル）

Zoom の複数プロダクトにまたがる質問のための背景資料です。まずワークフロースキルを優先し、その後、このファイルを共有プラットフォームのガイダンスとルーティングの詳細に使用してください。

zoom-general が複雑な開発者向けクエリをルーティングする方法

zoom-general を分類と連携のレイヤーとして使用します。

  1. クエリ内の商品に関する手がかりを検出する
  2. プライマリスキルを1つ選択する
  3. 認証、イベント、デプロイの境界に対応するセカンダリスキルを追加する
  4. 2つのルートの確度が同程度の場合に限り、短い確認質問を1つ行う

最小限の実装：

type SkillId =
  | 'zoom-general'
  | 'zoom-rest-api'
  | 'zoom-webhooks'
  | 'zoom-oauth'
  | 'zoom-meeting-sdk-web-component-view'
  | 'zoom-video-sdk'
  | 'zoom-mcp';

const hasAny = (q: string, words: string[]) => words.some((w) => q.includes(w));

function detectSignals(rawQuery: string) {
  const q = rawQuery.toLowerCase();
  return {
    meetingCustomUi: hasAny(q, ['zoom meeting', 'custom ui', 'component view', 'embed meeting']),
    customVideo: hasAny(q, ['video sdk', 'custom video session', 'peer-video-state-change']),
    restApi: hasAny(q, ['rest api', '/v2/', 'create meeting', 'list users', 's2s oauth']),
    webhooks: hasAny(q, ['webhook', 'x-zm-signature', 'event subscription', 'crc']),
    oauth: hasAny(q, ['oauth', 'pkce', 'token refresh', 'account_credentials']),
    mcp: hasAny(q, ['zoom mcp', 'agentic retrieval', 'tools/list', 'semantic meeting search']),
  };
}

function pickPrimarySkill(s: ReturnType<typeof detectSignals>): SkillId {
  if (s.meetingCustomUi) return 'zoom-meeting-sdk-web-component-view';
  if (s.mcp) return 'zoom-mcp';
  if (s.restApi) return 'zoom-rest-api';
  if (s.customVideo) return 'zoom-video-sdk';
  return 'zoom-general';
}

function buildChain(primary: SkillId, s: ReturnType<typeof detectSignals>): SkillId[] {
  const chain = [primary];
  if (s.oauth && !chain.includes('zoom-oauth')) chain.push('zoom-oauth');
  if (s.webhooks && !chain.includes('zoom-webhooks')) chain.push('zoom-webhooks');
  return chain;
}

例：

  • ミーティングを作成し、Webhookを設定して、OAuthトークンの更新に対応する -> zoom-rest-api -> zoom-oauth -> zoom-webhooks
  • Web上でZoomミーティング用のカスタムビデオUIを構築する -> zoom-meeting-sdk-web-component-view

TypeScriptの完全な実装と引き継ぎの仕様については、 references/routing-implementation.mdを使用してください。

ニーズに応じた選択

やりたいこと使用するスキル
実際のZoomミーティングを中心としたカスタムWeb UIを構築するzoom-meeting-sdk-web-component-view
リクエストを明示的に制御して、予測可能な自動化、設定、レポートを構築するzoom-rest-api
イベント通知を受信する（HTTPプッシュ）zoom-webhooks
イベント通知を受信する（低遅延のWebSocket）zoom-websockets
アプリにZoomミーティングを埋め込むzoom-meeting-sdk
カスタムビデオ体験を構築する（Web、React Native、Flutter、Android、iOS、macOS、Unity、Linux）zoom-video-sdk
Zoomクライアント内で動作するアプリを構築するzoom-apps-sdk
AI Services Scribeでアップロード済みまたは保存済みのメディアを文字起こしするscribe
ミーティングのライブ音声、映像、文字起こしデータにアクセスするzoom-rtms
サポート向けに共同ブラウジングを有効にするzoom-cobrowse-sdk
Contact Centerアプリとチャネル連携を構築するcontact-center
Virtual AgentのWeb／モバイルチャットボット体験を構築するvirtual-agent
Zoom Phone連携を構築する（Smart Embed、Phone API、Webhook、URIフロー）phone
Team Chatアプリと連携を構築するzoom-team-chat
Rivetを使用してサーバーサイド連携を構築する（認証＋Webhook＋API）rivet-sdk
参加前にブラウザー、デバイス、ネットワークの事前診断を実行するprobe-sdk
Video SDK向けに事前構築済みのUIコンポーネントを追加するzoom-ui-toolkit
OAuth認証を実装する（すべてのグラントタイプ）zoom-oauth
Zoomデータを対象とするAI駆動のツールワークフロー（AI Companion／エージェント）を構築するzoom-mcp
Zoom Whiteboard MCPを使用した、AI駆動のWhiteboardワークフローを構築するzoom-mcp/whiteboard
安定したAPIコアとAIツールレイヤーを備えたエンタープライズAIシステムを構築するzoom-rest-api + zoom-mcp

計画時の確認事項：Rivet SDK（任意）

認証＋Webhook＋API呼び出しを組み合わせたサーバーサイド連携の計画をユーザーが始めたら、まず次の点を確認してください。

  • Rivet SDKは、Zoomの認証処理、Webhook受信機、型付きAPIラッパーをまとめたNode.jsフレームワークです。
  • 迅速なスキャフォールディングのためにRivet SDKを使用しますか。それとも、Rivetを使わずにOAuthとRESTを直接実装しますか。

回答後のルーティング：

  • ユーザーがRivetを選択した場合：rivet-sdk + oauth + rest-apiを連携します。
  • ユーザーがRivetを選択しない場合：oauth + rest-api（必要に応じてwebhooksまたはプロダクトスキル）を連携します。
SDK と REST のルーティングマトリクス（厳守）
ユーザーの意図正しい経路ルーティングしない先
アプリの UI に Zoom ミーティングを埋め込むzoom-meeting-sdkREST のみの join_url フロー
実際の Zoom ミーティング向けにカスタム Web UI を構築するzoom-meeting-sdk-web-component-viewzoom-video-sdk
カスタムのビデオ UI／セッションアプリを構築するzoom-video-sdkMeeting SDK または REST ミーティングリンク
ブラウザー参加リンクの取得／ミーティングリソースの管理zoom-rest-apiMeeting SDK の参加実装

ルーティングのガードレール：

  • SDK の埋め込み／参加の動作をユーザーが求めている場合は、SDK の経路を使用してください。
  • プロンプトに meeting と custom UI/video/layout/embed の両方が含まれる場合は、zoom-meeting-sdk-web-component-view を優先してください。
  • zoom-video-sdk を使用するのは、ユーザーが Zoom ミーティングではなくカスタムセッション製品を構築している場合に限ります。
  • ユーザーが明示的に混合アーキテクチャを求めている場合を除き、リソース管理、レポート作成、リンク配布には REST の経路のみを使用してください。
  • 実行可能な分類／チェーン処理ロジックとエラー処理については、references/routing-implementation.md を参照してください。
API と MCP のルーティングマトリクス（厳守）
ユーザーの意図正しい経路理由
決定論的なバックエンド自動化、アカウント／ユーザー設定、レポート作成、スケジュール済みジョブzoom-rest-api明示的なリクエスト／レスポンス制御と再現可能な動作
AI エージェントによる動的なツール選択、クロスプラットフォームの AI ツール相互運用性zoom-mcpMCP は動的なツール検出とエージェント型ワークフローに最適化されています
エンタープライズ AI アーキテクチャ（安定したコア＋適応型 AI レイヤー）zoom-rest-api + zoom-mcpAPI はコアシステムのアクションを実行し、MCP は厳選された AI ツール／コンテキストを公開します

ルーティングのガードレール：

  • 決定論的なバックエンド API を MCP のみのルーティングに置き換えないでください。
  • タスクが AI エージェントによるツールオーケストレーションの場合に、REST を最優先するルーティングを強制しないでください。
  • 安定した自動化と AI 主導のインタラクションの両方が必要な場合は、ハイブリッドルーティングを優先してください。
  • MCP リモートサーバーは Streamable HTTP/SSE 経由で動作します。対象のクライアント／エージェントが MCP トランスポート（Claude や VS Code など）をサポートしている場合は、この経路を使用してください。
  • テナントごとのカスタム MCP エンドポイントのプロビジョニングを設計しないでください。Zoom MCP エンドポイントはインスタンス／クラスター単位で共有されます。
  • 出典：https://developers.zoom.us/docs/mcp/library/resources/apis-vs-mcp/
曖昧さの解消（ルーティング前に確認）

プロンプトが API と MCP の両方の経路に同程度の確度で該当する場合、実行前に短い確認質問をしてください。

  • 決定論的な REST API 自動化、AI エージェント向けの MCP ツール、またはその両方のハイブリッドのどれを希望しますか？

次のようにルーティングします：

  • REST の回答 → zoom-rest-api
  • MCP の回答 → zoom-mcp
  • ハイブリッドの回答 → zoom-rest-api + zoom-mcp
MCP の利用可否とトポロジーに関する注意事項
  • Zoom ホスト型 MCP の利用方法は変化しており、Zoom が製品ごとにスコープされた MCP サーバー（Meetings、Team Chat、Whiteboard など）を公開するモデルがドキュメントに示されています。
  • 親となる MCP エントリーポイントとして zoom-mcp を使用してください。
  • Whiteboard 固有の MCP リクエストは、zoom-mcp/whiteboard にルーティングしてください。
  • リクエストが製品固有で、MCP による対応範囲が存在する場合は、まず該当する MCP 製品のインターフェースにルーティングしてください。それ以外の場合は、決定論的な実装に REST／SDK スキルを使用してください。
Webhook と WebSocket

どちらもイベント通知を受信しますが、方式が異なります。

項目webhookszoom-websockets
接続エンドポイントへの HTTP POST永続的な WebSocket 接続
遅延高い低い
セキュリティ公開エンドポイントが必要エンドポイントを公開しない
セットアップより簡単より複雑
最適な用途ほとんどのユースケースリアルタイム性が高く、セキュリティが重要な用途

一般的なユースケース

ユースケース説明必要なスキル
ミーティング + Webhook + OAuth トークンの更新1 つの設計でミーティングを作成し、リアルタイムの更新を処理して、OAuth トークンを安全に更新しますzoom-rest-api + zoom-oauth + zoom-webhooks
Scribe の文字起こしパイプラインAI Services Scribe を使用して、高速モードまたはバッチジョブでアップロードされたファイルや S3 アーカイブを文字起こししますscribe + 任意で zoom-rest-api + 任意で zoom-webhooks
API と MCP のルーティング決定論的な Zoom API、AI 駆動の MCP、またはハイブリッド設計のいずれにルーティングするかを判断しますzoom-rest-api および／または zoom-mcp
カスタムミーティング UI（Web）Meeting SDK Component View を使って、Web アプリで実際の Zoom ミーティング用カスタムビデオ UI を構築しますzoom-meeting-sdk-web-component-view + zoom-oauth
ミーティングの自動化ミーティングをプログラムでスケジュール、更新、削除しますzoom-rest-api
ミーティングボットAI／文字起こし／録画のためにミーティングに参加するボットを構築しますmeeting-sdk/linux + zoom-rest-api + 任意で zoom-webhooks
大規模ミーティングプラットフォーム再試行、キュー、照合を備えた、分散型のミーティング作成とイベント処理を設計しますzoom-rest-api + zoom-webhooks + zoom-oauth
録画と文字起こし録画をダウンロードし、文字起こしを取得しますzoom-webhooks + zoom-rest-api
録画ダウンロードパイプライン録画を独自のストレージ（S3、GCS など）に自動ダウンロードしますzoom-webhooks + zoom-rest-api
リアルタイムメディアストリームWebSocket 経由でライブ音声、ビデオ、文字起こしにアクセスしますzoom-rtms + zoom-webhooks
ミーティング内アプリZoom ミーティング内で動作するアプリを構築しますzoom-apps-sdk + zoom-oauth
React Native ミーティングの埋め込みiOS／Android の React Native アプリにミーティングを埋め込みますzoom-meeting-sdk-react-native + zoom-oauth
ネイティブ Meeting SDK のマルチプラットフォーム展開Android、iOS、macOS、Unreal の Meeting SDK 実装を、共通の認証／バージョン戦略に沿って統一しますzoom-meeting-sdk + プラットフォームスキル
ネイティブ Video SDK のマルチプラットフォーム展開Android、iOS、macOS、Unity の Video SDK 実装を、共通の認証／バージョン戦略に沿って統一しますzoom-video-sdk + プラットフォームスキル
Electron へのミーティングの埋め込みデスクトップの Electron アプリにミーティングを埋め込みますzoom-meeting-sdk-electron + zoom-oauth
Flutter ビデオセッションFlutter でカスタムのモバイルビデオセッションを構築しますzoom-video-sdk-flutter + zoom-oauth
React Native ビデオセッションReact Native でカスタムのモバイルビデオセッションを構築しますzoom-video-sdk-react-native + zoom-oauth
イマーシブエクスペリエンスLayers API を使用したカスタムビデオレイアウトzoom-apps-sdk
コラボレーションアプリミーティングでリアルタイムに共有される状態zoom-apps-sdk
Contact Center アプリのライフサイクルとコンテキスト切り替えエンゲージメントイベントと複数エンゲージメントの状態を処理する Contact Center アプリを構築しますcontact-center + zoom-apps-sdk
Virtual Agent キャンペーンの Web／モバイルラッパーキャンペーン主導のボットフローを、Web とネイティブモバイルのラッパーで提供しますvirtual-agent + contact-center
Virtual Agent ナレッジベース同期パイプラインWeb 同期またはカスタム API コネクターを使用して、外部のナレッジコンテンツを Zoom Virtual Agent に同期しますvirtual-agent + zoom-rest-api + zoom-oauth
Zoom Phone Smart Embed CRM 統合Smart Embed と Phone API を使用して、CRM のダイヤラーと通話ログのフローを構築しますphone + zoom-oauth + zoom-webhooks
Rivet イベント駆動型 API オーケストレーターRivet モジュールクライアントを通じて Webhook と API アクションを組み合わせる Node.js バックエンドを構築しますrivet-sdk + zoom-oauth + zoom-rest-api
Probe SDK の事前チェック準備ゲートMeeting SDK または Video SDK で参加する前に、ブラウザー／デバイス／ネットワークの診断と準備状況ポリシーを追加しますprobe-sdk + zoom-meeting-sdk または zoom-video-sdk

Complete Use-Case Index

前提条件

  1. Zoom アカウント（Pro、Business、または Enterprise）
  2. Zoom App Marketplace で作成したアプリ
  3. OAuth 認証情報（Client ID と Secret）

参考資料

クイックスタート

  1. marketplace.zoom.us にアクセスします
  2. 開発 → アプリを作成 をクリックします
  3. アプリの種類を選択します（references/app-types.md を参照）
  4. OAuth とスコープを設定します
  5. 認証情報をアプリケーションにコピーします

詳細な参考資料

SDK のメンテナンス

リソース

環境変数

運用

  • RUNBOOK.md - 5 分で完了する事前確認とデバッグのチェックリスト。

コメント

Markdown 対応