Centrum pomocy HealthyApps
Polski
Centrum pomocy
Strona główna ↗

Szukaj tematów pomocy

Połącz z serwerem

Połącz się z serwerem MCP Health Auto Export dla klientów AI i skryptów w sieci lokalnej.

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
PrzeglądWymagania wstępneUruchamianie serweraUwierzytelnianie (HTTP)
HTTPS (TLS) HTTPS (TLS) Włączanie HTTPSZaufanie CA na klientachZmiany adresu IP LAN iOSPrzykładowy punkt końcowy HTTPS
Wersja kontraktu
Konfiguracja klienta Konfiguracja klienta Claude Code (CLI)Claude Code / plik projektu (<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)
Argumenty narzędzi Argumenty narzędzi Formaty dat
TCPWskazówkiUzyskaj pomoc

Serwer MCP na iOS pozwala klientom AI i skryptom w sieci lokalnej odpytywać Twoje dane zdrowotne. HTTP (Streamable MCP) jest zalecanym transportem. iOS obsługuje też TCP w konfiguracjach mostu Node.

Klienci działają na Macu lub innych urządzeniach w tej samej sieci i łączą się z punktem końcowym pokazanym na iPhonie.

Przegląd

Transport Punkt końcowy
HTTP (zalecany) http://{LAN_IP}:9000/mcp (lub https://, gdy HTTPS jest włączony)
TCP {LAN_IP}:9000 (bez uwierzytelniania)

Zastąp {LAN_IP} adresem pokazanym na ekranie Serwer, gdy serwer działa.

Zastosowania:

  • Połącz Claude Code, Codex, Cursor lub VS Code na Macu z danymi zdrowotnymi na iPhonie
  • Użyj mcp-remote (iOS / LAN) dla klientów tylko stdio, takich jak Claude Desktop
  • Odpytuj metryki i treningi ze skryptów w sieci lokalnej (HTTP)
  • Integracje TCP przez most Node health-auto-export-mcp-server

Wymagania wstępne

  • Health Auto Export na iPhonie (aplikacja musi pozostać na pierwszym planie, gdy klienci są podłączeni)
  • Subskrypcja Premium
  • HTTP: token Bearer z ekranu Serwer
  • Uprawnienie Sieć lokalna na iPhonie
  • Urządzenie klienta: ta sama sieć Wi‑Fi lub LAN co iPhone; Node.js tylko jeśli używasz mcp-remote (iOS / LAN)

Uruchamianie serwera

  1. Na iPhonie otwórz Serwer z karty Eksport. Na iPadzie użyj paska bocznego.
  2. Wybierz HTTP (zalecane) lub TCP
  3. Opcjonalnie włącz Użyj HTTPS (instrukcje poniżej)
  4. Stuknij Uruchom serwer
  5. Skopiuj URL punktu końcowego i token Bearer

Aktywny serwer zatrzymuje się automatycznie, gdy Health Auto Export trafia do tła, niezależnie od tego, czy używasz HTTP, czy TCP.

Uwierzytelnianie (HTTP)

Wszystkie żądania HTTP wymagają:

Authorization: Bearer <your-token>
  • W razie potrzeby wygeneruj token ponownie z ekranu Serwer
  • Przy zwykłym HTTP token jest wysyłany przez nieszyfrowane połączenie — używaj tylko w zaufanych sieciach albo włącz HTTPS
  • Legacy TCP nie ma uwierzytelniania (bez zmian)

HTTPS (TLS)

HTTPS używa lokalnie wygenerowanego urzędu certyfikacji (CA). Wyeksportuj i zaufaj jego certyfikatowi na każdym urządzeniu klienta przed połączeniem przez https://.

Włączanie HTTPS

  1. Otwórz widok Serwer (iPhone: karta Eksport; iPad: pasek boczny)
  2. Włącz Użyj HTTPS
  3. Stuknij Eksportuj certyfikat CA i użyj arkusza udostępniania, aby wysłać przez AirDrop lub zapisać plik CA na każdym urządzeniu klienta
  4. Uruchom serwer — upewnij się, że URL punktu końcowego przełącza się na https://

Zaufanie CA na klientach

Zaufaj wyeksportowanemu CA na urządzeniu uruchamiającym klienta AI (zwykle Mac):

  1. Wyeksportuj CA z ekranu Serwer na iPhonie
  2. Otwórz plik PEM w Dostępie do pęku kluczy na Macu klienta
  3. Ustaw Zaufanie → Zawsze ufaj

Wersje Node dla wygenerowanej konfiguracji

Wygenerowana przez aplikację konfiguracja mostu Node używa NODE_OPTIONS=--use-system-ca dla tych wersji Node:

Linia Node Minimalna wersja
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ dowolna

Na starszym Node ustaw zamiast tego NODE_EXTRA_CA_CERTS na ścieżkę PEM, którą proces mostu może odczytać. Emisja --use-system-ca na nieobsługiwanym Node uniemożliwia uruchomienie procesu.

Zakres zaufania: --use-system-ca ufa całemu systemowemu pękowi kluczy, nie tylko CA tej aplikacji. NODE_EXTRA_CA_CERTS dodaje wyeksportowane CA do zaufanych certyfikatów Node. Zobacz opcje certyfikatów Node.

Typ klienta Konfiguracja
Cursor, VS Code, Claude Code, Codex Zaufanie w pęku kluczy na Macu klienta — użyj punktu końcowego https:// z ekranu Serwer
mcp-remote (iOS / LAN) Zaufaj CA w Dostępie do pęku kluczy na Macu uruchamiającym mcp-remote. Fragment używa NODE_OPTIONS=--use-system-ca, gdy Node spełnia minimalną wersję; na starszym Node ustaw NODE_EXTRA_CA_CERTS na odczytywalną ścieżkę PEM
curl / skrypty Przekaż --cacert /path/to/mcp-ca.pem albo ustaw NODE_EXTRA_CA_CERTS

Odcisk CA jest pokazany na ekranie Serwer, abyś mógł potwierdzić, że wyeksportowałeś właściwy certyfikat.

Zmiany adresu IP LAN iOS

Skopiuj ponownie URL punktu końcowego, jeśli adres sieciowy iPhone’a się zmieni. Jeśli zostanie dostarczony zastępczy certyfikat CA, wyeksportuj go i zaktualizuj zaufanie na każdym urządzeniu klienta.

Przykładowy punkt końcowy HTTPS

https://192.168.1.42:9000/mcp

Zastąp host wartością pokazaną na ekranie Serwer.

Wersja kontraktu

Wersja Nazwy narzędzi TCP Uwagi
v1.1.0 (domyślna) get_* Zalecana dla nowych konfiguracji
v1.0.0 Legacy (health_metrics, …) Aktualizacja zgodności Claude Desktop v1.0.0
v0.0.1 Legacy Najstarsza zgodność

HTTP zawsze używa nazw narzędzi get_*; wersja kontraktu wpływa tylko na domyślne schematy.

Konfiguracja klienta

Ekran Serwer zawiera fragmenty do skopiowania dla każdej integracji. Użyj punktu końcowego i tokenu pokazanych tam. Zweryfikuj formaty względem wersji klienta.

Wszystkie przykłady poniżej używają zastępczego adresu LAN — podstaw adres iPhone’a z ekranu Serwer.

Claude Code (CLI)

Uruchom na Macu (wymaga CLI Claude Code):

HTTP:

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

HTTPS (po wyeksportowaniu CA i nadaniu mu zaufania na Macu):

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

Claude Code / plik projektu (.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 łączy się bezpośrednio przez Streamable HTTP — most Node.js nie jest wymagany. Konfiguracja znajduje się w ~/.codex/config.toml (globalna) lub .codex/config.toml w zaufanym katalogu projektu.

CLI (zalecane):

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

Konfiguracja ręczna (config.toml):

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

Wyeksportuj HAE_MCP_TOKEN z tokenem Bearer przed uruchomieniem Codex. Po konfiguracji uruchom /mcp w sesji Codex, aby potwierdzić połączenie serwera.

Jeśli wygenerujesz ponownie token Bearer w Health Auto Export, zaktualizuj HAE_MCP_TOKEN i ponownie uruchom codex mcp add albo usuń i dodaj ponownie wpis serwera.

mcp-remote (iOS / LAN)

Dla klientów tylko stdio (takich jak Claude Desktop), które nie mogą łączyć się bezpośrednio przez HTTP. Wymaga Node.js na Macu uruchamiającym klienta.

  1. Uruchom serwer na iPhonie i skopiuj punkt końcowy oraz token
  2. Na Macu wybierz mcp-remote (iOS / LAN) na ekranie Serwer i skopiuj fragment JSON albo wklej to do konfiguracji MCP klienta (Claude Desktop → Ustawienia → Deweloper → Edytuj konfigurację):
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

Gdy HTTPS jest włączony:

  1. Wyeksportuj CA z iPhone’a i zaufaj mu w Dostępie do pęku kluczy (Zawsze ufaj) na Macu
  2. Użyj https://192.168.1.42:9000/mcp w args
  3. Dla wersji Node obsługiwanych przez wygenerowaną konfigurację powyżej dodaj ten obiekt env do tego samego obiektu konfiguracji serwera:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Na starszym Node ustaw zamiast tego NODE_EXTRA_CA_CERTS na odczytywalną ścieżkę PEM. Uruchom ponownie klienta stdio po aktualizacji konfiguracji.

Argumenty narzędzi

Formaty dat

Parametry start i end przyjmują dwa formaty:

Format Przykład Uwagi
yyyy-MM-dd 2026-06-13 Data początkowa: północ; data końcowa: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Jawny czas i przesunięcie strefy czasowej

TCP

  • Nieszyfrowany, nieuwierzytelniony JSON-RPC na porcie 9000
  • Użyj kontraktu v1.0.0 z mostem Node health-auto-export-mcp-server dla legacy nazw narzędzi
  • Użyj kontraktu v1.1.0 dla nazw narzędzi TCP get_* (zaktualizuj most Node osobno)

Wskazówki

  1. Trzymaj Health Auto Export na pierwszym planie na iPhonie, gdy klienci są podłączeni
  2. Wygeneruj ponownie token, jeśli podejrzewasz, że został ujawniony
  3. Skopiuj ponownie URL punktu końcowego po zmianie adresu IP LAN iPhone’a

Uzyskaj pomoc

Zobacz Uzyskaj pomoc w sprawie zgłoszeń wsparcia oraz Dzienniki zdarzeń aplikacji w sprawie eksportów diagnostycznych.