Sunucu Bağlantısı Kılavuzu

iOS üzerindeki MCP Sunucusu, yerel ağınızdaki AI istemcilerinin ve betiklerin sağlık verilerinizi sorgulamasına olanak tanır. HTTP (Streamable MCP) önerilen aktarım yöntemidir. iOS, Node köprüsü kurulumları için TCP'yi de destekler.

İstemciler Mac'inizde veya aynı ağdaki diğer cihazlarda çalışır ve iPhone'unuzda gösterilen uç noktaya bağlanır.

Genel Bakış

Aktarım	Uç Nokta
HTTP (önerilir)	http://{LAN_IP}:9000/mcp (HTTPS etkinleştirildiyse https://)
TCP	{LAN_IP}:9000 (kimlik doğrulaması yok)

Sunucu çalışırken Server ekranında gösterilen adresle {LAN_IP}'yi değiştirin.

Kullanım örnekleri:

• Mac'inizdeki Claude Code, Codex, Cursor veya VS Code'u iPhone'unuzdaki sağlık verilerine bağlayın
• Claude Desktop gibi yalnızca stdio destekleyen istemciler için mcp-remote (iOS / LAN) kullanın
• Yerel ağınızdaki betiklerden metrikleri ve antrenmanları sorgulayın (HTTP)
• health-auto-export-mcp-server Node köprüsü ile TCP entegrasyonları

Ön Koşullar

• iPhone'da Health Auto Export (istemciler bağlıyken uygulama ön planda kalmalıdır)
• Premium abonelik
• HTTP: Server ekranından alınan Bearer token
• iPhone'da Yerel Ağ izni
• İstemci cihaz: iPhone ile aynı Wi-Fi veya LAN; mcp-remote (iOS / LAN) kullanıyorsanız Node.js gereklidir

Sunucuyu başlatma

1. iPhone'da, kenar çubuğu navigasyonunu kullanarak Server'ı açın
2. HTTP (önerilir) veya TCP'yi seçin
3. İsterseniz Use HTTPS'i etkinleştirin (aşağıdaki talimatlara bakın)
4. Start Server'a dokunun
5. Uç nokta URL'sini ve bearer token'ı kopyalayın

Health Auto Export arka plana alındığında sunucu otomatik olarak durur (hem HTTP hem TCP için).

Kimlik Doğrulama (HTTP)

Tüm HTTP istekleri şunu gerektirir:

Authorization: Bearer <your-token>

• Gerekli görürseniz Server ekranından token'ı yeniden oluşturun
• Düz HTTP'de token şifrelenmemiş bir bağlantı üzerinden gönderilir — yalnızca güvenilir ağlarda kullanın veya HTTPS'i etkinleştirin
• Eski TCP'de kimlik doğrulama yoktur (değişmedi)

HTTPS (TLS)

Use HTTPS etkinleştirildiğinde, uygulama özel bir yerel Sertifika Yetkilisi (CA) ve bu CA tarafından imzalanmış bir sunucu sertifikası oluşturur. İstemcilerin https:// üzerinden bağlanabilmesi için önce dışa aktarılan CA'ya güvenmesi gerekir.

HTTPS'i etkinleştirme

1. Kenar çubuğu navigasyonunu kullanarak Server görünümünü açın
2. Use HTTPS'i açın
3. Export CA Certificate'a dokunun ve paylaşım menüsünü kullanarak CA dosyasını AirDrop ile gönderin veya her istemci cihazına kaydedin
4. Sunucuyu başlatın — uç nokta URL'sinin https://'e geçtiğinden emin olun

İstemcilerde CA'ya güvenme

Dışa aktarılan CA'ya, AI istemcisinin çalıştığı cihazda (genellikle Mac'iniz) güvenin:

1. CA'yı iPhone'daki Server ekranından dışa aktarın
2. PEM dosyasını istemci Mac'te Keychain Access'te açın
3. Trust → Always Trust'ı ayarlayın

--use-system-ca için minimum Node sürümü

Node köprüleri (mcp-remote), Node yalnızca şu koşulları karşılıyorsa NODE_OPTIONS=--use-system-ca kullanabilir:

Node serisi	Minimum sürüm
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	herhangi biri

Daha eski Node sürümlerinde, bunun yerine köprü işleminin okuyabileceği bir PEM yoluna NODE_EXTRA_CA_CERTS değişkenini ayarlayın. Desteklenmeyen bir Node sürümünde --use-system-ca kullanmak, işlemin başlamasını engeller.

Güven kapsamı: --use-system-ca, yalnızca bu uygulamanın CA'sına değil, tüm sistem Anahtarlığına (Keychain) güvenir. NODE_EXTRA_CA_CERTS güveni tek bir PEM dosyasıyla sınırlar (daha eski Node için yedek seçenek). Bu bayrak macOS/Windows için belgelenmiştir.

İstemci Türü	Kurulum
Cursor, VS Code, Claude Code, Codex	İstemci Mac'te Keychain güveni — Server ekranındaki https:// uç noktasını kullanın
mcp-remote (iOS / LAN)	mcp-remote'un çalıştığı Mac'te Keychain'de CA'ya güvenin. Kod parçacığı, Node minimum sürümü karşılıyorsa NODE_OPTIONS=--use-system-ca kullanır; daha eski Node'da NODE_EXTRA_CA_CERTS'i okunabilir bir PEM yoluna ayarlayın
curl / betikler	--cacert /path/to/mcp-ca.pem geçirin veya NODE_EXTRA_CA_CERTS'i ayarlayın

Doğru sertifikayı dışa aktardığınızı doğrulayabilmeniz için CA parmak izi Server ekranında gösterilir.

iOS LAN IP değişiklikleri

iPhone'unuzun LAN IP'si değiştiğinde, uygulama güncellenmiş Subject Alternative Names ile sunucu sertifikasını yeniden oluşturur ve HTTPS dinleyicisini yeniden başlatır. IP değiştiyse uç nokta URL'sini yeniden kopyalayın. HTTPS'i kapatıp yeniden açarak yeniden oluşturmadığınız sürece CA sertifikası aynı kalır.

Örnek HTTPS uç noktası

https://192.168.1.42:9000/mcp

Ana bilgisayarı Server ekranında gösterilen değerle değiştirin.

Sözleşme sürümü

Sürüm	TCP araç adları	Notlar
v1.1.0 (varsayılan)	get_*	Yeni kurulumlar için önerilir
v1.0.0	Eski (health_metrics, …)	Claude Desktop uyumluluk güncellemesi v1.0.0
v0.0.1	Eski	En eski uyumluluk

HTTP her zaman get_* araç adlarını kullanır; sözleşme sürümü yalnızca şema varsayılanlarını etkiler.

İstemci yapılandırması

Server ekranı her entegrasyon için kopyalanıp yapıştırılabilir kod parçacıkları içerir. Orada gösterilen uç noktayı ve token'ı kullanın. Biçimleri istemci sürümünüze göre doğrulayın.

Aşağıdaki tüm örneklerde yer tutucu bir LAN adresi kullanılmıştır — bunu Server ekranından iPhone'unuzun adresiyle değiştirin.

Claude Code (CLI)

Mac'inizde çalıştırın (Claude Code CLI gerektirir):

HTTP:

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

HTTPS (Mac'inizde CA'yı dışa aktarıp güvendikten sonra):

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

Claude Code / proje dosyası (.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, Streamable HTTP üzerinden doğrudan bağlanır — Node.js köprüsü gerekmez. Yapılandırma ~/.codex/config.toml'da (genel) veya güvenilir bir proje dizinindeki .codex/config.toml'da yer alır.

CLI (önerilir):

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

Manuel config.toml:

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

Codex'i başlatmadan önce HAE_MCP_TOKEN'ı bearer token'ınızla dışa aktarın. Kurulumdan sonra, sunucunun bağlı olduğunu doğrulamak için bir Codex oturumu içinde /mcp çalıştırın.

Health Auto Export'ta bearer token'ı yeniden oluşturursanız, HAE_MCP_TOKEN'ı güncelleyin ve codex mcp add'i yeniden çalıştırın, ya da sunucu girişini kaldırıp yeniden ekleyin.

mcp-remote (iOS / LAN)

HTTP üzerinden doğrudan bağlanamayan, yalnızca stdio destekleyen istemciler için (örneğin Claude Desktop). İstemcinin çalıştığı Mac'te Node.js gerektirir.

1. iPhone'da sunucuyu başlatın ve uç noktayı ile token'ı kopyalayın
2. Mac'inizde, Server ekranında mcp-remote (iOS / LAN)'i seçip JSON kod parçacığını kopyalayın veya bunu istemcinin MCP yapılandırmasına yapıştırın (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>"
  ]
}

HTTPS etkinleştirildiğinde:

1. CA'yı iPhone'dan dışa aktarın ve Mac'inizde Keychain Access'te güvenin (Always Trust)
2. args içinde https://192.168.1.42:9000/mcp kullanın
3. Node, --use-system-ca için minimum sürümü karşılıyorsa (22.x'te 22.19.0, 23.x'te 23.8.0, 24.x'te 24.6.0 veya herhangi bir 25+ sürümü), şunu ekleyin:

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

Daha eski Node'da bunun yerine NODE_EXTRA_CA_CERTS'i okunabilir bir PEM yoluna ayarlayın. Yapılandırmayı güncelledikten sonra stdio istemcisini yeniden başlatın.

Başlangıç gecikmesini azaltma: npx -y, ilk kullanımda mcp-remote'u indirir ve önbellek süresi dolduğunda yeniden kontrol eder; bu birkaç saniyelik gecikmelere neden olabilir. Global olarak önceden yüklemek bunu ortadan kaldırır:

npm install -g mcp-remote@0.1.16

Araç argümanları

Tarih biçimleri

start ve end parametreleri iki biçimi kabul eder:

Biçim	Örnek	Notlar
yyyy-MM-dd	2026-06-13	Başlangıç tarihi: gece yarısı; bitiş tarihi: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Açık saat ve saat dilimi ofseti

TCP

• 9000 portunda şifrelenmemiş, kimlik doğrulamasız JSON-RPC
• Eski araç adları için Node health-auto-export-mcp-server köprüsüyle v1.0.0 sözleşmesini kullanın
• get_* TCP araç adları için v1.1.0 sözleşmesini kullanın (Node köprüsünü ayrıca güncelleyin)

İpuçları

1. İstemciler bağlıyken Health Auto Export'u iPhone'da ön planda tutun
2. Token'ın ifşa edildiğinden şüpheleniyorsanız yeniden oluşturun
3. iPhone'unuzun LAN IP'si değiştikten sonra uç nokta URL'sini yeniden kopyalayın

Sohbet Desteği

Settings → Advanced → Export Event Logs'a giderek dışa aktarma uygulaması olay günlüklerinden tanılama bilgisi toplayın. Uygulama Olay Günlükleri Kılavuzu'na bakın. Oluşturulan zip dosyasını Sohbet Desteği veya e-posta yoluyla paylaşın.