Palvelinyhteyden opas

iOS-laitteella toimiva MCP-palvelin antaa paikallisverkkosi tekoälyasiakkaille ja skripteille mahdollisuuden hakea terveystietojasi. HTTP (Streamable MCP) on suositeltu siirtotapa. iOS tukee myös TCP-yhteyttä Node-siltaa käyttäville asetuksille.

Asiakkaat toimivat Macilläsi tai muilla samassa verkossa olevilla laitteilla ja muodostavat yhteyden iPhonessa näytettyyn päätepisteeseen.

Yleiskatsaus

Siirtotapa	Päätepiste
HTTP (suositus)	http://{LAN_IP}:9000/mcp (tai https://, kun HTTPS on käytössä)
TCP	{LAN_IP}:9000 (ei todennusta)

Korvaa {LAN_IP} osoitteella, joka näkyy Server-näytöllä palvelimen ollessa käynnissä.

Käyttötapauksia:

• Yhdistä Claude Code, Codex, Cursor tai VS Code Macilläsi iPhonessa oleviin terveystietoihin
• Käytä mcp-remote (iOS / LAN) -toimintoa vain stdio:ta tukeville asiakkaille, kuten Claude Desktop
• Hae mittareita ja harjoituksia skripteillä paikallisverkossasi (HTTP)
• TCP-integraatiot health-auto-export-mcp-server-Node-sillan kautta

Vaatimukset

• Health Auto Export iPhonessa (sovelluksen on pysyttävä etualalla, kun asiakkaita on yhdistettynä)
• Premium-tilaus
• HTTP: Bearer-token Server-näytöltä
• Paikallisverkko-käyttöoikeus iPhonessa
• Asiakaslaite: Samassa Wi-Fi- tai lähiverkossa kuin iPhone; Node.js tarvitaan vain, jos käytät mcp-remote (iOS / LAN) -toimintoa

Palvelimen käynnistäminen

1. Avaa iPhonessa Server sivupalkin navigoinnin kautta
2. Valitse HTTP (suositus) tai TCP
3. Ota halutessasi käyttöön Use HTTPS (ohjeet alla)
4. Napauta Start Server
5. Kopioi päätepisteen URL-osoite ja bearer-token

Palvelin pysähtyy automaattisesti, jos Health Auto Export siirtyy taustalle (koskee sekä HTTP- että TCP-yhteyttä).

Todennus (HTTP)

Kaikki HTTP-pyynnöt vaativat:

Authorization: Bearer <your-token>

• Luo token uudelleen Server-näytöllä, jos katsot sen tarpeelliseksi
• Tavallisessa HTTP-yhteydessä token lähetetään salaamattoman yhteyden yli — käytä vain luotetuissa verkoissa tai ota käyttöön HTTPS
• Vanhassa TCP-yhteydessä ei ole todennusta (ei muuttunut)

HTTPS (TLS)

Kun Use HTTPS on käytössä, sovellus luo yksityisen paikallisen varmentajan (CA) ja tämän CA:n allekirjoittaman palvelimen varmenteen. Asiakkaiden on luotettava vietyyn CA:han, ennen kuin ne voivat muodostaa yhteyden https://-osoitteen kautta.

HTTPS:n käyttöönotto

1. Avaa Server-näkymä sivupalkin navigoinnin kautta
2. Kytke Use HTTPS päälle
3. Napauta Export CA Certificate ja lähetä CA-tiedosto jakovalikon avulla AirDropilla tai tallenna se kullekin asiakaslaitteelle
4. Käynnistä palvelin — varmista, että päätepisteen URL-osoite vaihtuu https://-muotoon

CA:han luottaminen asiakaslaitteissa

Luota vietyyn CA:han laitteessa, jossa tekoälyasiakas toimii (yleensä Macisi):

1. Vie CA Server-näytöltä iPhonessa
2. Avaa PEM-tiedosto Keychain Accessissa asiakas-Macilla
3. Aseta Trust → Always Trust

Vähimmäis-Node-versio --use-system-ca-asetukselle

Node-sillat (mcp-remote) voivat käyttää NODE_OPTIONS=--use-system-ca-asetusta vain, kun Node täyttää seuraavat vaatimukset:

Node-sarja	Vähimmäisversio
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	mikä tahansa

Vanhemmissa Node-versioissa aseta sen sijaan NODE_EXTRA_CA_CERTS osoittamaan PEM-poluun, jonka siltaprosessi voi lukea. --use-system-ca-asetuksen käyttö tuetulla Node-versiolla estää prosessin käynnistymisen.

Luottamuksen laajuus: --use-system-ca luottaa koko järjestelmän avainnippuun (Keychain), ei vain tämän sovelluksen CA:han. NODE_EXTRA_CA_CERTS rajaa luottamuksen yhteen PEM-tiedostoon (varajärjestelmä vanhemmille Node-versioille). Kytkin on dokumentoitu macOS/Windows-järjestelmille.

Asiakastyyppi	Määritys
Cursor, VS Code, Claude Code, Codex	Keychain-luottamus asiakas-Macilla — käytä https://-päätepistettä Server-näytöltä
mcp-remote (iOS / LAN)	Luota CA:han Keychainissa Macilla, jolla mcp-remote toimii. Katkelma käyttää NODE_OPTIONS=--use-system-ca-asetusta, kun Node täyttää vähimmäisversion; vanhemmissa Node-versioissa aseta NODE_EXTRA_CA_CERTS luettavaan PEM-polkuun
curl / skriptit	Anna --cacert /path/to/mcp-ca.pem tai aseta NODE_EXTRA_CA_CERTS

CA:n sormenjälki näkyy Server-näytöllä, jotta voit varmistaa viestäneesi oikean varmenteen.

iOS:n lähiverkon IP-osoitteen muutokset

Kun iPhonesi lähiverkon IP-osoite muuttuu, sovellus luo palvelimen varmenteen uudelleen päivitetyillä Subject Alternative Names -tiedoilla ja käynnistää HTTPS-kuuntelijan uudelleen. Kopioi päätepisteen URL-osoite uudelleen, jos IP muuttui. CA-varmenne pysyy samana, ellet luo sitä uudelleen kytkemällä HTTPS:n pois päältä ja sitten takaisin päälle.

Esimerkki HTTPS-päätepisteestä

https://192.168.1.42:9000/mcp

Korvaa isäntä Server-näytöllä näkyvällä arvolla.

Sopimusversio

Versio	TCP-työkalujen nimet	Huomiot
v1.1.0 (oletus)	get_*	Suositellaan uusiin asetuksiin
v1.0.0	Vanha (health_metrics, …)	Claude Desktop -yhteensopivuuspäivitys v1.0.0
v0.0.1	Vanha	Vanhin yhteensopivuus

HTTP käyttää aina get_*-työkalujen nimiä; sopimusversio vaikuttaa vain skeeman oletusarvoihin.

Asiakkaan määritys

Server-näytöllä on kopioitavia katkelmia kutakin integraatiota varten. Käytä siellä näkyvää päätepistettä ja tokenia. Tarkista muodot asiakasversiosi mukaan.

Kaikissa alla olevissa esimerkeissä käytetään paikkamerkkinä lähiverkon osoitetta — korvaa se iPhonesi osoitteella Server-näytöltä.

Claude Code (CLI)

Suorita Macilläsi (vaatii Claude Code -CLI:n):

HTTP:

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

HTTPS (kun CA on viety ja siihen on luotettu Macilläsi):

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

Claude Code / projektitiedosto (.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 muodostaa yhteyden Streamable HTTP:n kautta suoraan — Node.js-siltaa ei tarvita. Määritys sijaitsee tiedostossa ~/.codex/config.toml (yleinen) tai .codex/config.toml luotetussa projektihakemistossa.

CLI (suositus):

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

Manuaalinen config.toml:

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

Vie HAE_MCP_TOKEN bearer-tokenillasi ennen Codexin käynnistämistä. Kun asetus on tehty, suorita /mcp Codex-istunnossa varmistaaksesi, että palvelin on yhdistetty.

Jos luot bearer-tokenin uudelleen Health Auto Exportissa, päivitä HAE_MCP_TOKEN ja suorita codex mcp add uudelleen, tai poista ja lisää palvelinmerkintä uudelleen.

mcp-remote (iOS / LAN)

Vain stdio:ta tukeville asiakkaille (kuten Claude Desktop), jotka eivät voi muodostaa yhteyttä HTTP:n kautta suoraan. Vaatii Node.js:n Macilla, jolla asiakas toimii.

1. Käynnistä palvelin iPhonessa ja kopioi päätepiste ja token
2. Valitse Macilläsi mcp-remote (iOS / LAN) Server-näytöllä ja kopioi JSON-katkelma, tai liitä se asiakkaan MCP-määritykseen (Claude Desktop → Settings → 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>"
  ]
}

Kun HTTPS on käytössä:

1. Vie CA iPhonesta ja luota siihen Keychain Accessissa (Always Trust) Macilläsi
2. Käytä https://192.168.1.42:9000/mcp-osoitetta args-kohdassa
3. Kun Node täyttää --use-system-ca-asetuksen vähimmäisversion (22.19.0 sarjassa 22.x, 23.8.0 sarjassa 23.x, 24.6.0 sarjassa 24.x, tai mikä tahansa 25+ julkaisu), lisää:

"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

Vanhemmissa Node-versioissa aseta sen sijaan NODE_EXTRA_CA_CERTS luettavaan PEM-polkuun. Käynnistä stdio-asiakas uudelleen määrityksen päivittämisen jälkeen.

Käynnistysviiveen pienentäminen: npx -y lataa mcp-remote-paketin ensimmäisellä käyttökerralla ja tarkistaa sen uudelleen välimuistin vanhenemisen yhteydessä, mikä voi aiheuttaa usean sekunnin viiveitä. Yleinen esiasennus poistaa tämän:

npm install -g mcp-remote@0.1.16

Työkalujen argumentit

Päivämäärämuodot

start- ja end-parametrit hyväksyvät kaksi muotoa:

Muoto	Esimerkki	Huomiot
yyyy-MM-dd	2026-06-13	Alkupäivä: keskiyö; loppupäivä: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Selkeä aika ja aikavyöhykkeen poikkeama

TCP

• Salaamaton, todentamaton JSON-RPC portissa 9000
• Käytä v1.0.0-sopimusta Node health-auto-export-mcp-server -sillan kanssa vanhoja työkalunimiä varten
• Käytä v1.1.0-sopimusta get_*-TCP-työkalunimiä varten (päivitä Node-silta erikseen)

Vinkkejä

1. Pidä Health Auto Export etualalla iPhonessa, kun asiakkaita on yhdistettynä
2. Luo token uudelleen, jos epäilet sen paljastuneen
3. Kopioi päätepisteen URL-osoite uudelleen sen jälkeen, kun iPhonesi lähiverkon IP-osoite on muuttunut

Chat-tuki

Kerää diagnostiikkaa vientisovelluksen tapahtumalokeista siirtymällä Settings → Advanced → Export Event Logs. Katso Sovelluksen tapahtumalokien opas. Jaa luotu zip-tiedosto Chat-tuen tai sähköpostin kautta.