Integração externa com IA: MCP + API

Conecte o Hexor Fit ao seu assistente de IA (protocolo MCP) ou à sua automação (API REST). Cadastre alunos, gere fichas e veja a semana de cada um por conversa. Disponível nos planos Pro e Studio.

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-a.

  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 escreva como falaria com uma pessoa. Ele escolhe as ferramentas 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

gerar_fichano modo "motor" e salvar_ficha não consomem 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" (instantâneo) ou pelo modo "ia" (usa uma ficha da franquia ou um crédito de IA).
salvar_ficha
A própria IA monta a ficha; o Hexor Fit valida pelas 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_....

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 a integração.

Criar conta grátis