Somvia
Lê o Apple Health no iPhone e transforma treinos e leituras noturnas em pontuações de recuperação, carga de treino e limiar. O Claude, o ChatGPT ou um agente que você mesmo executa pode ler as pontuações e os detalhes dos treinos via MCP.
Servidor MCP hospedado
npx add-mcp 'https://somvia.app/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
O que um servidor MCP da Apple Health faz
O Apple Health armazena dados no seu iPhone. Um servidor MCP oferece a um cliente de IA compatível um conjunto padrão de ferramentas para ler esses dados. Em vez de colar uma captura de tela ou enviar um arquivo gigante, o cliente pode solicitar um intervalo de datas limitado, listar as sessões de treino disponíveis e buscar uma série mais detalhada somente quando a pergunta exigir.
A Somvia separa as duas funções: o aplicativo para iPhone cuida da autorização e sincronização do Health; o endpoint MCP hospedado responde a chamadas de ferramentas autenticadas e somente leitura. O endpoint é https://somvia.app/mcp.
A distinção útil é a profundidade, não "IA de saúde" em geral. Os totais diários podem responder "quantos passos?". Perguntas sobre treinos geralmente precisam da sessão por trás deles: intervalos, parciais, formato da frequência cardíaca, velocidade, potência ou cadência.
Como funciona o fluxo MCP remoto
-
Escolha o que a Somvia pode ler
Instale a Somvia no iPhone, entre com a Apple e autorize apenas as categorias do Apple Health que você deseja compartilhar. -
Sincronize o histórico que você precisa
Selecione uma janela de 7, 30, 90 ou 180 dias para medições diárias. Sessões de treino e séries de detalhes disponíveis podem cobrir até 180 dias. -
Conecte seu cliente MCP
Clientes com interface gráfica podem usar OAuth e "Entrar com a Apple". Agentes autônomos ou sem interface podem usar o token de acesso privadosom_exibido no aplicativo. -
Pergunte pelo agente que você já usa
O agente descobre as ferramentas da Somvia e busca apenas os dados estruturados necessários para a resposta.
MCP remoto, MCP local ou exportação?
| Abordagem | Boa opção para | Compromisso |
|---|---|---|
| Exportação XML ou CSV | Análise arquivística pontual e ferramentas que ingerem um arquivo completo | Manual, frequentemente grande e rapidamente desatualizado |
| Servidor MCP local | Usuários que querem processamento vinculado ao próprio computador | Uma máquina e um servidor local precisam permanecer disponíveis para o cliente |
| Somvia MCP remoto | Sincronização automática e acesso de vários agentes ou dispositivos | Os dados selecionados são armazenados no serviço de nuvem gerenciado da Somvia até que você os exclua |
Nenhuma opção é universalmente melhor. A Somvia foi projetada para pessoas que valorizam um endpoint continuamente disponível e profundidade estruturada de treinos mais do que um fluxo de trabalho totalmente local no dispositivo.
O que um agente pode consultar
| Camada | Exemplos | Por que importa |
|---|---|---|
| Medições diárias | Sono, VFC, frequência cardíaca em repouso, passos, energia ativa | Perguntas de tendência e entre métricas |
| Resumo do treino | Atividade, duração, distância, ritmo, energia, parciais | Comparar sessões sem carregar cada amostra |
| Séries do treino | Frequência cardíaca, velocidade, rota, potência, cadência, ritmo de braçadas | Analisar intervalos, formato de esforço, ritmo e recuperação |
Os campos exatos dependem do que o Apple Health registrou e do que você selecionou. A Somvia nunca inventa uma série ausente e não grava no Apple Health.
Conecte o cliente que você usa
Hermes Agent MCP HTTP remoto com token de portador e sem login pelo navegador. OpenClaw Adicione a Somvia como servidor HTTP Streamable e compare com o resumo diário nativo. Claude Adicione a URL do conector remoto e autentique com a Apple. ChatGPT Entenda a opção nativa do Health e o caminho MCP remoto.
Perguntas que valem a pena fazer
- Compare minhas últimas quatro corridas intervaladas. O ritmo melhorou com frequência cardíaca semelhante?
- Como a duração do sono e a VFC mudaram nas noites anteriores aos meus treinos mais fortes?
- Mostre o ritmo e a deriva da frequência cardíaca nas minhas corridas longas deste mês.
- Quais dias de treino foram seguidos por uma frequência cardíaca em repouso mais baixa, em vez de mais alta?
Estas são perguntas pessoais de condicionamento físico e bem-estar, não diagnóstico médico. Use cuidados médicos qualificados para sintomas, tratamento ou decisões clínicas.
Perguntas frequentes
O que é um servidor MCP da Apple Health?
É uma ponte que expõe medições autorizadas do Apple Health como ferramentas estruturadas e somente leitura usando o Model Context Protocol. Um cliente compatível pode solicitar apenas as datas e os detalhes necessários para uma pergunta.
A Somvia exige uma exportação XML do Apple Health?
Não. O aplicativo para iPhone lê as categorias do Health que você autoriza e sincroniza o histórico selecionado para seu endpoint privado.
Quais clientes de IA podem se conectar?
A Somvia usa MCP HTTP Streamable padrão. Clientes com capacidade OAuth podem entrar com a Apple, enquanto clientes sem interface, como Hermes e OpenClaw, podem usar um token de portador emitido pelo aplicativo.