A Weve expõe um servidor MCP (Model Context Protocol) que permite conectar agentes de IA externos — Claude (Desktop e Code), ChatGPT Desktop, Gemini, agentes do n8n, scripts próprios — diretamente ao seu clube. Com isso, a IA pode ler dados, criar conteúdo, gerenciar membros e automatizar fluxos falando com a Weve em linguagem natural.
Você pode conectar via OAuth (recomendado, sem token estático) ou via chave de API em clientes que ainda não suportam OAuth.
O que é MCP
MCP é um protocolo aberto criado pela Anthropic e hoje adotado por OpenAI, Google e dezenas de outros players. Padroniza como agentes de IA conversam com sistemas externos. Funciona como um padrão universal pra IAs: em vez de cada plataforma criar uma integração específica pra cada IA, todas usam o mesmo protocolo.
Resultado: uma vez conectado, qualquer cliente MCP-compatível consegue usar todas as ferramentas que a Weve expõe.
Casos de uso
Criar cursos com IA: "Claude, crie um curso completo sobre marketing digital com 10 aulas".
Buscar dados: "quantos membros novos entraram esse mês? Quem são os mais engajados?".
Automações com n8n: integrar a Weve com qualquer sistema (CRM, planilha, BI) via fluxos visuais.
Gerenciar via chat: em vez de clicar 10 vezes no admin, fala com a IA: "convide essas 50 pessoas pro programa Premium".
Análises sob demanda: "qual aula tem mais dropout? Faça um relatório".
Workflows próprios: integre com seu sistema interno via scripts em qualquer linguagem.
Página de MCP no admin
Acesse Configurações → Integrações → MCP. Lá você encontra tudo num lugar só:
O endpoint MCP do seu clube, pronto pra copiar.
Snippets de configuração pra Claude Desktop, Claude Code, ChatGPT, Gemini, n8n e cURL — cada um com botão "copiar".
Lista completa das ferramentas disponíveis (44 no momento), agrupadas por área, com descrição de cada uma.
Atalho pra criar e gerenciar chaves de API, pra clientes sem OAuth.
Criando uma chave de API
Pra clientes que ainda não suportam OAuth (n8n, scripts próprios, alguns bots):
Acesse Configurações → Integrações → Chaves de API.
Clique em Nova chave de API.
Defina:
Nome: identificador interno (ex.: n8n produção, script de relatório).
Permissões: quais ações a chave pode fazer (veja seção abaixo).
Salve.
A Weve mostra a chave gerada — copie agora e guarde em segurança. Após fechar o modal, ela fica mascarada e você não consegue mais ver o valor completo.
A chave de API equivale a uma senha. Quem tiver ela consegue tudo que a chave permite. Nunca compartilhe em canais públicos, repositórios git ou prints de tela.
Permissões (abilities)
Cada chave tem permissões granulares. Você pode dar uma, várias ou todas:
Read: ler dados do clube (membros, conteúdos, vendas, etc.). Sem ele, nada funciona.
Create: criar coisas novas (membros, conteúdos, automações).
Update: editar registros existentes.
Delete: excluir registros.
Princípio do menor privilégio: dê só o que a integração realmente precisa. Pra um agente que só lê dados pra relatório, dê só a permissão de leitura. Pra criar conteúdo via IA, adicione criação e edição.
Endpoint MCP
O endpoint é único pro seu clube e está visível na página de MCP. Formato:
O endereço termina em /mcp/weve, sob o seu domínio do admin.
Use esse endpoint em qualquer cliente MCP — a página de MCP já entrega os snippets prontos pros principais clientes.
Conectando ao Claude Desktop
Modo 1: OAuth (recomendado)
Sem chave de API. O Claude abre o navegador na primeira chamada e você autoriza diretamente.
Copie o snippet do Claude Desktop na página de MCP.
Cole no arquivo claude_desktop_config.json.
Reinicie o Claude Desktop.
Na primeira vez que tentar usar, ele abre o navegador pra você autorizar.
O snippet usa o wrapper mcp-remote (proxy stdio→HTTP) — o Claude Desktop ainda não fala MCP HTTP diretamente, então essa ponte é necessária. Requer Node.js instalado.
Modo 2: Manual (com chave de API)
Pra clientes que não suportam OAuth, use a chave direto. Adicione um header de autorização do tipo Bearer com sua chave de API no mesmo bloco de configuração.
Conectando ao Claude Code
O Claude Code suporta MCP HTTP nativo — sem wrapper. Pelo terminal:
claude mcp add weve --transport http SEU_ENDPOINT
Na primeira chamada, o navegador abre pra você autorizar via OAuth. Depois disso é só usar.
Conectando ao ChatGPT
O ChatGPT Desktop tem suporte nativo a MCP via Conectores (planos Plus, Pro, Team e Enterprise). Sem chave de API — o ChatGPT cuida do OAuth.
Abra o ChatGPT Desktop.
Configurações → Conectores → Adicionar conector personalizado.
Nome: Weve. URL: seu endpoint MCP. Tipo: MCP Server.
Salve. Na primeira chamada o ChatGPT abre o navegador pra autorização OAuth.
Conectando ao Gemini
Gemini CLI / Code Assist: suporte nativo a MCP HTTP com OAuth. Pelo terminal:
gemini mcp add weve --transport http SEU_ENDPOINT
App web (gemini.google.com): o suporte a MCP HTTP no app web ainda está em rollout gradual e pode não estar disponível no seu tenant. Como fallback, use a ponte mcp-remote em clientes que aceitem configuração via stdio (mesma estratégia do Claude Desktop).
Conectando ao n8n
Adicione um node MCP Client Tool no seu workflow.
URL: seu endpoint MCP.
Authentication: Header Auth.
Header Name: Authorization
Header Value: Bearer + sua chave de API
O node detecta automaticamente todas as ferramentas disponíveis e você pode usá-las nos seus fluxos.
Testando a conexão
Pra validar que tudo está funcionando, faça uma chamada pro endpoint MCP listando as ferramentas. Use cURL, Postman ou qualquer cliente HTTP, com o header Authorization: Bearer SUA_CHAVE e o método tools/list no payload JSON-RPC.
Se voltar uma lista de ferramentas, está tudo certo. O snippet de cURL pronto também está na página de MCP.
O que a IA consegue fazer
O servidor MCP da Weve expõe 44 ferramentas pra clientes externos, organizadas por área:
Conteúdos: criar cursos completos, criar/editar conteúdos, escrever corpos, atualizar repositórios, organizar tópicos e autores.
Coleções e playlists: criar, listar, atualizar.
Membros: listar, buscar, criar, ver NPS, enviar e-mail, gerar link mágico, redefinir senha.
Plataformas de vendas: configurar integrações.
E-mail marketing: criar campanhas, listar, ver estatísticas, listar automações.
Inbox & Moderação: listar inbox, aprovar comentário, responder, responder pergunta.
Analytics: métricas de dashboard, performance de conteúdo, distribuição de engajamento.
Algumas ferramentas — geração de imagem, navegação no admin, escolhas interativas e log de pedidos não suportados — só fazem sentido dentro do chat interno da Weve (dependem da UI ou da sessão do admin logado) e por isso não aparecem em clientes externos.
A lista completa e atualizada, com descrição de cada ferramenta, está sempre visível na página de MCP.
Boas práticas
Uma chave por integração. Não use a mesma chave pro Claude e pro n8n — fica difícil rastrear quem fez o quê.
Nomes descritivos. "n8n produção - Daniel" é melhor que "Chave 1".
Permissão mínima. Comece só com leitura e adicione mais conforme necessidade.
Revogue quando trocar de máquina. Se gerar uma chave no PC do escritório e depois trocar, revogue a antiga.
Monitore o "última utilização". Chaves não usadas há meses podem ser excluídas — limpa o ambiente.
Use OAuth quando puder. É mais seguro que chaves estáticas (rotação automática, expiração, sem token armazenado em config).
Segurança
Algumas garantias do sistema:
Cada chave fica vinculada à sua organização — não acessa dados de outras orgs, mesmo se vazar.
Permissões são respeitadas em todas as chamadas — chave sem permissão de exclusão não consegue deletar, mesmo via cURL direto.
Toda ação fica registrada com timestamp e identifica qual chave foi usada.
Você pode revogar uma chave a qualquer momento — efeito imediato.
Perguntas frequentes
Posso ter quantas chaves?
Quantas quiser. Sem limite imposto.
Como vejo a chave depois de criada?
Não dá. Por segurança, a chave é mostrada uma única vez. Se perdeu, gere uma nova e atualize os clientes.
A chave expira?
Hoje as chaves não têm expiração automática. Pra rotação, gere nova e revogue a antiga manualmente.
Posso restringir uma chave a IPs específicos?
Hoje não há restrição por IP. A segurança é via permissões e proteção da chave em si.
O que é melhor: OAuth ou chave manual?
OAuth é mais seguro (não tem token estático armazenado em config). Use sempre que o cliente suportar — Claude (Desktop e Code), ChatGPT Desktop, Gemini CLI.
Posso integrar com ChatGPT?
Sim. O ChatGPT Desktop tem suporte nativo a MCP via Conectores (Plus, Pro, Team e Enterprise) — veja a seção dedicada acima. Também funciona via a Responses API (uso programático).
Posso integrar com Gemini?
Sim, via Gemini CLI / Code Assist (nativo) e via Gemini API (function calling MCP-compatível). No app web do Gemini o suporte ainda está em rollout gradual; use a ponte mcp-remote como fallback enquanto isso.
O n8n da Weve usa essa mesma API?
Sim. Internamente, é o mesmo servidor MCP. A diferença é que no n8n você monta workflows visuais; com Claude/ChatGPT/Gemini, você conversa em linguagem natural.
Como sei o que cada ferramenta faz?
A lista completa fica na página de MCP no admin (Configurações → Integrações → MCP), com descrição de cada uma. Você também pode listar via cliente MCP, ou simplesmente perguntar pro próprio agente conectado: "que ferramentas da Weve você tem disponíveis?".
Tem rate limit?
Sim, há limites pra evitar abuso. Pra uso normal, você não bate. Se sua integração faz muitas chamadas seguidas, considere espaçar ou cachear no seu lado.
Funciona em tempo real?
Sim. Cada chamada MCP é processada na hora. Não há latência além da latência normal de rede + processamento.