सर्वर से कनेक्ट करें
अपने स्थानीय नेटवर्क पर AI क्लाइंट और स्क्रिप्ट के लिए Health Auto Export MCP सर्वर से कनेक्ट करें।
अंतिम अपडेट: 31 अक्टूबर 2026
इस पृष्ठ पर
HTTPS (TLS)
HTTPS (TLS) HTTPS सक्षम करनाक्लाइंट पर CA पर भरोसाiOS LAN IP परिवर्तनउदाहरण HTTPS एंडपॉइंटक्लाइंट कॉन्फ़िगरेशन
क्लाइंट कॉन्फ़िगरेशन Claude Code (CLI)Claude Code / प्रोजेक्ट फ़ाइल (<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 पर MCP सर्वर AI क्लाइंट और स्क्रिप्ट को आपके स्थानीय नेटवर्क पर आपके स्वास्थ्य डेटा की क्वेरी करने देता है। HTTP (Streamable MCP) अनुशंसित ट्रांसपोर्ट है। iOS Node-bridge सेटअप के लिए TCP भी समर्थित करता है।
क्लाइंट आपके Mac या उसी नेटवर्क के अन्य डिवाइस पर चलते हैं और आपके iPhone पर दिखाए एंडपॉइंट से कनेक्ट होते हैं।
अवलोकन
| ट्रांसपोर्ट | एंडपॉइंट |
|---|---|
| HTTP (अनुशंसित) | http://{LAN_IP}:9000/mcp (या HTTPS सक्षम होने पर https://) |
| TCP | {LAN_IP}:9000 (अप्रमाणित) |
सर्वर चलते समय सर्वर स्क्रीन पर दिखाए पते से {LAN_IP} प्रतिस्थापित करें।
उपयोग के मामले:
- अपने Mac पर Claude Code, Codex, Cursor, या VS Code को अपने iPhone के स्वास्थ्य डेटा से कनेक्ट करें
- Claude Desktop जैसे केवल-stdio क्लाइंट के लिए mcp-remote (iOS / LAN) उपयोग करें
- अपने स्थानीय नेटवर्क पर स्क्रिप्ट से मेट्रिक और वर्कआउट क्वेरी करें (HTTP)
- health-auto-export-mcp-server Node ब्रिज के माध्यम से TCP एकीकरण
पूर्वापेक्षाएँ
- iPhone पर Health Auto Export (क्लाइंट कनेक्ट होने तक ऐप अग्रभूमि में रहना चाहिए)
- Premium सदस्यता
- HTTP: सर्वर स्क्रीन से Bearer टोकन
- iPhone पर Local Network अनुमति
- क्लाइंट डिवाइस: iPhone के समान Wi‑Fi या LAN; mcp-remote (iOS / LAN) उपयोग करने पर ही Node.js
सर्वर शुरू करना
- iPhone पर, निर्यात टैब से सर्वर खोलें। iPad पर साइडबार उपयोग करें।
- HTTP (अनुशंसित) या TCP चुनें
- वैकल्पिक रूप से HTTPS उपयोग करें सक्षम करें (नीचे निर्देश)
- सर्वर शुरू करें टैप करें
- एंडपॉइंट URL और bearer टोकन कॉपी करें
सक्रिय सर्वर स्वचालित रूप से रुक जाता है यदि Health Auto Export पृष्ठभूमि में चला जाए, चाहे आप HTTP या TCP उपयोग करें।
प्रमाणीकरण (HTTP)
सभी HTTP अनुरोधों के लिए आवश्यक:
Authorization: Bearer <your-token>
- आवश्यक समझे जाने पर सर्वर स्क्रीन से टोकन पुनर्जनित करें
- सादे HTTP पर, टोकन अनएन्क्रिप्टेड कनेक्शन पर भेजा जाता है—केवल विश्वसनीय नेटवर्क पर उपयोग करें, या HTTPS सक्षम करें
- TCP लेगेसी में कोई प्रमाणीकरण नहीं (अपरिवर्तित)
HTTPS (TLS)
HTTPS स्थानीय रूप से जेनरेट Certificate Authority (CA) उपयोग करता है। https:// पर कनेक्ट करने से पहले प्रत्येक क्लाइंट डिवाइस पर उसका प्रमाणपत्र निर्यात करें और भरोसा करें।
HTTPS सक्षम करना
- सर्वर दृश्य खोलें (iPhone: निर्यात टैब; iPad: साइडबार)
- HTTPS उपयोग करें चालू करें
- CA प्रमाणपत्र निर्यात करें टैप करें और प्रत्येक क्लाइंट डिवाइस पर CA फ़ाइल AirDrop या सहेजने के लिए शेयर शीट उपयोग करें
- सर्वर शुरू करें — सुनिश्चित करें कि एंडपॉइंट URL
https://पर स्विच हो
क्लाइंट पर CA पर भरोसा
AI क्लाइंट चलाने वाले डिवाइस (आमतौर पर आपका Mac) पर निर्यातित CA पर भरोसा करें:
- iPhone की सर्वर स्क्रीन से CA निर्यात करें
- क्लाइंट Mac पर Keychain Access में PEM खोलें
- Trust → Always Trust सेट करें
जेनरेट सेटअप के लिए Node संस्करण
ऐप का जेनरेट Node ब्रिज सेटअप इन Node संस्करणों के लिए NODE_OPTIONS=--use-system-ca उपयोग करता है:
| Node लाइन | न्यूनतम संस्करण |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | कोई भी |
पुराने Node पर, इसके बजाय ब्रिज प्रक्रिया द्वारा पढ़े जा सकने वाले PEM पथ पर NODE_EXTRA_CA_CERTS सेट करें। असमर्थित Node पर --use-system-ca उत्सर्जित करने से प्रक्रिया शुरू नहीं होती।
भरोसा दायरा:
--use-system-caपूर्ण सिस्टम Keychain पर भरोसा करता है, केवल इस ऐप के CA पर नहीं।NODE_EXTRA_CA_CERTSनिर्यातित CA को Node के विश्वसनीय प्रमाणपत्रों में जोड़ता है। देखें Node certificate options।
| क्लाइंट प्रकार | सेटअप |
|---|---|
| Cursor, VS Code, Claude Code, Codex | क्लाइंट Mac पर Keychain भरोसा — सर्वर स्क्रीन से https:// एंडपॉइंट उपयोग करें |
| mcp-remote (iOS / LAN) | mcp-remote चलाने वाले Mac पर Keychain में CA पर भरोसा। स्निपेट Node न्यूनतम संस्करण पूरा करने पर NODE_OPTIONS=--use-system-ca उपयोग करता है; पुराने Node पर पढ़ने योग्य PEM पथ पर NODE_EXTRA_CA_CERTS सेट करें |
| curl / स्क्रिप्ट | --cacert /path/to/mcp-ca.pem पास करें या NODE_EXTRA_CA_CERTS सेट करें |
CA फ़िंगरप्रिंट सर्वर स्क्रीन पर दिखाया जाता है ताकि आप सत्यापित कर सकें कि आपने सही प्रमाणपत्र निर्यात किया।
iOS LAN IP परिवर्तन
यदि आपके iPhone का नेटवर्क पता बदलता है तो एंडपॉइंट URL फिर कॉपी करें। यदि प्रतिस्थापन CA प्रमाणपत्र प्रदान किया जाए, उसे निर्यात करें और प्रत्येक क्लाइंट डिवाइस पर भरोसा अपडेट करें।
उदाहरण HTTPS एंडपॉइंट
https://192.168.1.42:9000/mcp
होस्ट को सर्वर स्क्रीन पर दिखाए मान से प्रतिस्थापित करें।
कॉन्ट्रैक्ट संस्करण
| संस्करण | TCP टूल नाम | नोट्स |
|---|---|---|
| v1.1.0 (डिफ़ॉल्ट) | get_* |
नए सेटअप के लिए अनुशंसित |
| v1.0.0 | लेगेसी (health_metrics, …) |
Claude Desktop संगतता अपडेट v1.0.0 |
| v0.0.1 | लेगेसी | सबसे पुरानी संगतता |
HTTP हमेशा get_* टूल नाम उपयोग करता है; कॉन्ट्रैक्ट संस्करण केवल स्कीमा डिफ़ॉल्ट प्रभावित करता है।
क्लाइंट कॉन्फ़िगरेशन
सर्वर स्क्रीन में प्रत्येक एकीकरण के लिए कॉपी-पेस्ट स्निपेट शामिल हैं। वहाँ दिखाए एंडपॉइंट और टोकन उपयोग करें। अपने क्लाइंट संस्करण के विरुद्ध प्रारूप सत्यापित करें।
नीचे सभी उदाहरण प्लेसहोल्डर LAN पता उपयोग करते हैं—सर्वर स्क्रीन से अपने iPhone का पता प्रतिस्थापित करें।
Claude Code (CLI)
अपने Mac पर चलाएँ (Claude Code CLI आवश्यक):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS (अपने Mac पर CA निर्यात और भरोसा करने के बाद):
claude mcp add --transport http health-auto-export \
https://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
Claude Code / प्रोजेक्ट फ़ाइल (.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 से कनेक्ट होता है — Node.js ब्रिज आवश्यक नहीं। कॉन्फ़िगरेशन ~/.codex/config.toml (वैश्विक) या विश्वसनीय प्रोजेक्ट निर्देशिका में .codex/config.toml में रहती है।
CLI (अनुशंसित):
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
मैन्युअल कॉन्फ़िगरेशन (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 शुरू करने से पहले अपना bearer टोकन के साथ HAE_MCP_TOKEN निर्यात करें। सेटअप के बाद, सर्वर कनेक्ट सत्यापित करने के लिए Codex सत्र के अंदर /mcp चलाएँ।
यदि आप Health Auto Export में bearer टोकन पुनर्जनित करते हैं, HAE_MCP_TOKEN अपडेट करें और codex mcp add फिर चलाएँ, या सर्वर प्रविष्टि हटाएँ और फिर जोड़ें।
mcp-remote (iOS / LAN)
केवल-stdio क्लाइंट (जैसे Claude Desktop) के लिए जो सीधे HTTP पर कनेक्ट नहीं कर सकते। क्लाइंट चलाने वाले Mac पर Node.js आवश्यक।
- iPhone पर सर्वर शुरू करें और एंडपॉइंट तथा टोकन कॉपी करें
- अपने Mac पर, सर्वर स्क्रीन पर mcp-remote (iOS / LAN) चुनें और JSON स्निपेट कॉपी करें, या इसे क्लाइंट की MCP कॉन्फ़िग में पेस्ट करें (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 सक्षम हो:
- iPhone से CA निर्यात करें और अपने Mac पर Keychain Access में भरोसा करें (Always Trust)
https://192.168.1.42:9000/mcpकोargsमें उपयोग करें- ऊपर जेनरेट सेटअप द्वारा समर्थित Node संस्करणों के लिए, उसी सर्वर कॉन्फ़िगरेशन ऑब्जेक्ट में यह
envऑब्जेक्ट जोड़ें:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
पुराने Node पर, इसके बजाय पढ़ने योग्य PEM पथ पर NODE_EXTRA_CA_CERTS सेट करें। कॉन्फ़िग अपडेट के बाद stdio क्लाइंट पुनः आरंभ करें।
टूल आर्ग्युमेंट
तिथि प्रारूप
start और end पैरामीटर दो प्रारूप स्वीकार करते हैं:
| प्रारूप | उदाहरण | नोट्स |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
प्रारंभ तिथि: मध्यरात्रि; समाप्ति तिथि: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
स्पष्ट समय और समय क्षेत्र ऑफ़सेट |
TCP
- पोर्ट 9000 पर अनएन्क्रिप्टेड, अप्रमाणित JSON-RPC
- लेगेसी टूल नामों के लिए Node
health-auto-export-mcp-serverब्रिज के साथ कॉन्ट्रैक्ट v1.0.0 उपयोग करें get_* TCP टूल नामों के लिए कॉन्ट्रैक्ट v1.1.0 उपयोग करें (Node ब्रिज अलग से अपडेट करें)
सुझाव
- क्लाइंट कनेक्ट होने तक iPhone पर Health Auto Export अग्रभूमि में रखें
- यदि संदेह हो कि टोकन उजागर हुआ, उसे पुनर्जनित करें
- अपने iPhone के LAN IP बदलने के बाद एंडपॉइंट URL फिर कॉपी करें
सहायता प्राप्त करें
सहायता सबमिशन के लिए सहायता प्राप्त करें और निदान निर्यात के लिए ऐप इवेंट लॉग देखें।