bbody.

Por que o seu treinador roda em MCP

Publicado em

A lógica de treino não está neste aplicativo. Ela fica atrás dele, em um servidor com que o app conversa — e qualquer outro cliente também pode.

Um plano, vários clientes

O aplicativo web em que você entra é um cliente. O plano, o catálogo de exercícios, o histórico de sessões e as decisões sobre o que vem depois vivem todos em um serviço separado, que fala o Model Context Protocol.

A consequência prática é que o app não é a única porta de entrada. Conecte a mesma conta por um assistente compatível com MCP e você estará lendo e escrevendo no mesmo plano — não em uma cópia, nem em uma exportação. Registre um treino em um lugar e ele está no outro.

Por que isso vale a peça extra

A maioria dos aplicativos de treino guarda a lógica dentro do próprio app, o que significa que só o app pode usá-la. Seu histórico vira algo que você consegue olhar, mas não trabalhar, e levá-lo para outro lugar exige um arquivo de exportação que envelhece no instante em que é gerado.

Colocar a lógica atrás de um protocolo inverte isso. Fazer uma pergunta sobre o seu próprio treino na ferramenta que já está aberta passa a ser uma coisa normal, em vez de um recurso que o app precisa decidir construir.

O que isso não muda

Seus dados ficam em um só lugar e continuam lá. Um segundo cliente é outra porta para a mesma conta, não outra cópia dos seus registros, e cada um se autentica como você antes de poder ler qualquer coisa.

O aplicativo continua funcionando sem conexão nenhuma. O treino do dia é baixado para o dispositivo, as séries são registradas localmente enquanto você treina e os resultados sincronizam quando a conexão volta. Nada no protocolo exige que você esteja online entre terminar uma série e ver o número.

Adicionando ao Claude

Há um único valor de que você precisa, o endereço do servidor: https://api.bbody.app/mcp. Todo o resto é descoberto automaticamente.

  • Abra Configurações → Conectores → Adicionar conector personalizado.
  • Cole https://api.bbody.app/mcp como URL do servidor. No Claude Desktop o caminho é o mesmo.
  • O Claude testa o servidor e oferece uma opção de autenticação. Escolha “Entrar agora”, que já deve aparecer como detectada.
  • Entre com a mesma conta Google que você usa no aplicativo — é isso que liga os dois ao mesmo conjunto de registros.

Adicionando ao ChatGPT

O ChatGPT acessa servidores MCP remotos pelo modo desenvolvedor, então primeiro há uma chave a encontrar. Os rótulos mudam de lugar entre versões, e a disponibilidade depende do plano.

  • Ative Configurações → Segurança e login → Modo desenvolvedor.
  • Abra Plugins, use o botão de mais e adicione uma conexão de modo desenvolvedor.
  • Informe https://api.bbody.app/mcp como URL do servidor MCP. Se pedir transporte, é Streamable HTTP; para autenticação, OAuth.
  • Entre com a mesma conta Google e confira se a conexão lista as ferramentas.

Duas coisas que não se deve colar

Mantenha o /mcp no fim do endereço e não use a URL do próprio aplicativo web — https://bbody.app/ — como servidor. Ela serve páginas, não o protocolo, e um cliente apontado para lá falha de um jeito que parece servidor fora do ar.

Nunca informe um client ID ou client secret do Google em nenhum dos dois clientes. O servidor registra os clientes por conta própria, então o login não precisa de nada além da conta Google. Qualquer coisa que peça essas credenciais está pedindo as do servidor, não as suas.

A contrapartida honesta

Isso é mais infraestrutura do que um aplicativo autossuficiente precisaria. Há um servidor para manter de pé, um fluxo de autorização por cliente e uma versão de protocolo para acompanhar. Para um único usuário com um único app, nada disso se justificaria.

Passa a se justificar no momento em que você quer perguntar sobre o seu próprio treino em algum lugar que não seja o app — o que, na prática, é a maior parte do tempo.