Como conectar o Apple Health ao Muse Code por MCP

O que você precisa

Um iPhone com registros no Apple Health, o app telo da App Store e o Muse Code instalado e com login feito. No telo, entre na conta e envie seu histórico; a primeira sincronização precisa terminar antes de o Muse Code conseguir ler algo.

Este guia trata do Muse Code, da Meta, e não da tiara de meditação Muse, que grava as próprias sessões no Apple Health. A configuração segue a documentação MCP do Muse Code; não significa que todas as versões foram testadas com o telo.

Desligue o Contributor mode antes

Na assinatura do Muse Code, o Contributor mode vem ligado, e a Meta pode usar prompts, arquivos e contexto para treinar modelos futuros. O que o telo devolve vira parte desse contexto. Desligue antes de conectar registros de saúde: abra /settings e mude a linha Contributor mode, ou abra o Muse Code com --contributor-mode off, ou defina MUSE_CONTRIBUTOR_MODE=0.

Confira os termos atuais da Meta para o seu tipo de conta. Contas pay-as-you-go e Zero Data Retention não têm essa opção.

Adicione o servidor MCP do Apple Health no settings.json

O Muse Code não tem comando para adicionar servidor. Coloque o bloco acima em ~/.config/muse/settings.json, junto com o que já existe lá. A chave schema_version é obrigatória.

Não coloque cabeçalho Authorization. O telo usa OAuth, e o Muse Code guarda e renova o token sozinho.

{
  "schema_version": 1,
  "mcp_servers": {
    "telo": {
      "transport": "streamable_http",
      "url": "https://telo.health/mcp"
    }
  }
}

Entre com OAuth

O comando abre uma página do telo no navegador. Informe o e-mail, digite o código de 6 dígitos e aprove o acesso. Se uma sessão começar antes do login, o Muse Code mostra o 401 e imprime este mesmo comando.

muse mcp login telo

Confira se o Muse Code lê o Apple Health

1. Abra o muse e rode /mcp. O telo deve aparecer conectado, com ferramentas chamadas mcp__telo__ seguido do nome da ferramenta.
2. Peça ao Muse Code para usar o telo e listar as métricas disponíveis e as datas que elas cobrem.
3. Confirme que a resposta vem de uma chamada de ferramenta do telo, com datas reais. Se ele descrever dados sem chamar ferramenta, está chutando.

Uma primeira pergunta

Pedir a cobertura primeiro deixa as lacunas visíveis. Se pedir ao Muse Code para salvar a análise, veja onde o arquivo vai parar: um commit num repositório pode publicar seus registros de saúde.

Use o telo para conferir quais métricas do Apple Health estão disponíveis e quão recentes elas são. Depois compare meu sono e minha frequência cardíaca em repouso nos últimos 7 dias com os 7 dias anteriores, e liste as datas sem registro.

Problemas comuns

Se o Muse Code para na abertura, o servidor está no modo padrão required e não conectou. Rode muse mcp login telo de novo, ou coloque "mode": "optional" na entrada do telo para a sessão seguir com um aviso.

Se a conexão funciona mas faltam registros, confira a sincronização no app telo. Uma conexão MCP funcionando não prova que as permissões de leitura do HealthKit foram concedidas no iPhone. Para tirar o acesso, rode muse mcp logout telo.

Dúvidas práticas