Pular para o conteúdo
OpenAthlete

Servidor MCP

Seu treino dentro do Claude e do ChatGPT

Conecte ao OpenAthlete o assistente que você já paga. Ele lê seu calendário, suas atividades e sua forma e, com a sua permissão, planeja um bloco de 12 semanas direto no seu calendário. De lá, as sessões vão para o seu relógio.

  • 23 ferramentas
  • Grátis em todos os planos
  • OAuth, leitura e escrita separadas
Claude · OpenAthlete

Monte uma planilha de 12 semanas para uma maratona em 14 de março, 5 corridas por semana, longão aos domingos.

  • get_athlete_contextzonas, VAM, forma −6
  • get_training_volumeúltimas 12 semanas
  • plan_sessions60 sessões, 4 blocos

Sua planilha está no calendário: 60 sessões em 4 blocos, limiar às terças, longões de 1h30 a 2h50 aos domingos, uma semana mais leve a cada quatro, duas semanas de polimento. Os treinos chegam ao seu Garmin conforme as datas se aproximam.

Em um parágrafo

O que é MCP

O Model Context Protocol é um padrão aberto que permite a um assistente de IA usar ferramentas oferecidas por outro app. O OpenAthlete é um servidor MCP: depois de conectado, o Claude ou o ChatGPT podem chamar funções como get_training_load ou plan_sessions na sua conta, do mesmo jeito que você clicaria pelo app. O modelo roda do lado do seu assistente, então o OpenAthlete não paga nada por ele, e você também não: o servidor MCP é gratuito em todos os planos, inclusive em instâncias auto-hospedadas.

Exemplos

O que você pode pedir

Quatro pedidos e as ferramentas que o assistente chama para responder.

“Monte uma planilha de 12 semanas para uma maratona em 14 de março, 5 corridas por semana, com o longão aos domingos.”

get_athlete_context→get_training_load→get_training_volume→plan_sessions

“Estou com febre desde ontem. Adapte minhas próximas duas semanas.”

create_period→get_calendar→move_sessions→update_session

“Como foi a semana passada em relação ao planejado? Minha forma está boa para a prova de sábado?”

get_calendar→get_activity→get_training_load

“Meu novo FTP é 265 W: registre e atualize minhas zonas de potência.”

log_metrics→update_training_zone

Ferramentas

23 ferramentas: calendário, carga, atividades, planejamento

Os treinos são lidos e escritos em unidades simples: durações em segundos, paces como 4:35 por km, suas zonas por id, ou porcentagens de VAM, FTP ou frequência cardíaca máxima. As datas ficam no seu fuso horário.

Acesso de leitura

read · 12
  • get_athlete_context

    Data de hoje e fuso horário, métricas, zonas, condicionamento e forma, as últimas 4 semanas, próximas provas, períodos e lesões. Os agentes chamam esta primeiro.

  • get_calendar

    Sessões planejadas (realizadas, perdidas ou por fazer), provas, notas, atividades e períodos entre duas datas.

  • get_sessionget_activity

    O treino estruturado de uma sessão; as voltas de uma atividade e suas respostas às perguntas pós-atividade.

  • get_activitiesget_training_volume

    Histórico de treino e volume semanal por esporte.

  • get_training_load

    Carga semanal, realizada e planejada, com condicionamento, fadiga e forma projetados sobre as sessões planejadas.

  • get_metricsget_capacitiesget_records

    Histórico de métricas (peso, FC de repouso, VFC, sono), capacidades e melhores esforços.

  • list_workout_templateslist_athletes

    Sua biblioteca de treinos; para treinadores, os atletas que eles orientam.

Acesso de escrita, além disso

write · 11
  • plan_sessions

    Adiciona até 60 treinos com treinos estruturados, provas e notas de uma vez. Ou tudo é salvo, ou nada.

  • update_session

    Altera uma sessão, uma prova ou uma nota; para uma sessão repetida, esta e as seguintes.

  • move_sessionscopy_sessionsrepeat_session

    Move ou copia sessões por dias, repete uma a cada algumas semanas.

  • delete_sessions

    Exclui sessões planejadas. Sessões realizadas e atividades gravadas nunca são excluídas.

  • create_periodupdate_perioddelete_period

    Blocos de treino e períodos sem treino: viagem, doença, lesão.

  • log_metricsupdate_training_zone

    Registra medidas e altera uma zona depois de um teste.

Configuração

Conectado em dois minutos

O endereço é o mesmo em todo lugar. Em uma instância auto-hospedada, é https://<seu domínio>/api/mcp.

Guia de configuração
URLhttps://api.openathlete.org/mcp

Claude

claude.ai e o app de desktop, depois também no celular. Um conector personalizado no plano gratuito

  1. 1Customize › Connectors › Add custom connector
  2. 2Cole o endereço e clique em Connect
  3. 3Entre no OpenAthlete e escolha Permitir
Guia passo a passo

ChatGPT

Planos Business, Enterprise e Edu quando verificamos; o Pro só lê

  1. 1Plugins › + › Add custom MCP server
  2. 2Cole o endereço, escolha OAuth e crie como plugin
  3. 3Autorize no OpenAthlete
Guia passo a passo

Claude Code

No terminal, depois /mcp para entrar

claude mcp add --transport http openathlete https://api.openathlete.org/mcp

Cursor, VS Code, seu próprio agente

OAuth se o cliente for compatível; caso contrário, um token pessoal gerado em Configurações › Agentes de IA, exibido uma única vez

{
  "mcpServers": {
    "openathlete": {
      "url": "https://api.openathlete.org/mcp",
      "headers": { "Authorization": "Bearer oa_pat_..." }
    }
  }
}

Para treinadores

Trabalhe com todos os seus atletas

O assistente de um treinador acessa os atletas que ele orienta, com as mesmas regras do app. Ele lista os atletas e depois informa o atleta em cada pedido. Peça uma revisão da semana de todos, ou refaça o bloco de um atleta depois de um resfriado forte.

OpenAthlete para treinadores
ChatGPT · OpenAthlete

Para cada um dos meus atletas, como foi a semana passada em relação ao planejado?

  • list_athletes6 atletas
  • get_calendar× 6, semana passada

Quatro de seis cumpriram 90% ou mais do tempo planejado. A Léa perdeu as duas sessões de qualidade e escreveu "panturrilha travada" na quinta. O Marc fez 30% a mais que o planejado.

Segurança

Segurança e permissões

O que um assistente faz com seus dados depende dele e do seu provedor. Conecte os que você confia.

OAuth 2.1 com PKCE: você aprova cada assistente em uma página do OpenAthlete. Ele nunca vê sua senha.

Leitura e escrita são separadas. Um assistente com acesso de leitura nem recebe as ferramentas de escrita.

Os tokens são armazenados com hash. Os tokens de acesso duram uma hora; os de atualização são de uso único, e um token roubado usado duas vezes revoga o acesso.

Tokens pessoais duram 30, 90 ou 365 dias, ou nunca expiram. Revogue qualquer conexão em Configurações › Agentes de IA; ela para na requisição seguinte.

Os assistentes acessam seu treino, não sua conta: nada de troca de senha, de dispositivo ou de assinatura, nada de apagar seu histórico.

Perguntas frequentes

Sim, em todos os planos, inclusive o Free, e em instâncias auto-hospedadas. O modelo roda do lado do seu assistente, na sua conta do Claude ou do ChatGPT.

Claude (claude.ai, desktop, mobile e Claude Code), ChatGPT no modo desenvolvedor, Cursor, VS Code e qualquer cliente MCP compatível com OAuth ou bearer token.

Não. Sessões realizadas e atividades gravadas são o seu histórico e ficam somente leitura via MCP. Ele só pode alterar ou excluir sessões ainda por fazer.

Sim, exatamente como as que você mesmo planeja: para Garmin, Suunto ou COROS, se a exportação de treinos estiver ativada.

Sim. Aprove só o escopo de leitura, ou crie um token pessoal com acesso de leitura. Assim o assistente não pode alterar nada.

Sim. O endereço é https://<seu domínio>/api/mcp, com o mesmo fluxo OAuth e as mesmas ferramentas.

Dê ao seu assistente algo real com que trabalhar

Crie uma conta, conecte seu relógio para suas atividades chegarem e depois adicione o OpenAthlete como conector.

Grátis para sempre. Sem cartão de crédito.