Saltar para o conteúdo principal

Ainda tem dúvidas sobre o que a Badgie faz pelo seu clube? Vemo-nos numa demo.

Badgie

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

Servidor MCP do Badgie: ligue o Claude, o ChatGPT ou o OpenClaw ao seu clube

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
  1. Onde está
  2. Passo a passo: ligar o seu assistente
  3. O que cada papel pode fazer
  4. Como se aprovam as alterações
  5. Segurança e privacidade
  6. Perguntas frequentes

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.
Secção Como funciona da página pública do Badgie MCP
badgie.com/mcp → «Como funciona»: autoriza com a sua conta, o Badgie reconhece o seu papel e trabalha por chat.

Passo a passo: ligar o seu assistente

  1. Copie o URL do servidor: https://www.badgie.com/api/mcp/mcp.
  2. 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"}}}.
  1. O assistente abre o início de sessão do Badgie. Entre com a conta que usa no Badgie.
  2. 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).
  3. Pergunte primeiro «quem sou no Badgie?»: o assistente chama whoami e mostra o seu papel, a sua escola e que as escritas exigem a sua aprovação.
  4. A partir daí, peça o que precisar em linguagem natural.
Separador Claude da secção Ligar do Badgie MCP com o URL do servidor e o comando do Claude Code
«Um servidor. Três minutos.»: URL do servidor e passos para o Claude e o Claude Code.
Separador ChatGPT da secção Ligar do Badgie MCP
Separador ChatGPT: Definições → Apps e conectores → Modo de programador → Adicionar conector.
Separador OpenClaw da secção Ligar do Badgie MCP com a configuração JSON
Separador OpenClaw: o bloco de configuração para OpenClaw, Cursor e outros clientes MCP.

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.