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
HTTPS (TLS)
HTTPS (TLS) Ativar o HTTPSConfiar na CA nos clientesAlterações de IP LAN do iOSExemplo de endpoint HTTPSConfiguraçã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)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
- No iPhone, abra Servidor no separador Exportar. No iPad, use a barra lateral.
- Escolha HTTP (recomendado) ou TCP
- Opcionalmente, ative Usar HTTPS (instruções abaixo)
- Toque em Iniciar servidor
- 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
- Abra a vista Servidor (iPhone: separador Exportar; iPad: barra lateral)
- Ative Usar HTTPS
- Toque em Exportar certificado CA e use a folha de partilha para AirDrop ou guardar o ficheiro CA em cada dispositivo cliente
- 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):
- Exporte a CA do ecrã Servidor no iPhone
- Abra o PEM no Acesso às Chaves no Mac cliente
- 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-caconfia no Keychain completo do sistema, não apenas na CA desta aplicação.NODE_EXTRA_CA_CERTSadiciona 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.
- Inicie o servidor no iPhone e copie o endpoint e o token
- 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:
- Exporte a CA do iPhone e confie nela no Acesso às Chaves (Confiar sempre) no seu Mac
- Use
https://192.168.1.42:9000/mcpemargs - Para as versões do Node com suporte pela configuração gerada acima, adicione este objeto
envao 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-serverpara os nomes de ferramentas legados - Use o contrato v1.1.0 para nomes de ferramentas TCP
get_* (atualize o bridge Node separadamente)
Dicas
- Mantenha o Health Auto Export em primeiro plano no iPhone enquanto houver clientes ligados
- Regenere o token se suspeitar que foi exposto
- 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.