Palvelinyhteys

MCP-palvelin iOS:ssä antaa AI-asiakkaille ja skripteille paikallisverkossasi mahdollisuuden kysellä terveystietojasi. HTTP (Streamable MCP) on suositeltu siirto. iOS tukee myös TCP:tä Node-sillan asetukseen.

Asiakkaat toimivat Macissasi tai muissa saman verkon laitteissa ja yhdistävät iPhonessa näytettyyn päätepisteeseen.

Yleiskatsaus

Siirto	Päätepiste
HTTP (suositeltu)	http://{LAN_IP}:9000/mcp (tai https://, kun HTTPS on päällä)
TCP	{LAN_IP}:9000 (ei todennusta)

Korvaa {LAN_IP} Palvelin-näytöllä näkyvällä osoitteella palvelimen ollessa käynnissä.

Käyttötapaukset:

• Yhdistä Claude Code, Codex, Cursor tai VS Code Macissa iPhonen terveystietoihin
• Käytä mcp-remote (iOS / LAN) vain stdio-asiakkaille, esimerkiksi Claude Desktop
• Kysy mittareita ja treenejä skripteistä paikallisverkossasi (HTTP)
• TCP-integraatio Node-sillan kautta health-auto-export-mcp-server

Edellytykset

• Health Auto Export iPhonessa (sovelluksen on pysyttävä etualalla, kun asiakkaat on yhdistetty)
• Premium-tilaus
• HTTP: Bearer-token Palvelin-näytöltä
• Paikallisverkko-käyttöoikeus iPhonessa
• Asiakaslaite: Sama Wi‑Fi tai LAN kuin iPhone; Node.js vain jos käytät mcp-remote (iOS / LAN)

Palvelimen käynnistäminen

1. iPhonessa avaa Palvelin Vie-välilehdeltä. iPadissa käytä sivupalkkia.
2. Valitse HTTP (suositeltu) tai TCP
3. Ota valinnaisesti käyttöön Käytä HTTPS (ohjeet alla)
4. Napauta Käynnistä palvelin
5. Kopioi päätepisteen URL ja bearer-token

Aktiivinen palvelin pysähtyy automaattisesti, jos Health Auto Export siirretään taustalle, käytitpä HTTP:tä tai TCP:tä.

Todennus (HTTP)

Kaikki HTTP-pyynnöt edellyttävät:

Authorization: Bearer <your-token>

• Luo token tarvittaessa uudelleen Palvelin-näytöltä
• Tavallisessa HTTP:ssä token lähetetään salaamattoman yhteyden yli — käytä vain luotetuissa verkoissa tai ota HTTPS käyttöön
• Legacy TCP:llä ei ole todennusta (ei muutosta)

HTTPS (TLS)

HTTPS käyttää paikallisesti generoitua varmenteen myöntäjää (CA). Ennen https://-yhteyttä vie ja luota sen varmenteeseen kullakin asiakaslaitteella.

HTTPS:n käyttöönotto

1. Avaa Palvelin-näkymä (iPhone: Vie-välilehti; iPad: sivupalkki)
2. Ota käyttöön Käytä HTTPS
3. Napauta Vie CA-varmenne ja siirrä CA-tiedosto AirDropilla tai tallentamalla kullekin asiakaslaitteelle
4. Käynnistä palvelin — varmista, että päätepisteen URL vaihtuu https://-muotoon

CA:han luottaminen asiakkaissa

Luota vietyyn CA:han laitteella, jossa AI-asiakas toimii (yleensä Macisi):

1. Vie CA Palvelin-näytöltä iPhonessa
2. Avaa PEM Avainnipussa asiakas-Macissa
3. Aseta Luottamus → Luota aina

Node-versiot generoidulle asetukselle

Sovelluksen generoitu Node-sillan asetus käyttää NODE_OPTIONS=--use-system-ca näille Node-versioille:

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

Vanhemmassa Nodessa aseta sen sijaan NODE_EXTRA_CA_CERTS PEM-polkuun, jonka sillan prosessi voi lukea. --use-system-ca-lipun käyttäminen tukemattomassa Nodessa estää prosessin käynnistymisen.

Luottamuksen laajuus: --use-system-ca luottaa koko järjestelmän Avainnippuun, ei vain tämän sovelluksen CA:han. NODE_EXTRA_CA_CERTS lisää viedyn CA:n Noden luotettuihin varmenteisiin. Katso Node certificate options.

Asiakastyyppi	Asetus
Cursor, VS Code, Claude Code, Codex	Luottamus Avainnipussa asiakas-Macissa — käytä Palvelin-näytön https://-päätepistettä
mcp-remote (iOS / LAN)	Luota CA:han Macin Avainnipussa, jossa mcp-remote toimii. Ote käyttää NODE_OPTIONS=--use-system-ca, kun Node täyttää vähimmäisversion; vanhemmassa Nodessa aseta NODE_EXTRA_CA_CERTS luettavaan PEM-polkuun
curl / skriptit	Välitä --cacert /path/to/mcp-ca.pem tai aseta NODE_EXTRA_CA_CERTS

CA:n sormenjälki näytetään Palvelin-näytöllä, jotta voit varmistaa vienesi oikean varmenteen.

iOS LAN IP -muutokset

Jos iPhonen verkko-osoite muuttuu, kopioi päätepisteen URL uudelleen. Jos korvaava CA-varmenne myönnetään, vie se ja päivitä luottamus kullakin asiakaslaitteella.

Esimerkki HTTPS-päätepisteestä

https://192.168.1.42:9000/mcp

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

Sopimusversio

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

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

Asiakkaan määritys

Palvelin-näyttö sisältää kopioitavia otteita kullekin integraatiolle. Käytä siellä näytettyä päätepistettä ja tokenia. Vahvista muodot asiakasversion mukaan.

Kaikki alla olevat esimerkit käyttävät paikkamerkki-LAN-osoitetta — korvaa se iPhonen osoitteella Palvelin-näytöltä.

Claude Code (CLI)

Suorita Macissa (edellyttää Claude Code CLI:tä):

HTTP:

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

HTTPS (CA:n viennin ja luottamuksen jälkeen Macissa):

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 yhdistää suoraan Streamable HTTP:n kautta — Node.js-siltaa ei tarvita. Määritys sijaitsee tiedostossa ~/.codex/config.toml (globaali) tai .codex/config.toml luotetussa projektikansiossa.

CLI (suositeltu):

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 määritys (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äynnistystä. Asetuksen jälkeen suorita /mcp Codex-istunnossa vahvistaaksesi, että palvelin on yhdistetty.

Jos generoit 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-asiakkaille (esimerkiksi Claude Desktop), jotka eivät voi yhdistää suoraan HTTP:llä. Edellyttää Node.js:ää Macissa, jossa asiakas toimii.

1. Käynnistä palvelin iPhonessa ja kopioi päätepiste sekä token
2. Macissa valitse mcp-remote (iOS / LAN) Palvelin-näytöllä ja kopioi JSON-ote, 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 päällä:

1. Vie CA iPhonesta ja luota siihen Avainnipussa (Luota aina) Macissa
2. Käytä https://192.168.1.42:9000/mcp args-taulukossa
3. Yllä tuetuille Node-versioille lisää tämä env-objekti samaan palvelimen määritysobjektiin:

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

Vanhemmassa Nodessa aseta sen sijaan NODE_EXTRA_CA_CERTS luettavaan PEM-polkuun. Käynnistä stdio-asiakas uudelleen määrityksen päivityksen jälkeen.

Työkaluargumentit

Päivämäärämuodot

Parametrit start ja end 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	Eksplisiittinen aika ja aikavyöhykeoffset

TCP

• Salaamaton, todennukseton JSON-RPC portissa 9000
• Legacy-työkalunimille käytä sopimusta v1.0.0 Node-sillan health-auto-export-mcp-server kanssa
• TCP-työkalunimille get_* käytä sopimusta v1.1.0 (päivitä Node-silta erikseen)

Vinkkejä

1. Pidä Health Auto Export etualalla iPhonessa, kun asiakkaat on yhdistetty
2. Luo token uudelleen, jos epäilet sen paljastuneen
3. Kopioi päätepisteen URL uudelleen iPhonen LAN IP:n muutoksen jälkeen

Apua

Tuen lähettämiseen katso Apua ja diagnostisiin vienteihin Sovellustapahtumalokit.