BETA · Elite Plus

Kodo MCP

Conecta seus dados Kodo (HRV, sono, treinos, exames de sangue, plano ativo) em qualquer AI client que fale MCP. Pergunta sobre teus dados dentro do Claude Desktop, Cursor, Windsurf — sem sair da ferramenta que você já usa.

O que dá pra fazer

Perguntas de exemplo depois de conectar:

  • ›"Como tá meu HRV hoje comparado ao baseline?"
  • ›"Como andou meu sono na última semana? Tem sleep debt?"
  • ›"Compare minha ferritina nos últimos 3 exames"
  • ›"Estou em fase de peaking, fresh ou overreaching?"
  • ›"Meus melhores 5K, 10K e meia maratona"
  • ›"Qual meu treino programado pra hoje?"
  • ›"Recap da semana passada com deltas vs anterior"
  • ›"Quais wearables meus estão sincronizando bem?"
  • ›"Provas de meia maratona no Brasil em Outubro"
  • ›"Meus macros médios diários da última semana"
  • ›"Me sugere 5 exercícios de peito com halteres"
  • ›"Curva de potência do meu ciclismo últimos 90 dias"
  • ›"Cria um workout de 5x1km Z4 pra mim exportar pro Garmin"
  • ›"Como vai tar o clima pra minha prova IM 70.3 Florianópolis"
  • ›"Vai chover no meu long run de sábado em SP?"
  • ›"Em que fase do meu ciclo estou hoje? Posso puxar HIIT?"
  • ›"Registra que meu período começou dia 15 com fluxo normal"

Setup em 3 passos

Passo 1

Gera sua chave em kodoperformance.com.br/settings/mcp

Copia o valor kd_live_... assim que aparecer. Não mostraremos de novo.

Passo 2

Adiciona o Kodo no config do teu AI client:

Claude Desktop (macOS/Windows/Linux)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kodo": {
      "url": "https://kodoperformance.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer kd_live_SUA_CHAVE_AQUI"
      }
    }
  }
}
Cursor

Settings → Cursor Settings → MCP → Add new MCP Server. Cole:

{
  "url": "https://kodoperformance.com.br/api/mcp",
  "headers": {
    "Authorization": "Bearer kd_live_SUA_CHAVE_AQUI"
  }
}
Windsurf / Cline / VSCode MCP

Mesmo padrão: aponta pra https://kodoperformance.com.br/api/mcp com header Authorization: Bearer kd_live_....

Passo 3

Reinicia o client. Testa perguntando: "Kodo, como tá meu HRV hoje?"

26 ferramentas disponíveis

Score & Prontidão

kodo_daily_score

HRV, sono e prontidão do dia com interpretação vs baseline 7d.

kodo_hrv_trend

HRV diário últimos N dias com baseline 7/30d e delta %.

kodo_sleep_history

Série de sono N dias: duração, sleep debt, noites <7h.

Treinos & Performance

kodo_workouts

Treinos executados últimos N dias. Sport, duração, distância, FC.

kodo_training_load

CTL/ATL/TSB modelo Coggan. Fitness, fatigue, form + interpretação (peaking/fresh/optimal/loading/overreaching).

kodo_power_curve

Melhor potência ciclismo por bucket de duração (5min a 2h+).

kodo_zones

Zonas de FC Z1-Z5 calculadas do max HR observado ou fórmula.

kodo_prs

Personal records: melhor 5K/10K/half/marathon, treino mais longo, maior FC.

kodo_weekly_recap

Recap da semana passada + deltas vs semana anterior + adesão.

Wearables

kodo_wearables_status

Lista dispositivos conectados (Garmin, Polar, Coros, Oura, Wahoo, Apple Watch, Google Fit, TrainingPeaks, Strava) + saúde da sync.

kodo_body_composition_history

Peso ao longo dos últimos N dias com delta.

Sangue & Saúde

kodo_biomarkers

Exame mais recente com 65+ biomarcadores em referências ATLETA-específicas.

kodo_biomarkers_history

Evolução de UM marker (ferritina, colesterol, testosterona) entre TODOS os exames.

kodo_recent_documents

Lista PDFs de exames analisados com ID, título e data.

kodo_document_detail

Detalhe completo de um exame: markers + AI summary + critical findings + performance flags.

kodo_age

Idade biológica estimada via HRV, RHR e sono dos últimos 30 dias.

Plano & Nutrição

kodo_active_plan

Plano de treino ativo + workout planejado pra hoje.

kodo_race_calendar_br

Provas Brasil (5K, 10K, meia, maratona, 70.3, IM) filtradas por distância/mês/cidade.

kodo_meals_recent

Refeições últimos N dias com kcal + macros P/C/F + adherence.

kodo_search_exercises

Busca na biblioteca de 1.324 exercícios PT-BR com filtros.

Push pro Wearable & Clima

kodo_export_workout_tcx

Gera workout estruturado em TCX. URL de download 7d. Aceito por Garmin Connect / Wahoo / Coros / Polar.

kodo_weather_forecast

Previsão até 16d à frente pra qualquer coordenada (Open-Meteo) com warnings pra endurance (calor, chuva, vento, UV).

kodo_race_weather

Forecast do dia da prova ou condições típicas históricas se >16d. Warnings específicos pra endurance.

Ciclo Menstrual

kodo_cycle_status

Fase atual (menstrual/folicular/ovulatória/luteal), dias desde último período, previsão próximo, recomendação de treino por fase.

kodo_cycle_log_period

Registra início/fim de período menstrual com fluxo e sintomas.

kodo_cycle_history

Histórico últimos N meses, duração média de ciclo, regularidade, sintomas mais frequentes.

FAQ

É pago?

Beta MCP é grátis pra qualquer atleta Elite Plus. Depois pode virar tier próprio.

Segurança?

Chaves são armazenadas hasheadas (SHA-256). Cada chave é escopada ao seu user_id, não vê dados de outro atleta. Pode revogar a qualquer momento.

A AI pode alterar meus dados?

Não. Beta v0.1 é read-only: as tools só retornam informação. Não dá pra criar treino, deletar exame, mudar plano etc.

Qual protocolo?

MCP HTTP Streamable, spec 2025-03-26. JSON-RPC 2.0 sobre HTTPS.

Gerar minha chave