ANTES DE COMEÇAR
Você vai precisar de uma conta de aluno
MCP é o protocolo que permite ao coding agent conversar com ferramentas e serviços externos. O MCP do Clube permite que seu assistente consulte dados de aprendizagem disponíveis no seu perfil e registre eventos de prática. O acesso exige uma conta de aluno com assinatura ativa do Clube.
Escolha abaixo o coding agent que você usa. Cada configuração cadastra o servidor remoto em https://www.kipperacademy.com.br/api/mcp. A autorização é feita pelo navegador via OAuth: não crie nem cole chaves de API.
CLAUDE CODE
Adicionar para seu usuário
Abra o Terminal e execute o comando. O escopo user deixa o servidor disponível nos seus projetos do Claude Code.
claude mcp add --transport http --scope user "MCP do Clube" https://www.kipperacademy.com.br/api/mcp- Abra o Claude Code e digite
/mcp. - Selecione MCP do Clube e siga a opção de autenticação.
CODEX
Adicionar e iniciar o login
No Terminal, cadastre o endereço remoto e inicie a autorização OAuth:
codex mcp add "MCP do Clube" --url https://www.kipperacademy.com.br/api/mcp
codex mcp login "MCP do Clube"- Conclua a autorização no navegador quando ele abrir.
- Confira o cadastro com
codex mcp list. Dentro do Codex, abra/mcppara ver as conexões.
CURSOR
Configurar para todos os projetos
- Crie ou abra o arquivo global
~/.cursor/mcp.json. Ele mantém o MCP disponível entre projetos. Se preferir limitar a um projeto, use.cursor/mcp.jsonna pasta dele. - Adicione esta configuração e salve o arquivo:
{
"mcpServers": {
"MCP do Clube": {
"url": "https://www.kipperacademy.com.br/api/mcp"
}
}
}- Abra Cursor Settings → Tools & Integrations → MCP.
- Ative MCP do Clube e escolha a opção de conectar/autorizar. Se a entrada não aparecer, reinicie o Cursor.
LOGIN E AUTORIZAÇÃO · OAUTH
Conecte sua conta de aluno
- Depois de iniciar a conexão no seu cliente, aguarde a abertura do navegador.
- Entre na Kipper Academy com o e-mail da conta de aluno que tem acesso ao Clube.
- Confira as permissões apresentadas na tela e selecione Conectar.
- Volte ao coding agent. Ele conclui o vínculo após a autorização.
Não cole senhas, chaves ou tokens no terminal. O login e a autorização acontecem na página da sua conta.
O MCP consulta as informações de aprendizagem disponibilizadas ao assistente e pode registrar eventos de prática. A skill funciona sem essa conexão; conectar o MCP do Clube é opcional para usar o material de estudo.
VERIFICAÇÃO
Confirme que o servidor está conectado
- Na lista de servidores do seu agente, confira que MCP do Clube aparece como conectado.
- Peça à IA: “Use o MCP do Clube para consultar meu perfil de aprendizagem e me ajudar a escolher o próximo conceito para estudar.”
- Se ainda não concluiu a avaliação inicial, algumas informações do seu perfil podem não estar preenchidas.
ACESSO E SUPORTE
Desconectar ou resolver problemas
- Revogar o acesso: na área logada, abra Conexões e selecione Desconectar no assistente.
- O navegador não abriu: repita o login OAuth no seu agente e confira se o navegador permitiu a janela de autorização.
- A conta não foi autorizada: confirme que entrou com o e-mail correto e que o acesso ao Clube está ativo.
- O servidor não aparece: confira o endereço, reinicie o agente e repita a autorização.
DOCUMENTAÇÃO DOS CLIENTES
DÚVIDAS FREQUENTES
Conexão, skill e conta
Preciso instalar a skill para usar o MCP do Clube?
Não. A skill e o MCP são configurações separadas. A skill orienta o formato das sessões de estudo; o MCP conecta o agente ao perfil de aprendizagem. Juntos, eles dão contexto mais completo.
O MCP do Clube está disponível para qualquer conta?
Não. A conexão requer uma conta de aluno com acesso ativo ao Clube. A skill pode ser usada sem conectar o MCP.
Tenho que criar ou colar um token?
Não. A conexão deste guia usa OAuth: o coding agent abre a página de autorização no navegador para você entrar na sua conta.