Integração externa com IA: MCP + API

Conecte o Hexor Fit ao seu assistente de IA favorito pelo protocolo MCP (Claude Code, Claude Desktop, Cursor e outros compatíveis) ou à sua automação pela API REST: cadastre alunos, gere fichas e veja como foi a semana de cada um conversando. A integração está no plano Pro e no Studio, pelo servidor MCP ou pela API REST.

Como configurar

  1. Crie uma chave

    No Hexor Fit, abra Conta → Integrações e crie uma chave. Ela começa com fit_ e aparece uma vez só; guarde num lugar seguro.

  2. Adicione o servidor MCP

    No terminal, rode o comando abaixo trocando fit_SUA_CHAVE pela sua chave.

    Terminal
    claude mcp add --transport http hexor-fit https://fit.hexor.com.br/api/mcp --header "Authorization: Bearer fit_SUA_CHAVE"

  3. Peça em português

    Abra seu assistente de IA (no exemplo, o Claude Code) e fale como falaria com uma pessoa. Ele escolhe as ferramentas do Hexor Fit sozinho.

    • Crie a aluna Ana, 28 anos, hipertrofia 4x/semana, e gere a ficha.
    • Monte você mesmo uma ficha de glúteos para a Ana e salve.
    • Como foi a semana do João?

Ferramentas disponíveis no MCP

Com gerar_fichano modo "motor" e com salvar_ficha, o Claude trabalha sem consumir seus créditos de IA.

listar_alunos
Lista seus alunos, com objetivo e frequência.
criar_aluno
Cadastra um aluno novo com os dados que você der na conversa.
ver_aluno
Mostra a ficha cadastral, a anamnese e as restrições de um aluno.
gerar_ficha
Gera a ficha pelo modo "motor" (grátis, instantâneo) ou pelo modo "ia" (usa um crédito de IA).
salvar_ficha
O próprio Claude monta a ficha; o Hexor Fit valida contra as regras de prescrição e publica, sem gastar crédito.
validar_ficha
Confere uma ficha contra as regras sem publicar, e aponta o que ajustar.
listar_fichas
Lista as fichas de um aluno, da mais recente para a mais antiga.
ver_progresso
Cargas registradas e check-ins do aluno no período.
buscar_exercicios
Procura exercícios na biblioteca por nome, grupo muscular ou equipamento.

Prefere a API REST?

A mesma chave funciona em https://fit.hexor.com.br/api/v1/..., no cabeçalho Authorization: Bearer fit_.... Serve para scripts, automações e outros agentes.

Listar alunos

GET /api/v1/students
curl https://fit.hexor.com.br/api/v1/students \
  -H "Authorization: Bearer fit_SUA_CHAVE"

Gerar uma ficha pelo Motor

Troque "motor" por "ia" para gerar com IA (usa um crédito).

POST /api/v1/workouts/generate
curl -X POST https://fit.hexor.com.br/api/v1/workouts/generate \
  -H "Authorization: Bearer fit_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"studentId":"ID_DO_ALUNO","mode":"motor"}'

Ainda não tem conta? Crie a sua grátis e faça upgrade quando quiser ligar a integração com IA.

Criar conta grátis