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
HTTPS (TLS)
HTTPS (TLS) Włączanie HTTPSZaufanie CA na klientachZmiany adresu IP LAN iOSPrzykładowy punkt końcowy HTTPSKonfiguracja 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)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
- Na iPhonie otwórz Serwer z karty Eksport. Na iPadzie użyj paska bocznego.
- Wybierz HTTP (zalecane) lub TCP
- Opcjonalnie włącz Użyj HTTPS (instrukcje poniżej)
- Stuknij Uruchom serwer
- 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
- Otwórz widok Serwer (iPhone: karta Eksport; iPad: pasek boczny)
- Włącz Użyj HTTPS
- 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
- 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):
- Wyeksportuj CA z ekranu Serwer na iPhonie
- Otwórz plik PEM w Dostępie do pęku kluczy na Macu klienta
- 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-caufa całemu systemowemu pękowi kluczy, nie tylko CA tej aplikacji.NODE_EXTRA_CA_CERTSdodaje 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.
- Uruchom serwer na iPhonie i skopiuj punkt końcowy oraz token
- 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:
- Wyeksportuj CA z iPhone’a i zaufaj mu w Dostępie do pęku kluczy (Zawsze ufaj) na Macu
- Użyj
https://192.168.1.42:9000/mcpwargs - Dla wersji Node obsługiwanych przez wygenerowaną konfigurację powyżej dodaj ten obiekt
envdo 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-serverdla legacy nazw narzędzi - Użyj kontraktu v1.1.0 dla nazw narzędzi TCP
get_* (zaktualizuj most Node osobno)
Wskazówki
- Trzymaj Health Auto Export na pierwszym planie na iPhonie, gdy klienci są podłączeni
- Wygeneruj ponownie token, jeśli podejrzewasz, że został ujawniony
- 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.