Central de ajuda HealthyApps
Português (Brasil)
Central de ajuda
Site principal ↗

Buscar tópicos de ajuda

Conectar ao servidor

Conecte-se ao servidor MCP do Health Auto Export para clientes de IA e scripts na sua rede local.

Última atualização: 31 de outubro de 2026

Nesta página
Visão geralPré-requisitosIniciar o servidorAutenticação (HTTP)
HTTPS (TLS) HTTPS (TLS) Ativar o HTTPSConfiar na CA nos clientesAlterações de IP LAN do iOSExemplo de endpoint HTTPS
Versão do contrato
Configuração do cliente Configuração do cliente Claude Code (CLI)Claude Code / arquivo de projeto (<code>.mcp.json</code>)Cursor (<code>~/.cursor/mcp.json</code>)VS Code (<code>.vscode/mcp.json</code>)Codex CLI (<code>~/.codex/config.toml</code>)mcp-remote (iOS / LAN)
Argumentos das ferramentas Argumentos das ferramentas Formatos de data
TCPDicasObter ajuda

O servidor MCP no iOS permite que clientes de IA e scripts na sua rede local consultem seus dados de saúde. HTTP (MCP streamable) é o transporte recomendado. O iOS também oferece suporte a TCP para configurações com bridge Node.

Os clientes são executados no seu Mac ou em outros dispositivos da mesma rede e se conectam ao endpoint mostrado no seu iPhone.

Visão geral

Transporte Endpoint
HTTP (recomendado) http://{LAN_IP}:9000/mcp (ou https:// quando o HTTPS estiver ativado)
TCP {LAN_IP}:9000 (sem autenticação)

Substitua {LAN_IP} pelo endereço mostrado na tela Servidor enquanto o servidor estiver em execução.

Casos de uso:

  • Conectar Claude Code, Codex, Cursor ou VS Code no seu Mac aos dados de saúde do seu iPhone
  • Usar mcp-remote (iOS / LAN) para clientes apenas stdio como o Claude Desktop
  • Consultar métricas e treinos a partir de scripts na sua rede local (HTTP)
  • Integrações TCP por meio do bridge Node health-auto-export-mcp-server

Pré-requisitos

  • Health Auto Export no iPhone (o app deve permanecer em primeiro plano enquanto houver clientes conectados)
  • Assinatura Premium
  • HTTP: token Bearer da tela Servidor
  • Permissão de Rede local no iPhone
  • Dispositivo cliente: mesma Wi‑Fi ou LAN do iPhone; Node.js apenas se você usar mcp-remote (iOS / LAN)

Iniciar o servidor

  1. No iPhone, abra Servidor na aba Exportar. No iPad, use a barra lateral.
  2. Escolha HTTP (recomendado) ou TCP
  3. Opcionalmente, ative Usar HTTPS (instruções abaixo)
  4. Toque em Iniciar servidor
  5. Copie a URL do endpoint e o token Bearer

O servidor ativo para automaticamente se o Health Auto Export for para segundo plano, seja com HTTP ou TCP.

Autenticação (HTTP)

Todas as solicitações HTTP exigem:

Authorization: Bearer <your-token>
  • Regenere o token na tela Servidor se considerar necessário
  • Em HTTP sem criptografia, o token é enviado por uma conexão não criptografada—use apenas em redes confiáveis ou ative o HTTPS
  • O TCP legado não tem autenticação (inalterado)

HTTPS (TLS)

O HTTPS usa uma autoridade de certificação (CA) gerada localmente. Exporte e confie no certificado em cada dispositivo cliente antes de se conectar por https://.

Ativar o HTTPS

  1. Abra a visualização Servidor (iPhone: aba Exportar; iPad: barra lateral)
  2. Ative Usar HTTPS
  3. Toque em Exportar certificado CA e use a folha de compartilhamento para AirDrop ou salvar o arquivo CA em cada dispositivo cliente
  4. Inicie o servidor — confirme que a URL do endpoint muda para https://

Confiar na CA nos clientes

Confie na CA exportada no dispositivo que executa o cliente de IA (geralmente o seu Mac):

  1. Exporte a CA da tela Servidor no iPhone
  2. Abra o PEM no Acesso às Chaves no Mac cliente
  3. Defina Confiança → Sempre confiar

Versões do Node para a configuração gerada

A configuração gerada do bridge Node do app usa NODE_OPTIONS=--use-system-ca para estas versões do Node:

Linha do Node Versão mínima
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ qualquer

Em Node mais antigo, defina NODE_EXTRA_CA_CERTS para um caminho PEM que o processo do bridge possa ler. Emitir --use-system-ca em Node sem suporte impede o processo de iniciar.

Escopo da confiança: --use-system-ca confia no Keychain completo do sistema, não apenas na CA deste app. NODE_EXTRA_CA_CERTS adiciona a CA exportada aos certificados confiáveis do Node. Consulte opções de certificado do Node.

Tipo de cliente Configuração
Cursor, VS Code, Claude Code, Codex Confiança no Keychain no Mac cliente — use o endpoint https:// da tela Servidor
mcp-remote (iOS / LAN) Confie na CA no Keychain no Mac que executa mcp-remote. O snippet usa NODE_OPTIONS=--use-system-ca quando o Node atende à versão mínima; em Node mais antigo, defina NODE_EXTRA_CA_CERTS para um caminho PEM legível
curl / scripts Passe --cacert /path/to/mcp-ca.pem ou defina NODE_EXTRA_CA_CERTS

A impressão digital da CA é mostrada na tela Servidor para que você possa verificar se exportou o certificado correto.

Alterações de IP LAN do iOS

Copie novamente a URL do endpoint se o endereço de rede do seu iPhone mudar. Se for fornecido um certificado CA de substituição, exporte-o e atualize a confiança em cada dispositivo cliente.

Exemplo de endpoint HTTPS

https://192.168.1.42:9000/mcp

Substitua o host pelo valor mostrado na tela Servidor.

Versão do contrato

Versão Nomes das ferramentas TCP Notas
v1.1.0 (padrão) get_* Recomendada para novas configurações
v1.0.0 Legacy (health_metrics, …) Atualização de compatibilidade do Claude Desktop v1.0.0
v0.0.1 Legacy Compatibilidade mais antiga

O HTTP sempre usa nomes de ferramentas get_*; a versão do contrato afeta apenas os padrões do esquema.

Configuração do cliente

A tela Servidor inclui snippets para copiar e colar para cada integração. Use o endpoint e o token mostrados lá. Verifique os formatos em relação à versão do seu cliente.

Todos os exemplos abaixo usam um endereço LAN de espaço reservado—substitua pelo endereço do seu iPhone na tela Servidor.

Claude Code (CLI)

Execute no seu Mac (requer a CLI do Claude Code):

HTTP:

claude mcp add --transport http health-auto-export \
  http://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

HTTPS (depois de exportar e confiar na CA no seu Mac):

claude mcp add --transport http health-auto-export \
  https://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

Claude Code / arquivo de projeto (.mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Codex CLI (~/.codex/config.toml)

O Codex se conecta diretamente por HTTP streamable — não é necessário um bridge Node.js. A configuração fica em ~/.codex/config.toml (global) ou .codex/config.toml em um diretório de projeto confiável.

CLI (recomendado):

export HAE_MCP_TOKEN="<token>"
codex mcp add health-auto-export \
  --url http://192.168.1.42:9000/mcp \
  --bearer-token-env-var HAE_MCP_TOKEN

Configuração manual (config.toml):

[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true

Exporte HAE_MCP_TOKEN com o seu token Bearer antes de iniciar o Codex. Após a configuração, execute /mcp dentro de uma sessão do Codex para verificar se o servidor está conectado.

Se regenerar o token Bearer no Health Auto Export, atualize HAE_MCP_TOKEN e execute novamente codex mcp add, ou remova e adicione de novo a entrada do servidor.

mcp-remote (iOS / LAN)

Para clientes apenas stdio (como o Claude Desktop) que não podem se conectar por HTTP diretamente. Requer Node.js no Mac que executa o cliente.

  1. Inicie o servidor no iPhone e copie o endpoint e o token
  2. No seu Mac, selecione mcp-remote (iOS / LAN) na tela Servidor e copie o snippet JSON, ou cole-o na configuração MCP do cliente (Claude Desktop → Ajustes → Desenvolvedor → Editar configuração):
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

Quando o HTTPS estiver ativado:

  1. Exporte a CA do iPhone e confie nela no Acesso às Chaves (Sempre confiar) no seu Mac
  2. Use https://192.168.1.42:9000/mcp em args
  3. Para as versões do Node com suporte pela configuração gerada acima, adicione este objeto env ao mesmo objeto de configuração do servidor:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Em Node mais antigo, defina NODE_EXTRA_CA_CERTS para um caminho PEM legível. Reinicie o cliente stdio após atualizar a configuração.

Argumentos das ferramentas

Formatos de data

Os parâmetros start e end aceitam dois formatos:

Formato Exemplo Notas
yyyy-MM-dd 2026-06-13 Data de início: meia-noite; data de fim: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Hora e deslocamento de fuso horário explícitos

TCP

  • JSON-RPC sem criptografia e sem autenticação na porta 9000
  • Use o contrato v1.0.0 com o bridge Node health-auto-export-mcp-server para os nomes de ferramentas legados
  • Use o contrato v1.1.0 para nomes de ferramentas TCP get_* (atualize o bridge Node separadamente)

Dicas

  1. Mantenha o Health Auto Export em primeiro plano no iPhone enquanto houver clientes conectados
  2. Regenere o token se suspeitar que ele foi exposto
  3. Copie novamente a URL do endpoint depois que o IP LAN do seu iPhone mudar

Obter ajuda

Consulte Obter ajuda para envios de suporte e Registros de eventos do app para exportações de diagnóstico.