Przewodnik dotyczący połączenia z serwerem

Serwer MCP na iOS umożliwia klientom AI i skryptom w Twojej sieci lokalnej odpytywanie Twoich danych zdrowotnych. HTTP (Streamable MCP) jest zalecanym transportem. iOS obsługuje również TCP dla konfiguracji z mostkiem Node.

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

Przegląd

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

Zastąp {LAN_IP} adresem wyświetlanym na ekranie Serwer, gdy serwer jest uruchomiony.

Przypadki użycia:

• 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 obsługujących tylko stdio, takich jak Claude Desktop
• Odpytuj metryki i treningi ze skryptów w Twojej sieci lokalnej (HTTP)
• Integracje TCP za pomocą mostka Node health-auto-export-mcp-server

Wymagania

• Health Auto Export na iPhonie (aplikacja musi pozostać na pierwszym planie, gdy klienci są połączeni)
• Subskrypcja Premium
• HTTP: token Bearer z ekranu Serwer
• Uprawnienie Sieć lokalna na iPhonie
• Urządzenie klienckie: ta sama sieć Wi-Fi lub LAN co iPhone; Node.js tylko w przypadku korzystania z mcp-remote (iOS / LAN)

Uruchamianie serwera

1. Na iPhonie otwórz Serwer za pomocą nawigacji w panelu bocznym
2. Wybierz HTTP (zalecane) lub TCP
3. Opcjonalnie włącz Użyj HTTPS (instrukcje poniżej)
4. Stuknij Uruchom serwer
5. Skopiuj adres URL punktu końcowego i token Bearer

Serwer zatrzymuje się automatycznie, gdy Health Auto Export przechodzi w tło (dotyczy zarówno HTTP, jak i TCP).

Uwierzytelnianie (HTTP)

Wszystkie żądania HTTP wymagają:

Authorization: Bearer <your-token>

• Zregeneruj token z ekranu Serwer, jeśli uznasz to za konieczne
• W przypadku zwykłego HTTP token jest wysyłany przez niezaszyfrowane połączenie — używaj go tylko w zaufanych sieciach lub włącz HTTPS
• Starsze TCP nie ma uwierzytelniania (bez zmian)

HTTPS (TLS)

Gdy Użyj HTTPS jest włączone, aplikacja generuje prywatny lokalny urząd certyfikacji (CA) oraz certyfikat serwera podpisany przez ten CA. Klienci muszą zaufać wyeksportowanemu CA, zanim będą mogli połączyć się przez https://.

Włączanie HTTPS

1. Otwórz widok Serwer za pomocą nawigacji w panelu bocznym
2. Włącz Użyj HTTPS
3. Stuknij Eksportuj certyfikat CA i użyj arkusza udostępniania, aby przesłać plik CA przez AirDrop lub zapisać go na każdym urządzeniu klienckim
4. Uruchom serwer — sprawdź, czy adres URL punktu końcowego zmienia się na https://

Zaufanie do CA na klientach

Zaufaj wyeksportowanemu CA na urządzeniu, na którym działa klient AI (zwykle Twój Mac):

1. Wyeksportuj CA z ekranu Serwer na iPhonie
2. Otwórz plik PEM w Keychain Access na Macu klienckim
3. Ustaw Trust → Always Trust

Minimalna wersja Node dla --use-system-ca

Mostki Node (mcp-remote) mogą używać NODE_OPTIONS=--use-system-ca tylko wtedy, gdy Node spełnia co najmniej:

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

Na starszych wersjach Node ustaw zamiast tego NODE_EXTRA_CA_CERTS na ścieżkę PEM, którą może odczytać proces mostka. Użycie --use-system-ca na nieobsługiwanej wersji Node powoduje, że proces nie może się uruchomić.

Zakres zaufania: --use-system-ca ufa całemu systemowemu Keychain, a nie tylko CA tej aplikacji. NODE_EXTRA_CA_CERTS ogranicza zaufanie do jednego pliku PEM (rozwiązanie zastępcze na starszych wersjach Node). Flaga jest dokumentowana dla macOS/Windows.

Typ klienta	Konfiguracja
Cursor, VS Code, Claude Code, Codex	Zaufanie Keychain na Macu klienckim — użyj punktu końcowego https:// z ekranu Serwer
mcp-remote (iOS / LAN)	Zaufaj CA w Keychain na Macu, na którym działa mcp-remote. Fragment kodu używa NODE_OPTIONS=--use-system-ca, gdy Node spełnia minimalną wersję; na starszych wersjach Node ustaw NODE_EXTRA_CA_CERTS na czytelną ścieżkę PEM
curl / skrypty	Przekaż --cacert /path/to/mcp-ca.pem lub ustaw NODE_EXTRA_CA_CERTS

Odcisk cyfrowy CA jest wyświetlany na ekranie Serwer, dzięki czemu możesz zweryfikować, że wyeksportowałeś poprawny certyfikat.

Zmiany adresu IP LAN na iOS

Gdy adres IP LAN Twojego iPhone'a zmienia się, aplikacja regeneruje certyfikat serwera z zaktualizowanymi Subject Alternative Names i ponownie uruchamia listener HTTPS. Skopiuj ponownie adres URL punktu końcowego, jeśli adres IP się zmienił. Certyfikat CA pozostaje taki sam, o ile nie zregenerujesz go, wyłączając i włączając HTTPS.

Przykładowy punkt końcowy HTTPS

https://192.168.1.42:9000/mcp

Zastąp host wartością wyświetlaną na ekranie Serwer.

Wersja kontraktu

Wersja	Nazwy narzędzi TCP	Uwagi
v1.1.0 (domyślna)	get_*	Zalecana dla nowych konfiguracji
v1.0.0	Starsza (health_metrics, …)	Aktualizacja zgodności v1.0.0 dla Claude Desktop
v0.0.1	Starsza	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 kodu do skopiowania i wklejenia dla każdej integracji. Użyj punktu końcowego i tokenu wyświetlanych tam. Sprawdź formaty odpowiednie dla wersji Twojego klienta.

Wszystkie poniższe przykłady używają przykładowego adresu LAN — zastąp go adresem swojego iPhone'a z ekranu Serwer.

Claude Code (CLI)

Uruchamiane na Twoim Macu (wymaga interfejsu wiersza polecenia 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 i zaufaniu CA na Twoim 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 — nie jest wymagany żaden mostek Node.js. Konfiguracja znajduje się w ~/.codex/config.toml (globalnie) 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

Ręczna konfiguracja 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 Twoim tokenem Bearer przed uruchomieniem Codex. Po konfiguracji uruchom /mcp w sesji Codex, aby zweryfikować, że serwer jest połączony.

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

mcp-remote (iOS / LAN)

Dla klientów obsługujących tylko stdio (takich jak Claude Desktop), które nie mogą łączyć się bezpośrednio przez HTTP. Wymaga Node.js na Macu, na którym działa klient.

1. Uruchom serwer na iPhonie i skopiuj punkt końcowy oraz token
2. Na swoim Macu wybierz mcp-remote (iOS / LAN) na ekranie Serwer i skopiuj fragment JSON, lub wklej to do konfiguracji MCP klienta (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>"
  ]
}

Gdy HTTPS jest włączone:

1. Wyeksportuj CA z iPhone'a i zaufaj mu w Keychain Access (Always Trust) na Twoim Macu
2. Użyj https://192.168.1.42:9000/mcp w args
3. Gdy Node spełnia minimalną wersję dla --use-system-ca (22.19.0 na 22.x, 23.8.0 na 23.x, 24.6.0 na 24.x lub jakakolwiek wersja 25+), dodaj:

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

Na starszych wersjach Node ustaw zamiast tego NODE_EXTRA_CA_CERTS na czytelną ścieżkę PEM. Uruchom ponownie klienta stdio po zaktualizowaniu konfiguracji.

Zmniejszanie opóźnienia uruchamiania: npx -y pobiera mcp-remote przy pierwszym użyciu i sprawdza ponownie po wygaśnięciu pamięci podręcznej, co może powodować kilkusekundowe opóźnienia. Wcześniejsza globalna instalacja eliminuje ten problem:

npm install -g mcp-remote@0.1.16

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	Wyraźny czas i przesunięcie strefy czasowej

TCP

• Niezaszyfrowany, nieuwierzytelniony JSON-RPC na porcie 9000
• Użyj kontraktu v1.0.0 z mostkiem Node health-auto-export-mcp-server dla starszych nazw narzędzi
• Użyj kontraktu v1.1.0 dla nazw narzędzi TCP get_* (zaktualizuj mostek Node niezależnie)

Wskazówki

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

Wsparcie na czacie

Zbierz dane diagnostyczne z dzienników zdarzeń aplikacji, przechodząc do Ustawienia → Zaawansowane → Eksportuj dzienniki zdarzeń. Zobacz Przewodnik dotyczący dzienników zdarzeń aplikacji. Udostępnij wygenerowany plik zip za pomocą wsparcia na czacie lub e-mailem.