Servidor MCP do Badgie: ligue o Claude, o ChatGPT ou o OpenClaw ao seu clube
Como ligar um assistente de IA compatível com MCP (Claude, ChatGPT, OpenClaw, Cursor) ao Badgie: URL do servidor, passos por cliente, autorização OAuth 2.1, o que cada papel pode fazer e como se aprovam as alterações.
6 min de leituraIntermediárioAtualizado em 2 de outubro de 2026
Resposta rápida
O servidor MCP do Badgie é o conector oficial para que um assistente de IA compatível com MCP (Claude, ChatGPT, OpenClaw, Cursor e outros) gira o seu clube por chat. Adiciona o URL https://www.badgie.com/api/mcp/mcp ao seu assistente, inicia sessão com a sua conta Badgie, aprova o acesso (OAuth 2.1) e o assistente trabalha com o seu papel: escola, professor ou aluno e família. Nunca vê dados de outra escola.
Neste guia
Onde está
- Página pública com as instruções: badgie.com/mcp (secção «Conectar»), com a política de privacidade do Badgie MCP no fim. Por agora a página só existe em espanhol.
- URL do servidor:
https://www.badgie.com/api/mcp/mcp(transporte HTTP em streaming). - As propostas do seu assistente aprovam-se no painel: Super Coach → Control → Pendientes.
Passo a passo: ligar o seu assistente
- Copie o URL do servidor:
https://www.badgie.com/api/mcp/mcp. - Adicione-o ao seu assistente:
- Claude (claude.ai): Definições → Conectores → Adicionar conector personalizado, e cole o URL.
- Claude Code: no terminal,
claude mcp add --transport http badgie https://www.badgie.com/api/mcp/mcp. - ChatGPT (planos pagos): Definições → Apps e conectores → Modo de programador → Adicionar conector, e cole o URL.
- OpenClaw, Cursor e outros clientes MCP: adicione à configuração
{"mcpServers": {"badgie": {"url": "https://www.badgie.com/api/mcp/mcp", "transport": "http"}}}.
- O assistente abre o início de sessão do Badgie. Entre com a conta que usa no Badgie.
- No ecrã de consentimento vê que aplicação pede acesso, com que papel vai entrar (conta de escola, professor/a ou aluno/a · família) e o que poderá fazer. Clique em Aprobar (aprovar; por agora este ecrã está em espanhol).
- Pergunte primeiro «quem sou no Badgie?»: o assistente chama
whoamie mostra o seu papel, a sua escola e que as escritas exigem a sua aprovação. - A partir daí, peça o que precisar em linguagem natural.
O que cada papel pode fazer
- Conta de escola (diretor): consultar qualquer dado do clube (dívidas, assiduidade, risco de abandono, MRR, ocupação de reservas), ler os guias desta wiki, gerir a memória do clube, o plano de marketing, o Content Studio e o Playbook (regras, voz, modelos) e propor qualquer ação de um catálogo com mais de 200 ações de escrita (
list_action_catalog,propose_action,list_my_proposals). - Professor: as suas aulas de hoje e da semana, os seus alunos e o seu progresso, fazer a chamada, atribuir insígnias, deixar notas de treino e relatórios pendentes.
- Aluno e família: perfil, insígnias, horário, assiduidade, relatórios, pagamentos e torneios, voltas e estatísticas de golfe, marcas em exercícios e check-in de nutrição.
No total, mais de 120 ferramentas MCP.
Como se aprovam as alterações
As ações de escrita do diretor seguem a mesma Delegação que o agente da web:
- Área em Auto: a ação é executada de imediato e o assistente dá-lhe o resultado.
- Área em Sugerir: fica como proposta em Pendientes, onde a aprova ou rejeita.
- Área em Off: é bloqueada.
Segurança e privacidade
- OAuth 2.1: inicia sessão no Badgie e aprova o acesso; o assistente nunca vê a sua palavra-passe.
- Cada ligação fica limitada à sua conta e ao seu papel. Nunca chega a dados de outra escola nem de outro aluno.
- A política de privacidade do Badgie MCP está em badgie.com/mcp/privacy.
Perguntas frequentes
O Badgie tem uma API REST pública ou webhooks?
Não. O Badgie não oferece uma API REST pública com chaves nem webhooks de saída. O caminho para programadores e integrações é este servidor MCP e a Badgie CLI.
Com que assistentes funciona?
Com qualquer cliente compatível com MCP: Claude (claude.ai e Claude Code), ChatGPT, OpenClaw, Cursor e outros.
Que diferença há em relação ao agente dentro do Badgie?
O Badgie Agêntico vive dentro da web e da app, com a sua equipa de especialistas e créditos. O servidor MCP deixa o seu próprio assistente usar o Badgie com as suas permissões e a mesma delegação.
Aparece «Cuenta sin perfil Badgie»?
Entrou com um e-mail que não está ligado a nenhuma escola, professor ou aluno. Volte a ligar e entre com a conta que usa no Badgie.
O pedido expirou?
A autorização tem de começar no seu assistente. Se o pedido de autorização não existir ou tiver expirado, volte a iniciar a ligação a partir dele.