Anslut till server
Anslut till Health Auto Export MCP-servern för AI-klienter och skript på ditt lokala nätverk.
Senast uppdaterad: 31 oktober 2026
På denna sida
HTTPS (TLS)
HTTPS (TLS) Aktivera HTTPSLita på CA:n på klienterÄndringar i iOS LAN-IPExempel på HTTPS-slutpunktKlientkonfiguration
Klientkonfiguration Claude Code (CLI)Claude Code / projektfil (<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)MCP-servern på iOS låter AI-klienter och skript på ditt lokala nätverk fråga dina hälsodata. HTTP (Streamable MCP) är den rekommenderade transporten. iOS stöder också TCP för Node-bridge-konfigurationer.
Klienter körs på din Mac eller andra enheter på samma nätverk och ansluter till den slutpunkt som visas på din iPhone.
Översikt
| Transport | Slutpunkt |
|---|---|
| HTTP (rekommenderas) | http://{LAN_IP}:9000/mcp (eller https:// när HTTPS är aktiverat) |
| TCP | {LAN_IP}:9000 (utan autentisering) |
Ersätt {LAN_IP} med den adress som visas på skärmen Server medan servern körs.
Användningsområden:
- Anslut Claude Code, Codex, Cursor eller VS Code på din Mac till hälsodata på din iPhone
- Använd mcp-remote (iOS / LAN) för klienter som bara stöder stdio, såsom Claude Desktop
- Fråga mått och träningspass från skript på ditt lokala nätverk (HTTP)
- TCP-integrationer via Node-bridge health-auto-export-mcp-server
Förutsättningar
- Health Auto Export på iPhone (appen måste förbli i förgrunden medan klienter är anslutna)
- Premiumabonnemang
- HTTP: Bearer-token från Server-skärmen
- Behörighet för Lokalt nätverk på iPhone
- Klientenhet: Samma Wi‑Fi eller LAN som iPhone; Node.js bara om du använder mcp-remote (iOS / LAN)
Starta servern
- Öppna på iPhone Server från fliken Exportera. På iPad använder du sidofältet.
- Välj HTTP (rekommenderas) eller TCP
- Aktivera valfritt Använd HTTPS (guide nedan)
- Tryck på Starta server
- Kopiera slutpunkts-URL:en och bearer-tokenet
Den aktiva servern stoppas automatiskt om Health Auto Export skickas till bakgrunden, oavsett om du använder HTTP eller TCP.
Autentisering (HTTP)
Alla HTTP-förfrågningar kräver:
Authorization: Bearer <your-token>
- Generera tokenet igen från Server-skärmen om det behövs
- På vanlig HTTP skickas tokenet över en okrypterad anslutning—använd det bara på betrodda nätverk, eller aktivera HTTPS
- TCP legacy har ingen autentisering (oförändrat)
HTTPS (TLS)
HTTPS använder en lokalt genererad Certificate Authority (CA). Exportera och lita på dess certifikat på varje klientenhet innan du ansluter via https://.
Aktivera HTTPS
- Öppna vyn Server (iPhone: fliken Exportera; iPad: sidofält)
- Slå på Använd HTTPS
- Tryck på Exportera CA-certifikat och använd delningsbladet för att AirDrop:a eller spara CA-filen på varje klientenhet
- Starta servern — se till att slutpunkts-URL:en byter till
https://
Lita på CA:n på klienter
Lita på den exporterade CA:n på den enhet som kör AI-klienten (vanligtvis din Mac):
- Exportera CA:n från Server-skärmen på iPhone
- Öppna PEM-filen i Nyckelhanterare på klient-Mac
- Ställ in Tillit → Lita alltid på
Node-versioner för den genererade konfigurationen
Appens genererade Node-bridge-konfiguration använder NODE_OPTIONS=--use-system-ca för dessa Node-versioner:
| Node-linje | Minimiversion |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | vilken som helst |
På äldre Node anger du i stället NODE_EXTRA_CA_CERTS till en PEM-sökväg som bridge-processen kan läsa. Att skicka --use-system-ca på icke stödd Node hindrar processen från att starta.
Tillitsomfattning:
--use-system-calitar på hela systemnyckelringen, inte bara den här appens CA.NODE_EXTRA_CA_CERTSlägger till den exporterade CA:n till Nodes betrodda certifikat. Se Node-certifikatinställningar.
| Klienttyp | Konfiguration |
|---|---|
| Cursor, VS Code, Claude Code, Codex | Nyckelringstillit på klient-Mac — använd https://-slutpunkten från Server-skärmen |
| mcp-remote (iOS / LAN) | Lita på CA i Nyckelhanterare på den Mac som kör mcp-remote. Snippet använder NODE_OPTIONS=--use-system-ca när Node uppfyller minimiversionen; på äldre Node anger du NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg |
| curl / skript | Skicka --cacert /path/to/mcp-ca.pem, eller ange NODE_EXTRA_CA_CERTS |
CA-fingeravtrycket visas på Server-skärmen så att du kan bekräfta att du exporterade rätt certifikat.
Ändringar i iOS LAN-IP
Kopiera slutpunkts-URL:en igen om din iPhones nätverksadress ändras. Om ett ersättnings-CA-certifikat tillhandahålls exporterar du det och uppdaterar tilliten på varje klientenhet.
Exempel på HTTPS-slutpunkt
https://192.168.1.42:9000/mcp
Ersätt värden med det värde som visas på Server-skärmen.
Kontraktversion
| Version | TCP-verktygsnamn | Anteckningar |
|---|---|---|
| v1.1.0 (standard) | get_* |
Rekommenderas för nya konfigurationer |
| v1.0.0 | Legacy (health_metrics, …) |
Claude Desktop-kompatibilitetsuppdatering v1.0.0 |
| v0.0.1 | Legacy | Äldsta kompatibilitet |
HTTP använder alltid verktygsnamn get_*; kontraktversionen påverkar bara schemastandarder.
Klientkonfiguration
Server-skärmen innehåller copy-paste-snippets för varje integration. Använd den slutpunkt och token som visas där. Verifiera format mot din klientversion.
Alla exempel nedan använder en tillfällig LAN-adress—ersätt den med din iPhones adress från Server-skärmen.
Claude Code (CLI)
Kör på din Mac (kräver Claude Code CLI):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS (efter att ha exporterat CA:n och gett den tillit på din Mac):
claude mcp add --transport http health-auto-export \
https://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
Claude Code / projektfil (.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)
Codex ansluter direkt via Streamable HTTP — ingen Node.js-bridge krävs. Konfigurationen ligger i ~/.codex/config.toml (global) eller .codex/config.toml i en betrodd projektmapp.
CLI (rekommenderas):
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
Manuell konfiguration (config.toml):
[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true
Exportera HAE_MCP_TOKEN med ditt bearer-token innan du startar Codex. Kör efter konfiguration /mcp inne i en Codex-session för att bekräfta att servern är ansluten.
Om du regenererar bearer-tokenet i Health Auto Export uppdaterar du HAE_MCP_TOKEN och kör codex mcp add igen, eller tar bort och lägger till serverposten igen.
mcp-remote (iOS / LAN)
För klienter som bara stöder stdio (såsom Claude Desktop), som inte kan ansluta direkt via HTTP. Kräver Node.js på den Mac som kör klienten.
- Starta servern på iPhone och kopiera slutpunkten och tokenet
- Välj på din Mac mcp-remote (iOS / LAN) på Server-skärmen och kopiera JSON-snippetet, eller klistra in detta i klientens MCP-konfiguration (Claude Desktop → Inställningar → Utvecklare → Redigera konfiguration):
{
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.16",
"http://192.168.1.42:9000/mcp",
"--transport",
"http-only",
"--header",
"Authorization: Bearer <token>"
]
}
När HTTPS är aktiverat:
- Exportera CA:n från iPhone och lita på den i Nyckelhanterare (Lita alltid på) på din Mac
- Använd
https://192.168.1.42:9000/mcpiargs - För Node-versioner som stöds av den genererade konfigurationen ovan lägger du till detta
env-objekt i samma serverkonfigurationsobjekt:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
På äldre Node anger du i stället NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg. Starta om stdio-klienten efter att ha uppdaterat konfigurationen.
Verktygsargument
Datumformat
Parametrarna start och end accepterar två format:
| Format | Exempel | Anteckningar |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
Startdatum: midnatt; slutdatum: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
Explicit tid och tidszonsförskjutning |
TCP
- Okrypterad, oauktoriserad JSON-RPC på port 9000
- Använd kontrakt v1.0.0 med Node-bridgen
health-auto-export-mcp-serverför legacy-verktygsnamn - Använd kontrakt v1.1.0 för TCP-verktygsnamn
get_* (uppdatera Node-bridgen separat)
Tips
- Håll Health Auto Export i förgrunden på iPhone medan klienter är anslutna
- Generera tokenet igen om du misstänker att det har exponerats
- Kopiera slutpunkts-URL:en igen efter att din iPhones LAN-IP ändras
Få hjälp
Se Få hjälp för supportinskick och App-händelseloggar för diagnostiska exporter.