Liga o ChatGPT, o Claude ou as tuas próprias ferramentas (API e MCP)

A API do TrainerPlan permite que as tuas próprias ferramentas usem os teus dados de treino: um assistente de IA como o ChatGPT ou o Claude, através do nosso servidor MCP, um script ou uma folha de cálculo. Podem ler o teu calendário, os treinos realizados, as zonas e a forma física e, se o permitires, planear os teus próprios treinos, notas e eventos. Está incluída no Premium.

A configuração faz-se na app web.

O que as tuas ferramentas podem fazer

• Ler o teu calendário (treinos planeados e realizados, com os seus passos), eventos, notas, comentários, zonas de treino, Fitness, Fadiga e Forma, e a tua biblioteca de treinos.
• Fazer alterações, só se o permitires: adicionar, editar e apagar os teus próprios treinos, notas e eventos.

O que o teu treinador planeou fica como está: as tuas ferramentas não o podem alterar. O teu treinador é avisado do que adicionas, tal como quando o adicionas na app.

Ligar o ChatGPT ou o Claude

Os assistentes compatíveis com MCP (Model Context Protocol), como o ChatGPT, o Claude, o Cursor ou o VS Code, ligam-se diretamente ao TrainerPlan. O endereço do servidor aparece na tua página API / MCP:

https://api.trainerplan.co/api/v1/mcp

1. No ChatGPT ou no Claude, adiciona um conector personalizado com esse endereço.
2. O assistente abre o TrainerPlan. Inicia sessão se te for pedido.
3. Em Ligar … ao TrainerPlan, marca Permitir também que faça alterações só se quiseres que o assistente planeie por ti.
4. Seleciona Permitir.

Depois pergunta por palavras simples, por exemplo "Como correu o meu treino este mês?". A app aparece na tua lista de chaves como App ligada, e podes desligá-la aí com Revogar.

Criar uma chave de API

Scripts, folhas de cálculo e ferramentas que enviam uma chave em vez de iniciar sessão precisam de uma chave de API.

1. Abre O Meu Perfil no menu do canto superior direito e seleciona API / MCP no menu da esquerda.
2. Seleciona Criar chave.
3. Dá à chave um Nome que diga o que a vai usar.
4. Escolhe uma Validade se quiseres que a chave deixe de funcionar sozinha: 30 dias, 90 dias ou 1 ano. Por defeito é Sem validade.
5. Marca Permitir que esta chave faça alterações (adicionar, editar e eliminar os seus próprios treinos, notas e eventos) só se a ferramenta precisar. Sem isso, a chave só pode ler.
6. Introduz a tua Palavra-passe atual. Na primeira vez, aceita os termos da API.
7. Seleciona Criar chave e depois Copiar. A chave só é mostrada uma vez, por isso guarda-a num sítio seguro.

Envia a chave no cabeçalho Authorization: Authorization: Bearer YOUR_API_KEY. Todos os endereços começam por https://api.trainerplan.co/api/v1. A lista completa de pedidos está em Documentação da API, com ligação na página API / MCP, e Como o ligar explica as opções de MCP.

Se tens o plano Básico

A página API / MCP mostra A API e o servidor MCP do TrainerPlan estão incluídos no plano Premium e um botão Atualizar plano. Um assistente que tente ligar-se recebe a indicação de que ligar apps está incluído no Premium. Consulta Passar a Premium, gerir ou cancelar o teu plano.

Bom saber

• Uma chave dá acesso a todos os teus dados de treino, por isso trata-a como uma palavra-passe. Usa uma chave diferente para cada ferramenta. Podes ter até 10 chaves e Revogar uma a qualquer momento sem afetar as outras.
• Cada chave pode fazer 120 pedidos por minuto, dos quais 30 podem ser alterações. Utilização nos últimos 30 dias mostra o que cada chave fez.
• As alterações feitas pela API são iguais às feitas na app: um treino planeado vai para os teus dispositivos ligados.
• A API não está incluída no período experimental gratuito de 14 dias. Funciona com o Premium que pagas tu ou que paga o teu treinador.
• Se um pagamento do Premium falhar e ficar por pagar mais de 3 dias, as tuas chaves deixam de funcionar até ser pago. Continuas a poder revogar chaves depois de saíres do Premium.
• Treinadores: consultem Como usar a API do TrainerPlan.