Zoom MCP — Expert Integrado

Open source, criado por Eric Luciano na Mentoria Automações Inteligentes (Expert Integrado).

O servidor se identifica no handshake MCP com uma linha de procedência; para desativar (ex.: white-label), defina EXPERT_NO_PROVENANCE=1 no ambiente.

→ Como funciona o Zoom MCP — a página do projeto, com o sistema explicado visualmente.

Conecta o seu Zoom Team Chat ao Claude Code. Depois de instalar, você pede coisas como "envia uma mensagem no canal #geral", "lista os meus canais do Zoom", "quem são os membros do canal X?" — e ele faz, direto no seu Zoom.

A instalação é guiada pelo próprio Claude Code. Você só cola um prompt e ele cuida do resto — inclusive criando o app no Zoom Marketplace por você, pelo navegador. Não precisa editar arquivo, não precisa mexer em JSON.

Passo 1 — Instale o que precisa

Baixe e instale (uma vez só, na sua máquina):

• Node.js 18 ou superior — baixe e clique "Avançar" até o fim. Reinicie o computador depois.
• Claude Code — o aplicativo oficial da Anthropic.

Passo 2 — Peça pro Claude Code instalar

Abra o Claude Code e cole o prompt abaixo no chat (use o botão de copiar no canto do bloco):

Você é o instalador do Zoom MCP da Expert Integrado (servidor MCP que conecta
o Zoom Team Chat ao Claude Code). Conduza a instalação completa comigo, nesta
ordem, sem pular etapas:

1. PRÉ-REQUISITOS — verifique e me mostre o resultado:
   - node --version   (precisa ser 18 ou superior; se faltar, me oriente a
     instalar de https://nodejs.org e reiniciar o computador antes de seguir)
   - claude mcp list  (confirma que o Claude Code está ok; se o MCP "zoom" já
     existir, pergunte se eu quero reconfigurar antes de mexer)

2. CRIAR O APP NO ZOOM MARKETPLACE — siga o guia oficial do projeto:
   https://github.com/Expert-Integrado/zoom-mcp/blob/main/docs/ZOOM_APP_SETUP.md

   As etapas de navegador são: criar o app tipo "General App" (modo
   User-managed) em https://marketplace.zoom.us/develop/create, configurar o
   OAuth Redirect URL http://localhost:4488/callback (e a Allow List, se
   houver), adicionar os escopos de Team Chat listados no guia, conferir a
   ativação e copiar o Client ID e o Client Secret da tela App Credentials.

   Para CADA etapa de navegador acima, me pergunte com AskUserQuestion:
   "Essa etapa é no navegador. Quer que eu faça pra você?", com as opções:

   a) "Sim, pode fazer" (rota padrão) — use o Playwright MCP. Se ele não
      estiver instalado, instale primeiro com:
      claude mcp add playwright -- npx -y @playwright/mcp@latest
      Abra a página, espere EU fazer o login sozinho na janela do navegador
      (NUNCA peça senha nem código de verificação no chat) e execute os
      cliques e preenchimentos, narrando o que está fazendo. Ao final,
      extraia o Client ID e o Client Secret direto da tela.

   b) "Pela extensão Claude in Chrome" — se eu já uso a extensão, mesmo
      protocolo, direto no meu Chrome logado.

   c) "Prefiro fazer manualmente" — me oriente UM passo por vez e aguarde eu
      confirmar cada um. Na tela App Credentials, peça pra eu copiar e colar
      o Client ID e o Client Secret no chat (colar, nunca redigitar).

3. REGISTRAR O MCP no Claude Code com as credenciais obtidas:

   claude mcp add zoom -s user \
     -e ZOOM_CLIENT_ID=<CLIENT_ID> \
     -e ZOOM_CLIENT_SECRET=<CLIENT_SECRET> \
     -- npx -y @expertintegrado/zoom-mcp

   (No Windows, rode em linha única, sem as barras invertidas.)
   REGRA DE SEGREDO: use os valores apenas dentro dos comandos e da
   configuração local — nunca os repita em texto no chat nem os grave em
   arquivo que vá pro git.

4. AUTORIZAR NO ZOOM (OAuth) — detecte meu sistema operacional e rode:

   Linux/Mac:
   ZOOM_CLIENT_ID=<CLIENT_ID> ZOOM_CLIENT_SECRET=<CLIENT_SECRET> npx -y @expertintegrado/zoom-mcp auth

   Windows (PowerShell):
   $env:ZOOM_CLIENT_ID="<CLIENT_ID>"; $env:ZOOM_CLIENT_SECRET="<CLIENT_SECRET>"; npx -y @expertintegrado/zoom-mcp auth

   Windows (CMD):
   set ZOOM_CLIENT_ID=<CLIENT_ID> && set ZOOM_CLIENT_SECRET=<CLIENT_SECRET> && npx -y @expertintegrado/zoom-mcp auth

   O navegador vai abrir a tela de autorização do Zoom — o login é meu,
   aguarde eu autorizar. VALIDAÇÃO REAL: só avance quando o terminal mostrar
   "Tokens salvos com sucesso" — essa mensagem prova que a troca de tokens
   com a API do Zoom funcionou e as credenciais estão válidas. Se falhar,
   diagnostique com a seção "Problemas comuns" do guia antes de seguir.
   Os tokens ficam só num arquivo local (tokens.json).

   Fallback Windows: se o npx não encontrar os tokens depois, use o plano B em
   https://github.com/Expert-Integrado/zoom-mcp/blob/main/docs/TROUBLESHOOTING.md

5. TESTE FINAL (ponta a ponta): me avise pra fechar e reabrir o Claude Code
   (o aplicativo inteiro) pra ativar o MCP. Antes disso, me entregue um
   resumo do que foi configurado: nome do app criado, escopos adicionados,
   onde os tokens estão salvos e 3 exemplos do que posso pedir. Diga que o
   teste de sucesso é pedir, na volta: "Liste meus canais do Zoom". Se esta
   conversa for retomada depois do restart, rode você mesmo zoom_status e
   zoom_list_channels e confirme comigo o resultado.

Cuidado: as credenciais do Zoom dão acesso ao SEU Zoom. Não compartilhe, não poste em grupo. Cada pessoa deve criar o próprio app.

Quando ele pedir, feche e abra o Claude Code (feche o app inteiro, não só a aba).

Passo 3 — Teste

Com o Claude Code reaberto, pergunte:

Liste meus canais do Zoom.

Se ele responder com os canais, tá funcionando. 🎉

Atualizando o MCP

Quando sair versão nova, o npx pega automaticamente na próxima inicialização — não precisa fazer nada. Se quiser forçar agora, peça ao Claude Code:

Limpa o cache do npx do Zoom MCP (roda npm cache clean --force) e me avisa pra reiniciar o Claude Code.

Não funcionou?

Cole isso no Claude Code:

O MCP do Zoom da Expert Integrado não está funcionando. Roda /mcp pra verificar se ele tá listado, confere se o Node.js 18+ está instalado, e me ajuda a diagnosticar. Se precisar, consulta o guia em https://github.com/Expert-Integrado/zoom-mcp/blob/main/docs/TROUBLESHOOTING.md.

Se mesmo assim não rolar, abra uma issue contando o que aconteceu.

O que dá pra fazer

Exemplos depois de instalado:

• "Envia uma mensagem no canal #marketing dizendo que a reunião foi remarcada"
• "Lista todos os canais que faço parte"
• "Quem são os membros do canal #vendas?"
• "Mostra as últimas mensagens do canal #geral"
• "Reage com 👍 na última mensagem do canal #produto"
• "Busca o canal chamado 'projetos'"

Lista completa de comandos: docs/TOOLS.md

Instalação técnica (avançada)

Ver INSTALL.md para modos alternativos: clone local, instalação global com npm -g.

Segurança

• Seus tokens ficam salvos localmente em tokens.json na sua máquina
• Nenhuma credencial é enviada para servidores da Expert Integrado
• O arquivo tokens.json está no .gitignore — nunca é commitado
• Durante a instalação guiada, o Claude usa as credenciais direto nos comandos — elas não devem ser repetidas em texto no chat

Contribuindo

Quer reportar um bug, sugerir uma melhoria ou contribuir com código? Veja CONTRIBUTING.md e, para o procedimento de release, RELEASING.md.

Licença

MIT © Expert Integrado