MoveMentors expõe um servidor Model Context Protocol (MCP). Se usa Claude, ChatGPT (com integrações Claude API), Cursor ou qualquer outro assistente IA compatível com MCP, pode conectar à sua conta pra pedir coisas como:
- "Quais minhas reservas semana que vem?"
- "Cancele minha aula de sábado e envie email a todos."
- "Adicione yoga terça de manhã com mesmo preço da quinta."
- "Envie agradecimento aos clientes que vieram nos últimos 30 dias."
Servidor MCP disponível em contas Pro e Premium.
O que é MCP
Model Context Protocol é padrão aberto pra deixar assistentes IA falarem com ferramentas externas. Originalmente construído pela Anthropic (gente do Claude); agora adotado por ChatGPT, Cursor e outros.
Pra MoveMentors, MCP significa que seu assistente IA pode:
- Ver suas reservas, aulas, clientes (leitura).
- Criar reservas, modificar aulas, enviar mensagens (escrita).
- Tudo gateado por permissões OAuth que você concede.
Como funciona
- Vai nos settings do seu assistente IA (Claude Desktop, ChatGPT, etc) e adiciona MoveMentors como servidor MCP.
- O assistente abre OAuth flow no browser.
- Você loga no MoveMentors e concede permissões (read bookings, write classes, etc).
- O assistente recebe token que inclui em cada request.
- Já pode pedir coisas ao assistente sobre sua conta.
Sem API keys, sem credenciais em texto plano. OAuth cuida da auth.
Conectar Claude Desktop
Abra Claude Desktop
O app de desktop.
Vai em Settings → Developer
Busque seção "MCP servers".
Adicione novo servidor MCP
Clique "Add server" e escolha "Connect via OAuth".
Informe a URL MCP
https://movementors.com/api/mcpAutorize
Claude abre browser. Loga no MoveMentors e vê tela de consent com permissões pedidas.
Escolha quais permissões conceder
Pode negar scopes específicos se quiser limitar. Por exemplo, conceder "read bookings" mas negar "write classes" se só quer consulta.
Clique 'Approve'
Volta ao Claude. Servidor conectado.
Comece a usar
Fale com Claude normal. Agora tem ferramentas pra sua conta MoveMentors.
Conectar ChatGPT
ChatGPT suporta MCP via Anthropic API com Claude como modelo. UI diferente mas OAuth flow é o mesmo.
Se seu assistente suporta MCP, terá opção análoga "Add MCP server". URL sempre é https://movementors.com/api/mcp.
Ferramentas disponíveis
Servidor MCP expõe umas 20 ferramentas. Algumas:
whoami: quem é o user atual.search_mentors,search_studios,search_classes: query do diretório público.get_mentor: perfil completo de um mentor.list_my_bookings: suas reservas (como estudante ou anfitrião).book_class: criar reserva.cancel_booking: cancelar reserva.list_my_classes: suas aulas.update_class,delete_class: modificar aulas.add_class_schedule: adicionar sessão a aula existente.list_class_bookings: quem reservou numa sessão.financials_summary: resumo de ganhos.list_expenses,create_expense,update_expense,delete_expense: despesas.send_mentor_inquiry: enviar mensagem direta.list_received_mentor_inquiries: mensagens recebidas.
O assistente escolhe a ferramenta. Não precisa saber nomes.
Permissões e scopes
Permissões granulares. Concede ou nega cada scope individualmente. Ver scopes OAuth pra lista completa.
Bundles comuns:
- Read-only: ver tudo, mudar nada. Útil pra testar.
- Bookings management: ver e modificar reservas, mas não aulas.
- Full control: tudo.
Pode revogar a qualquer momento em /settings/connected-apps.
Casos de uso
"Mostre minha próxima semana"
Usa list_my_bookings e list_my_classes pra uma semana de eventos por dia. Segue com "quais estão pendentes de pagamento?".
"Cancele sábado e reembolse todos"
Usa list_class_bookings pras reservas afetadas, depois cancel_booking em cada. Refunds Stripe processam auto.
"Adicione aula similar à de terça mas quinta"
Usa get_class pra detalhes, depois create_class com mesmos campos mas agenda diferente.
"Qual foi meu melhor mês em receita?"
Usa financials_summary pra totais mês a mês e reporta.
"Envie agradecimento a todos que vieram fim de semana passado"
Usa list_my_bookings filtrado a último fim de semana com status COMPLETED, depois send_mentor_inquiry ou similar pra notas personalizadas.
Segurança
A saber:
Scopes OAuth são o limite
O assistente não faz nada fora dos scopes concedidos. Se só deu read, writes retornam permission errors.
Cada request é loggado
Loggamos cada request MCP: qual ferramenta, quais argumentos, resultado. Visível em /settings/audit-log. Útil pra saber o que o assistente fez.
Tokens podem ser revogados
/settings/connected-apps mostra cada cliente OAuth conectado. Revogue quando quiser; assistente perde acesso imediato.
Rate limits
Rate-limit por token. Assistente conversacional normal fica bem abaixo. Um tentando puxar todo histórico de reservas de uma vez pode tocar limites; retenta com backoff.
Sandboxing
Maioria dos clientes MCP (Claude Desktop, etc) rodam como processos separados. Não leem seus outros arquivos nem sequestram seu browser. Conexão HTTPS com token auth.
Limites
Algumas ferramentas são gateadas:
book_class: requer Pro. Free expõe só read.update_class,delete_class,add_class_schedule: Pro.financials_summarye ferramentas de despesa: Pro.
Se está no free e tenta usar ferramenta gateada, recebe erro claro do assistente.
Perguntas comuns
Assistente compartilha minha data com outros? Assistente roda local (Claude Desktop) ou no ambiente do provider (Claude.ai web). Data que lê de MoveMentors fica na sua conversa; não compartilhada com outros users.
Privacy policy da Anthropic aplica ao que fazem com sua data de conversa. Não controlamos.
Assistente vê minha senha? Não. OAuth significa que nunca vê senha. Tem token revogável.
Assistente pode fazer coisas pelas minhas costas? Só age quando você fala (na conversa). Não roda em background salvo se você configurar automação. Cada ação loggada.
E se o assistente errar? Pode revisar audit log e desfazer maioria:
- Reservas canceladas podem re-reservar (se sobram assentos).
- Aulas deletadas podem re-criar (assistente tem a data).
- Mensagens enviadas não desenviam.
Trate como funcionário júnior com acesso. Confie mas verifique.
MCP melhora com o tempo? Sim. Adicionamos ferramentas conforme MCP evolui. Inscreva no newsletter ou veja changelog.
Próximos passos
- Scopes OAuth: modelo de permissões.
- Teste: conecte Claude Desktop e pergunte "mostre minha próxima semana".