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. Os scopes são verificados em cada chamada e a ligação é revogável a qualquer momento.
Ligar
Adicione o Gravl como conector personalizado em qualquer cliente compatível com MCP:
https://mcp.gravl.ai/mcp- Claude: Definições → Conectores → “Adicionar conector personalizado”, cole o URL e conclua o início de sessão quando pedido.
- Outros clientes: qualquer cliente que suporte servidores MCP remotos com OAuth funciona da mesma forma.
Inicie sessão com o mesmo email da sua conta Gravl. A ligação associa-se à sua conta existente, nunca cria uma nova, e o seu email tem de estar verificado. O assistente só vê os seus próprios dados.
O que consegue fazer
Registar e gerir treinos
Crie, leia e elimine treinos. Os treinos registados recebem volume, calorias, recordes pessoais e troféus exatamente como na app.
Templates e splits
Crie e edite templates de treino e splits de treino personalizados a partir de uma conversa.
Definições e conta
Leia e atualize as definições de treino, aquecimento, tempos de descanso e aparência da sua conta.
Explorar o catálogo
Pesquise exercícios e equipamento, consulte recordes pessoais e medições corporais.
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.
Modelo de segurança
| Camada | O que faz |
|---|---|
| Início de sessão OAuth | O servidor MCP verifica a sua identidade antes de qualquer ferramenta correr; as suas credenciais do Gravl nunca são partilhadas com o cliente de IA. |
| 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 | As ligações associam-se a contas existentes apenas por email verificado. |
| 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 |