Yardım Merkezi HealthyApps
Türkçe
Yardım Merkezi
Ana web sitesi ↗

Yardım konularını ara

Sunucuya Bağlanma

Yerel ağınızdaki yapay zeka istemcileri ve betikler için Health Auto Export MCP sunucusuna bağlanın.

Son güncelleme: 31 Ekim 2026

Bu sayfada
Genel bakışÖnkoşullarSunucuyu başlatmaKimlik doğrulama (HTTP)
HTTPS (TLS) HTTPS (TLS) HTTPS’i etkinleştirmeİstemcilerde CA’ya güvenmeiOS LAN IP değişiklikleriÖrnek HTTPS uç noktası
Sözleşme sürümü
İstemci yapılandırması İstemci yapılandırması Claude Code (CLI)Claude Code / proje dosyası (<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)
Araç bağımsız değişkenleri Araç bağımsız değişkenleri Tarih biçimleri
TCPİpuçlarıYardım Alma

iOS üzerindeki MCP Sunucusu, yerel ağınızdaki yapay zeka istemcilerinin ve betiklerin sağlık verinizi sorgulamasına olanak tanır. HTTP (Akışlı MCP) önerilen taşımadır. iOS ayrıca Node köprüsü kurulumları için TCP’yi 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ış

Taşıma Uç nokta
HTTP (önerilen) http://{LAN_IP}:9000/mcp (HTTPS etkinse https://)
TCP {LAN_IP}:9000 (kimlik doğrulamasız)

{LAN_IP} yerine sunucu çalışırken Sunucu ekranında gösterilen adresi koyun.

Kullanım senaryoları:

  • Mac’inizdeki Claude Code, Codex, Cursor veya VS Code’u iPhone’unuzdaki sağlık verisine bağlayın
  • Claude Desktop gibi yalnızca stdio istemcileri 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ü üzerinden TCP entegrasyonları

Önkoşullar

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

Sunucuyu başlatma

  1. iPhone’da Dışa Aktar sekmesinden Sunucu’yu açın. iPad’de kenar çubuğunu kullanın.
  2. HTTP (önerilen) veya TCP’yi seçin
  3. İsteğe bağlı olarak HTTPS Kullan’ı etkinleştirin (aşağıdaki talimatlar)
  4. Sunucuyu Başlat’a dokunun
  5. Uç nokta URL’sini ve bearer belirtecini kopyalayın

Health Auto Export arka plana alındığında etkin sunucu HTTP veya TCP kullanıyor olun otomatik durur.

Kimlik doğrulama (HTTP)

Tüm HTTP istekleri şunu gerektirir:

Authorization: Bearer <your-token>
  • Gerekli görürseniz belirteci Sunucu ekranından yeniden oluşturun
  • Düz HTTP’de belirteç şifrelenmemiş bir bağlantı üzerinden gönderilir—yalnızca güvenilir ağlarda kullanın veya HTTPS’i etkinleştirin
  • Eski TCP’nin kimlik doğrulaması yoktur (değişmedi)

HTTPS (TLS)

HTTPS yerel olarak üretilen bir Sertifika Yetkilisi (CA) kullanır. https:// üzerinden bağlanmadan önce her istemci cihazında sertifikasını dışa aktarın ve güvenin.

HTTPS’i etkinleştirme

  1. Sunucu görünümünü açın (iPhone: Dışa Aktar sekmesi; iPad: kenar çubuğu)
  2. HTTPS Kullan’ı açın
  3. CA Sertifikasını Dışa Aktar’a dokunun ve her istemci cihazına CA dosyasını AirDrop veya kaydetmek için paylaşım sayfasını kullanın
  4. Sunucuyu başlatın — uç nokta URL’sinin https:// olarak değiştiğini doğrulayın

İstemcilerde CA’ya güvenme

Dışa aktarılan CA’ya yapay zeka istemcisini çalıştıran cihazda (genellikle Mac’iniz) güvenin:

  1. iPhone’daki Sunucu ekranından CA’yı dışa aktarın
  2. İstemci Mac’te PEM’i Anahtar Zinciri Erişimi’nde açın
  3. Güven → Her Zaman Güven olarak ayarlayın

Üretilen kurulum için Node sürümleri

Uygulamanın ürettiği Node köprüsü kurulumu şu Node sürümleri için NODE_OPTIONS=--use-system-ca kullanır:

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

Eski Node’da bunun yerine köprü sürecinin okuyabileceği bir PEM yoluna NODE_EXTRA_CA_CERTS ayarlayın. Desteklenmeyen Node’da --use-system-ca yaymak sürecin başlamasını engeller.

Güven kapsamı: --use-system-ca yalnızca bu uygulamanın CA’sını değil, tüm sistem Anahtar Zinciri’ne güvenir. NODE_EXTRA_CA_CERTS dışa aktarılan CA’yı Node’un güvenilen sertifikalarına ekler. Bkz. Node sertifika seçenekleri.

İstemci türü Kurulum
Cursor, VS Code, Claude Code, Codex İstemci Mac’te Anahtar Zinciri güveni — Sunucu ekranındaki https:// uç noktasını kullanın
mcp-remote (iOS / LAN) mcp-remote çalıştıran Mac’te Anahtar Zinciri’nde CA’ya güvenin. Node minimum sürümü karşılıyorsa snippet NODE_OPTIONS=--use-system-ca kullanır; eski Node’da okunabilir bir PEM yoluna NODE_EXTRA_CA_CERTS ayarlayın
curl / betikler --cacert /path/to/mcp-ca.pem geçin veya NODE_EXTRA_CA_CERTS ayarlayın

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

iOS LAN IP değişiklikleri

iPhone’unuzun ağ adresi değişirse uç nokta URL’sini yeniden kopyalayın. Yerine geçen bir CA sertifikası sağlanırsa onu dışa aktarın ve her istemci cihazında güveni güncelleyin.

Örnek HTTPS uç noktası

https://192.168.1.42:9000/mcp

Ana bilgisayarı Sunucu 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ı

Sunucu ekranı her entegrasyon için kopyala-yapıştır snippet’leri içerir. Orada gösterilen uç noktayı ve belirteci kullanın. Biçimleri istemci sürümünüze göre doğrulayın.

Aşağıdaki tüm örnekler yer tutucu bir LAN adresi kullanır—Sunucu ekranından iPhone’unuzun adresini koyun.

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 (CA’yı Mac’inizde 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 doğrudan Akışlı HTTP üzerinden bağlanır — Node.js köprüsü gerekmez. Yapılandırma ~/.codex/config.toml (genel) veya güvenilen bir proje dizinindeki .codex/config.toml içinde yer alır.

CLI (önerilen):

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 yapılandırma (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 bearer belirtecinizle HAE_MCP_TOKEN’ı dışa aktarın. Kurulumdan sonra sunucunun bağlı olduğunu doğrulamak için bir Codex oturumunda /mcp çalıştırın.

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

mcp-remote (iOS / LAN)

Doğrudan HTTP üzerinden bağlanamayan yalnızca stdio istemcileri (örneğin Claude Desktop) için. İstemciyi çalıştıran Mac’te Node.js gerektirir.

  1. iPhone’da sunucuyu başlatın ve uç noktayı ile belirteci kopyalayın
  2. Mac’inizde Sunucu ekranında mcp-remote (iOS / LAN)’ı seçin ve JSON snippet’ini kopyalayın veya istemcinin MCP yapılandırmasına yapıştırın (Claude Desktop → Ayarlar → Geliştirici → Yapılandırmayı Düzenle):
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

HTTPS etkin olduğunda:

  1. iPhone’dan CA’yı dışa aktarın ve Mac’inizde Anahtar Zinciri Erişimi’nde güvenin (Her Zaman Güven)
  2. https://192.168.1.42:9000/mcp adresini args içinde kullanın
  3. Yukarıdaki üretilen kurulumun desteklediği Node sürümleri için aynı sunucu yapılandırma nesnesine şu env nesnesini ekleyin:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

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

Araç bağımsız değişkenleri

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

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

İpuçları

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

Yardım Alma

Destek gönderimleri için bkz. Yardım Alma; tanılama dışa aktarmaları için bkz. Uygulama Olay Günlükleri.