Zoom MCP

Guide pour le connecteur Zoom MCP groupé dans ce plugin Claude. Préférez design-mcp-workflow ou setup-zoom-mcp d'abord, puis routez ici pour les détails de surface d'outils, les attentes d'authentification, et les contraintes spécifiques à MCP.

Serveur Zoom MCP

Ce plugin groupe le serveur MCP hébergé par Zoom à mcp-us.zoom.us pour l'accès des agents IA à :

• recherche sémantique de réunion
• récupération d'actifs liés aux réunions
• récupération de ressources d'enregistrement

Les Zoom Docs sont exposés via un serveur groupé séparé :

• zoom-docs-mcp à mcp.zoom.us
• conçu spécifiquement pour la création et la récupération de Zoom Docs

Noms d'outils actuels du serveur Zoom MCP principal :

• get_meeting_assets
• search_meetings
• get_recording_resource
• recordings_list

Certains clients MCP organisent les outils du serveur dans l'interface utilisateur, par exemple zoom-mcp:recordings_list. Traitez les noms d'outils bruts ci-dessus comme faisant autorité.

Le travail MCP spécifique à Zoom Docs doit utiliser le serveur dédié zoom-docs-mcp.

Le travail spécifique au Whiteboard est couvert par la compétence dédiée whiteboard/SKILL.md.

Démarrage rapide

1. Exportez le token attendu par le connecteur groupé :

export ZOOM_MCP_ACCESS_TOKEN="your_zoom_user_oauth_access_token"

2. Activez ou redémarrez le plugin pour que Claude redémarre la définition du serveur MCP groupé.

3. Vérifiez la découverte :

• Confirmez que le client peut voir recordings_list, search_meetings, get_meeting_assets, et get_recording_resource.
• Si le client expose l'inspection du protocole brut, tools/list est la source de découverte faisant autorité.
• Le catalogue actuel est documenté dans references/tools.md.

4. Exécutez le premier appel utile :

recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
  page_size: 10

Notes critiques

1. OAuth utilisateur est le chemin d'exécution documenté

Utilisez une application générale avec OAuth au niveau utilisateur comme chemin d'exécution pour l'utilisation d'outils Zoom MCP dans ce plugin. Ne vous appuyez pas sur OAuth Server-to-Server comme modèle d'authentification MCP pris en charge ici.

2. Zoom MCP utilise des scopes granulaires spécifiques à MCP

L'ensemble des scopes Zoom MCP n'est pas identique aux anciens scopes REST larges. Les scopes clés pour le serveur Zoom MCP principal sont :

• ai_companion:read:search — Rechercher dans Zoom Meeting, Zoom Chat et Zoom Doc, en retournant les résultats les plus pertinents en fonction de la requête
• meeting:read:search — Rechercher et afficher les réunions
• meeting:read:assets — Afficher les actifs d'une réunion
• cloud_recording:read:list_user_recordings — Lister tous les enregistrements cloud pour un utilisateur.
• cloud_recording:read:content — Lire le contenu d'enregistrement
• docs:write:import — Créer un nouveau fichier par import
• docs:read:export — Lire le contenu du fichier au format Markdown

Pour Zoom Docs MCP spécifiquement, la page de documentation officielle montre ces scopes granulaires pour les outils documentés :

• docs:write:import — Créer un nouveau fichier par import
• docs:read:export — Lire le contenu du fichier au format Markdown

3. Les fonctionnalités AI Companion sont des prérequis de fonctionnalité, pas des substituts de scope

La recherche sémantique de réunion, les actifs de réunion, et la récupération de contenu d'enregistrement dépendent des fonctionnalités du compte telles que Smart Recording et Meeting Summary pour des résultats utiles. Ces paramètres de fonctionnalité ne remplacent pas les scopes OAuth requis.

4. Whiteboard est une surface MCP séparée

Le endpoint Zoom MCP et le endpoint Whiteboard MCP sont séparés. Routez les demandes spécifiques à Whiteboard vers whiteboard/SKILL.md.

5. Utilisez REST pour les opérations CRUD de réunion déterministes

La surface d'outils Zoom MCP actuelle n'expose pas d'outils déterministes de création, mise à jour ou suppression de réunion. Si l'utilisateur a besoin d'opérations CRUD de réunion explicites, routez vers ../rest-api/SKILL.md.

Endpoints du serveur

Serveur Docs MCP dédié :

Compétence Whiteboard MCP dédiée :

• whiteboard/SKILL.md

Modèle de recherche et récupération

search_meetings utilise la récupération AI Companion plutôt qu'un simple filtre de métadonnées. Dans ce contexte, utilisez le serveur MCP live comme faisant autorité pour le schéma de réponse et le comportement du scope.

Deux familles de résultats sont les plus importantes :

• Résultats orientés Recap : résumé IA, documents liés aux réunions, enregistrements et actifs connexes
• Résultats orientés Recording : références d'enregistrement cloud et ressources compatibles transcription

Utilisez examples/transcript-retrieval.md pour le workflow de récupération principal.

Catalogue d'outils

* Paramètre requis

Guide complet des paramètres et sorties : references/tools.md

Workflows clés

Rechercher du contenu de réunion, puis récupérer les actifs :

search_meetings
  q: "Q4 planning discussion"
  from: "2026-03-01"
  to: "2026-03-06"
→ choisir une réunion retournée
→ get_meeting_assets  meetingId: "MEETING_ID_OR_UUID"

Lister les enregistrements, puis récupérer les ressources d'enregistrement :

recordings_list
  userId: "me"
  from: "2026-03-01"
  to: "2026-03-06"
→ choisir une cible d'enregistrement
→ get_recording_resource  meetingId: "MEETING_UUID_OR_RECORDING_ID"

Créer ou récupérer un Zoom Doc :

• utilisez le serveur dédié zoom-docs-mcp plutôt que le serveur principal zoom-mcp
• les outils documentés officiels sur la page Zoom Docs MCP sont :
  • create_file_with_content
  • get_file_content

Référence d'erreurs

Référence d'erreurs complète : references/error-codes.md

Documentation

Concepts

• concepts/mcp-architecture.md — Protocole MCP, endpoints hébergés, découverte, et modèle de capacité
• concepts/oauth-setup.md — Création d'app OAuth, scopes spécifiques à MCP, prérequis AI Companion, cycle de vie du token

Exemples

• examples/transcript-retrieval.md — Workflows recherche/actifs et ressource d'enregistrement
• examples/create-zoom-doc.md — Flux de création Zoom Docs vérifié
• examples/search-and-act.md — Rechercher, inspecter les actifs, et confier le travail CRUD à REST si nécessaire
• examples/meeting-lifecycle.md — Pourquoi les CRUD de réunion appartiennent à REST, plus le pattern de handoff MCP-to-REST

Références

• references/tools.md — Référence actuelle des outils Zoom MCP
• references/error-codes.md — Erreurs MCP et Zoom API avec corrections
• whiteboard/SKILL.md — Compétence Whiteboard MCP dédiée

Dépannage

• troubleshooting/common-errors.md — Défaillances de scope, mélanges de endpoints, problèmes de recherche/enregistrement

Opérations

• RUNBOOK.md — Checklist de préflight et débogage en 5 minutes

Compétences connexes

• zoom-rest-api — Accès déterministe à l'API REST, incluant les CRUD de réunion
• zoom-oauth — Patterns d'implémentation OAuth
• zoom-webhooks — Workflows d'enregistrement et réunion pilotés par événements
• zoom-rtms — Flux de média live et transcription pendant les réunions actives