A Weve expõe um servidor MCP (Model Context Protocol) que permite conectar agentes de IA externos — como Claude Desktop, ChatGPT customizado, 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.
Pra conectar, você precisa de uma chave de API (ou autorizar via OAuth, em clientes que suportam).
O que é MCP
MCP é um protocolo aberto criado pela Anthropic que 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.
Criando uma chave de API
Acesse Configurações → Integrações → Chaves de API.
Clique em Nova chave de API.
Defina:
Nome: identificador interno (ex.: Claude Desktop, n8n produção).
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 mesma tela de chaves de API. Formato:
O endereço termina em /mcp/weve, sob o seu domínio do admin.
Use esse endpoint em qualquer cliente MCP, junto com a chave de API.
Conectando ao Claude Desktop
Modo 1: OAuth (recomendado)
Não precisa de chave de API. O Claude abre o navegador e você autoriza diretamente.
Abra o arquivo de configuração do Claude Desktop.
Adicione um bloco mcpServers com a entrada weve apontando pra URL do endpoint.
Reinicie o Claude Desktop.
Na primeira vez que tentar usar, ele abre o navegador pra você autorizar.
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 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 que a IA consegue fazer
O servidor MCP da Weve expõe dezenas de ferramentas, organizadas por área:
Conteúdos: criar cursos completos, criar/editar conteúdos, escrever corpos, atualizar repositórios, organizar tópicos.
Coleções: criar, listar, atualizar.
Membros: listar, buscar, criar, atualizar, ver NPS.
Plataformas de vendas: configurar integrações.
E-mail marketing: criar campanhas, listar, ver estatísticas.
Mídia: upload de imagens, geração com IA.
Navegação: abrir telas específicas do admin.
Tudo que você consegue fazer no painel admin pode (na maioria dos casos) ser feito via MCP também.
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. "Claude Desktop - 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 você 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).
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, por exemplo).
Posso integrar com ChatGPT customizado?
Sim, qualquer cliente que suporte MCP funciona. ChatGPT já tem suporte experimental — siga a documentação oficial deles.
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, você conversa em linguagem natural.
Como sei o que cada ferramenta faz?
Liste as ferramentas via cliente MCP — cada uma vem com descrição e schema dos parâmetros. Ou pergunte pro próprio Claude depois de conectar: "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.