Integrações
Gravl MCP
O servidor MCP do Gravl permite que assistentes de IA atuem na sua conta através do Model Context Protocol: registe um treino descrevendo-o, ajuste o seu split a meio da conversa, pergunte quanto fez de supino no mês passado. Se a sua conta usa o Gravl Macros, também pode registar refeições, peso e água e dizer-lhe quantas calorias e macros lhe faltam. Os scopes são verificados em cada chamada e a ligação é revogável a qualquer momento.
Ligar
Adicione o Gravl como conector personalizado na sua app de IA com este URL do servidor:
https://mcp.gravl.ai/mcpClaude
- Abra Definições → Conectores e escolha “Adicionar conector personalizado”.
- Dê-lhe o nome Gravl e cole o URL do servidor.
- Escolha Ligar e inicie sessão com a sua conta Gravl.
ChatGPT
- Abra Definições → Apps e conectores → Definições avançadas e ative o modo de programador.
- Escolha Criar, dê-lhe o nome Gravl, cole o URL do servidor e escolha OAuth.
- Inicie sessão com a sua conta Gravl quando o ChatGPT pedir.
Grok Bot
- Peça ao bot: “Adiciona um servidor MCP personalizado chamado Gravl em
https://mcp.gravl.ai/mcp”. - Verifique o URL e escolha Add it.
- Escolha Authorize no cartão de ligação e inicie sessão com a sua conta Gravl.
Muse
- Peça ao Muse para adicionar um conector personalizado para o Gravl em
https://mcp.gravl.ai/mcp. - Abra a ligação de início de sessão que o Muse envia e inicie sessão com a sua conta Gravl.
Outras apps que suportam servidores MCP remotos com OAuth ligam-se da mesma forma.
Inicia sessão na própria página do Gravl com a sua conta Gravl: o mesmo email e palavra-passe, ou o mesmo acesso Google ou Apple que usa na app. A ligação nunca cria uma conta, e o assistente só vê os seus próprios dados.
O assistente recebe as ferramentas das apps que a sua conta Gravl usa: as de treino para o Gravl Workouts, as de alimentação para o Gravl Macros, e ambas se usar as duas.
Se usa o Gravl Macros, consulte o guia do Gravl Macros, que cobre só as ferramentas de alimentação.
Experimente pedir
- “Regista o treino de hoje: supino 4×8 com 80 kg, depois 3 séries de elevações até à falha.”
- “Como evoluiu o meu agachamento nos últimos três meses?”
- “Troca o agachamento com barra pela prensa de pernas no meu modelo Leg Day.”
- “Cria-me um split superior/inferior de 4 dias para o meu ginásio em casa.”
- “Regista duas torradas de pão integral e um café com leite ao pequeno-almoço.”
- “Quantas calorias me faltam hoje?”
O que consegue fazer
Registre e gerencie treinos
Registre, leia e exclua treinos: os registrados ganham volume, calorias, recordes e troféus como no app.
Modelos e splits
Crie e edite modelos de treino e splits personalizados, ou mude para um dos splits do Gravl.
Progresso e recordes
Resumos de treino, histórico de exercícios, recordes pessoais, pontuações de força e medidas corporais.
Configurações de treino
Altere objetivos, foco muscular, aquecimento, tempos de descanso e preferências de treino, um campo por vez.
Academias e equipamentos
Leia seus perfis de academia e atualize os equipamentos com que o Gravl planeja seus treinos.
Catálogo de exercícios
Pesquise exercícios, encontre alternativas e crie um exercício personalizado quando faltar um movimento.
Para contas Gravl Macros
Pesquisar alimentos
Pesquise no catálogo do Gravl Macros alimentos genéricos e de marca, com calorias e macros por 100 g e as respetivas porções.
Registar refeições
Adicione um alimento ao seu dia com a porção que indicou, como “2 fatias” ou “uma chávena”, ou em gramas: do catálogo, dos seus próprios alimentos ou de uma refeição guardada. Quando nada corresponde, registe uma estimativa rápida de calorias e macros.
Corrigir ou copiar entradas
Altere a quantidade, a hora ou o dia de uma entrada, copie refeições para outro dia (“o mesmo pequeno-almoço de ontem”) ou elimine uma entrada depois de confirmar qual.
Consultar o seu dia
As entradas de um dia com hora, porção, calorias e macros, mais os totais diários, as suas metas de calorias e macros e o que falta.
O seu progresso
As suas metas de calorias e macros e o seu objetivo, como correu uma semana ou um mês face a elas, e a evolução do seu peso e das suas medidas.
Peso, medidas e água
Registe uma pesagem, medidas corporais ou água nas unidades que usa, ou defina um novo peso-alvo. Uma pesagem por dia, como na app.
Rotinas e dias de jejum
Registe ou salte a rotina de um dia e marque um dia como dia de jejum.
Adicionar um alimento pelo rótulo
Adicione um alimento embalado que o catálogo não tem a partir do rótulo nutricional e registe-o logo a seguir.
Os treinos registados através do MCP são de primeira classe: recebem cálculos de volume e calorias, recordes pessoais, troféus e entradas no feed exatamente como se tivessem sido registados na app, e a app recolhe-os na sincronização seguinte.
Tudo o que registar através do MCP aparece no Gravl Macros automaticamente, com os totais do dia recalculados. As sequências, as conquistas e a sua estimativa de gasto energético atualizam-se da próxima vez que abrir a app.
Modelo de segurança
| Camada | O que faz |
|---|---|
| Início de sessão Gravl | Inicia sessão na própria página do Gravl, nunca dentro da app de IA. A app de IA nunca vê a sua palavra-passe. |
| Scopes por ligação | Cada ligação transporta um conjunto explícito de scopes; cada chamada de ferramenta é verificada contra ele no servidor. |
| Associação de contas | Cada ligação fica associada à conta Gravl com que inicia sessão. Nunca cria uma conta nova. |
| Revogação | Desligue a partir do seu cliente MCP ou revogue a ligação a partir da sua conta Gravl; qualquer uma das opções corta o acesso imediatamente. |
MCP ou a REST API?
| Está a construir… | Use |
|---|---|
| Uma experiência de assistente de IA (chat, agentes) na sua própria conta | MCP |
| Um dashboard, script ou integração que lê os seus dados | Um token pessoal + REST API |
| Uma app em que outros utilizadores do Gravl iniciam sessão | OAuth + REST API |