Centro de ajuda HealthyApps
Português (Portugal)
Centro de ajuda
Site principal ↗

Pesquisar tópicos de ajuda

Ligar ao servidor

Ligue-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 / ficheiro 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 os 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 noutros dispositivos da mesma rede e ligam-se 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 no ecrã Servidor enquanto o servidor estiver em execução.

Casos de utilização:

  • Ligar 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 através do bridge Node health-auto-export-mcp-server

Pré-requisitos

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

Iniciar o servidor

  1. No iPhone, abra Servidor no separador 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 o 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)

Todos os pedidos HTTP exigem:

Authorization: Bearer <your-token>
  • Regenere o token no ecrã Servidor se considerar necessário
  • Em HTTP sem encriptação, o token é enviado por uma ligação não encriptada—use apenas em redes fidedignas 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 ligar por https://.

Ativar o HTTPS

  1. Abra a vista Servidor (iPhone: separador Exportar; iPad: barra lateral)
  2. Ative Usar HTTPS
  3. Toque em Exportar certificado CA e use a folha de partilha para AirDrop ou guardar o ficheiro CA em cada dispositivo cliente
  4. Inicie o servidor — confirme que o 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 do ecrã Servidor no iPhone
  2. Abra o PEM no Acesso às Chaves no Mac cliente
  3. Defina Confiança → Confiar sempre

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

A configuração gerada do bridge Node da aplicação 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.

Âmbito da confiança: --use-system-ca confia no Keychain completo do sistema, não apenas na CA desta aplicação. NODE_EXTRA_CA_CERTS adiciona a CA exportada aos certificados fidedignos 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:// do ecrã 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 no ecrã Servidor para que possa verificar se exportou o certificado correto.

Alterações de IP LAN do iOS

Copie novamente o 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 no ecrã Servidor.

Versão do contrato

Versão Nomes das ferramentas TCP Notas
v1.1.0 (predefiniçã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 usa sempre nomes de ferramentas get_*; a versão do contrato afeta apenas as predefinições do esquema.

Configuração do cliente

O ecrã 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 no ecrã 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 / ficheiro 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 liga-se 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 num diretório de projeto fidedigno.

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á ligado.

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 se podem ligar 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) no ecrã Servidor e copie o snippet JSON, ou cole-o na configuração MCP do cliente (Claude Desktop → Definições → Developer → Edit Config):
{
  "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 (Confiar sempre) 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 encriptação 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 ligados
  2. Regenere o token se suspeitar que foi exposto
  3. Copie novamente o URL do endpoint depois que o IP LAN do seu iPhone mudar

Obter ajuda

Consulte Obter ajuda para envios de suporte e Registos de eventos da aplicação para exportações de diagnóstico.