Apple Health AI Bridge

Comece pela App Store.

O caminho padrão instala o aplicativo complementar para iPhone sem o Xcode e, em seguida, o emparelha com a máquina que executa seu receptor e cliente MCP.

1. Instale o aplicativo complementar para iPhone

Baixe o aplicativo para iPhone na App Store. O TestFlight continua disponível para versões beta e testes de pré-lançamento.

Baixar na App Store Participar do beta do TestFlight

2. Escolha uma rota antes da configuração

A URL do receptor não é fornecida pelo Apple Health AI Bridge. Ela é a rota HTTPS privada que o iPhone físico usa para alcançar o computador receptor, inclusive quando o telefone está fora de casa.

Já usa Tailscale?

Use a rota documentada do Tailscale Serve quando tanto o receptor quanto o iPhone já estiverem na mesma tailnet. O Tailscale é opcional, não é um requisito do produto.

Ingresso HTTPS privado assistido por agente

Use o caminho assistido por agente do guia de configuração. O agente de configuração deve inspecionar primeiro, visualizar cada alteração de DNS, túnel, proxy, firewall e serviço, e aguardar aprovação.

Não é o padrão de sincronização contínua: uma rota somente de rede local interrompe a sincronização quando o iPhone sai dessa rede. Não copie um nome de host de exemplo nem exponha a porta 8765 do receptor diretamente à internet pública.

Opcional no Mac: o iCloud Mailbox criptografado (Beta) envia arquivos de sincronização criptografados por meio da sua própria conta iCloud. O Direct continua sendo o padrão, e o Apple Health AI Bridge nunca alterna automaticamente entre os dois métodos. Receptores Linux usam Direct.

3. Instale e execute a configuração

BASE="https://github.com"
OWNER="roian6"
REPO="apple-health-ai-bridge"
TAG="@receiver-v1.1.2"
URL="git+$BASE/$OWNER/"
URL="${URL}${REPO}.git${TAG}"
uv tool install "$URL"

# Routes A/B: run only after
# the guide sets the HTTPS URL.
health-bridge setup \
 --receiver-url \
 "$HEALTH_BRIDGE_RECEIVER_URL"

Isso instala o Receiver/CLI 1.1.2, compatível com o iPhone Companion 1.1.1 (50) e o Batch Protocol 1.0.0.

O receptor pode permanecer em execução enquanto sua IA lê os dados sincronizados por meio da CLI ou do MCP.

Para o fallback deliberado da Rota C, somente de rede local, use a URL LAN real e sua vinculação obrigatória sem loopback:

health-bridge setup \
 --receiver-url \
 "$HEALTH_BRIDGE_RECEIVER_URL" \
 --receiver-host 0.0.0.0 \
 --receiver-port 8765

O guia de rotas com versão fixada explica como configurar a URL real para cada rota. A configuração principal cria o banco de dados privado do receptor e a página de emparelhamento de uso único, emite um descritor MCP stdio no mesmo host e verifica o processo MCP local. Ela não comprova a prontidão do receptor nem a acessibilidade do iPhone. A configuração não modifica a configuração do cliente, a menos que você escolha explicitamente um cliente.

4. Supervisione, verifique, emparelhe e ative a sincronização

1. Coloque o comando impresso pela configuração no gerenciador de serviços aprovado do host e inicie o receptor.
2. Exija {"status":"ok"} da URL local /health impressa no host do receptor.
3. Abra a URL exata voltada para o telefone /health no iPhone físico e exija a mesma resposta. As Rotas A e B usam HTTPS; a Rota C usa HTTP apenas na mesma LAN confiável.
4. Abra a página privada de emparelhamento no computador receptor e escaneie o QR com a Câmera do iPhone.
5. Conecte o aplicativo do iPhone e revise a folha de permissões nativa da Apple.
6. Ative a Sincronização Automática e aguarde o primeiro upload bem-sucedido ao receptor.

O acesso à saúde permanece somente leitura, e você pode alterar as permissões do Apple Health a qualquer momento em Ajustes do iOS.

Compilar a partir do código-fonte

Colaboradores e usuários avançados podem seguir o guia de compilação própria com versão definida.

Ler guia de configuração Ver código-fonte