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
HTTPS (TLS)
HTTPS (TLS) HTTPS’i etkinleştirmeİstemcilerde CA’ya güvenmeiOS LAN IP değişiklikleriÖrnek HTTPS uç noktasıİ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)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
- iPhone’da Dışa Aktar sekmesinden Sunucu’yu açın. iPad’de kenar çubuğunu kullanın.
- HTTP (önerilen) veya TCP’yi seçin
- İsteğe bağlı olarak HTTPS Kullan’ı etkinleştirin (aşağıdaki talimatlar)
- Sunucuyu Başlat’a dokunun
- 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
- Sunucu görünümünü açın (iPhone: Dışa Aktar sekmesi; iPad: kenar çubuğu)
- HTTPS Kullan’ı açın
- 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
- 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:
- iPhone’daki Sunucu ekranından CA’yı dışa aktarın
- İstemci Mac’te PEM’i Anahtar Zinciri Erişimi’nde açın
- 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-cayalnızca bu uygulamanın CA’sını değil, tüm sistem Anahtar Zinciri’ne güvenir.NODE_EXTRA_CA_CERTSdış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.
- iPhone’da sunucuyu başlatın ve uç noktayı ile belirteci kopyalayın
- 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:
- iPhone’dan CA’yı dışa aktarın ve Mac’inizde Anahtar Zinciri Erişimi’nde güvenin (Her Zaman Güven)
https://192.168.1.42:9000/mcpadresiniargsiçinde kullanın- Yukarıdaki üretilen kurulumun desteklediği Node sürümleri için aynı sunucu yapılandırma nesnesine şu
envnesnesini 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-serverkö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ı
- İstemciler bağlıyken iPhone’da Health Auto Export’u ön planda tutun
- Açığa çıktığından şüpheleniyorsanız belirteci yeniden oluşturun
- 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.