Guia de conexão com o servidor

O servidor TCP/MCP permite que você consulte seus dados de saúde diretamente de outros dispositivos através da sua rede local. Isso permite a integração com outros aplicativos, scripts ou serviços em execução na mesma rede.

Visão geral

O servidor TCP/MCP cria um servidor de rede local que aceita conexões de outros dispositivos e aplicativos. Você pode consultar dados de saúde, executar automações e interagir com o Health Auto Export programaticamente.

Casos de uso:

• Consultar dados de saúde de outros dispositivos na sua rede
• Integrar com aplicativos e scripts locais
• Acessar dados de saúde de ferramentas de linha de comando
• Criar integrações personalizadas usando o protocolo MCP

Recursos principais:

• Servidor baseado em TCP para conexões confiáveis
• Suporte ao protocolo MCP (Model Context Protocol)
• Acesso à rede local
• Consultas de dados de saúde em tempo real
• Controle de automação programático

Limitações:

• O aplicativo deve estar em execução em primeiro plano
• Atualmente não criptografado (use apenas em redes confiáveis)
• Requer permissão de Rede Local
• As conexões funcionam apenas enquanto o servidor está em execução

Pré-requisitos

• Health Auto Export em execução no seu iPhone/iPad
• Dispositivos na mesma rede local
• Permissão de Rede Local concedida
• Assinatura Premium
• Rede confiável

Exibição de Endereço IP/Porta:

• O servidor exibe o endereço IP do seu dispositivo
• A porta padrão é 9000

Versão do servidor

• v0.0.1: modo de compatibilidade legado (recomendado para configurações existentes).
• v1.0.0: comportamento atualizado alinhado ao contrato mais recente do servidor MCP.

A versão selecionada afeta os valores padrão das ferramentas e a compatibilidade das respostas. Ao alterar de versão, reinicie o servidor para que a mudança tenha efeito.

Conectando ao servidor

Encontrando seu endereço IP

A tela do servidor exibe automaticamente o endereço IP do seu dispositivo. Este é o endereço que outros dispositivos devem usar para se conectar.

Exemplo: 192.168.1.100:9000

Usando o servidor

Protocolo MCP

O servidor usa o Model Context Protocol (MCP) para comunicação.

Logs de conexão

A tela do Servidor exibe logs de conexão mostrando:

• Tentativas de conexão recebidas
• Detalhes das solicitações
• Informações de resposta
• Mensagens de erro

Visualizando logs:

• Os logs aparecem automaticamente na lista na tela do Servidor
• Role para ver a atividade recente
• Os logs ajudam a depurar problemas de conexão

Para diagnóstico mais profundo, exporte os logs completos de eventos do app em Ajustes → Avançado → Exportar logs de eventos ou em Registros de atividade → Compartilhar em qualquer automação (mesmo ZIP). Veja o Guia de logs de eventos do app.

Dicas e melhores práticas

1. Sincronização automática:
   • Carregue o dispositivo e use Espelhamento do iPhone
     • Durante o carregamento, o iOS impõe menos restrições de desempenho, então os dados podem sincronizar com mais frequência
     • Com o Espelhamento do iPhone, o dispositivo se comporta como desbloqueado. Assim o Health Auto Export pode acessar dados de saúde para executar ações automatizadas