Conectar ao 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

Iniciando o servidor

1. Na tela do Servidor, toque em "Iniciar servidor"
2. Aguarde o servidor iniciar (o status mudará para "Em execução")
3. Anote o endereço IP e a porta exibidos na tela
4. O servidor agora está aceitando conexões

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ósticos mais profundos você também pode exportar os registros de eventos do app na área Avançado/depuração. Consulte o Guia de registros de eventos do app.