सर्वर से कनेक्ट करें
अपने लोकल नेटवर्क पर AI क्लाइंट और स्क्रिप्ट के लिए Health Auto Export के MCP सर्वर से कनेक्ट करें।
Last updated: July 14, 2026
इस पृष्ठ पर
- अवलोकन
- आवश्यक शर्तें
- सर्वर शुरू करना
- प्रमाणीकरण (HTTP)
- 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)
- टूल आर्गुमेंट
- डेट फ़ॉर्मेट
- TCP
- सुझाव
- चैट सपोर्ट
सर्वर कनेक्शन गाइड
iOS पर मौजूद MCP सर्वर आपके लोकल नेटवर्क पर मौजूद AI क्लाइंट और स्क्रिप्ट को आपका हेल्थ डेटा क्वेरी करने देता है। HTTP (Streamable MCP) अनुशंसित ट्रांसपोर्ट है। Node-ब्रिज सेटअप के लिए iOS TCP को भी सपोर्ट करता है।
क्लाइंट आपके Mac या उसी नेटवर्क पर मौजूद अन्य डिवाइस पर चलते हैं और आपके iPhone पर दिखाए गए एंडपॉइंट से कनेक्ट होते हैं।
अवलोकन
| ट्रांसपोर्ट | एंडपॉइंट |
|---|---|
| HTTP (अनुशंसित) | http://{LAN_IP}:9000/mcp (या HTTPS सक्षम होने पर https://) |
| TCP | {LAN_IP}:9000 (बिना प्रमाणीकरण) |
{LAN_IP} को उस पते से बदलें जो सर्वर चलने के दौरान Server स्क्रीन पर दिखाया जाता है।
उपयोग के मामले:
- अपने 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 चल रहा हो (क्लाइंट कनेक्ट होने के दौरान ऐप को फ़ोरग्राउंड में रहना चाहिए)
- प्रीमियम सब्सक्रिप्शन
- HTTP: Server स्क्रीन से Bearer टोकन
- iPhone पर Local Network परमिशन
- क्लाइंट डिवाइस: iPhone के समान Wi‑Fi या LAN पर; mcp-remote (iOS / LAN) का उपयोग करने पर ही Node.js आवश्यक है
सर्वर शुरू करना
- iPhone पर, साइडबार नेविगेशन का उपयोग करके Server खोलें
- HTTP (अनुशंसित) या TCP चुनें
- वैकल्पिक रूप से Use HTTPS सक्षम करें (नीचे दिए निर्देश देखें)
- Start Server टैप करें
- एंडपॉइंट URL और Bearer टोकन कॉपी करें
यदि Health Auto Export को बैकग्राउंड में भेजा जाता है तो सर्वर स्वचालित रूप से बंद हो जाता है (HTTP और TCP दोनों के लिए)।
प्रमाणीकरण (HTTP)
सभी HTTP रिक्वेस्ट के लिए यह आवश्यक है:
Authorization: Bearer <your-token>
- यदि आवश्यक लगे तो Server स्क्रीन से टोकन को फिर से जनरेट करें
- सामान्य HTTP पर, टोकन एक अनएन्क्रिप्टेड कनेक्शन पर भेजा जाता है—इसका उपयोग केवल भरोसेमंद नेटवर्क पर करें, या HTTPS सक्षम करें
- लेगेसी TCP में कोई प्रमाणीकरण नहीं है (अपरिवर्तित)
HTTPS (TLS)
जब Use HTTPS सक्षम होता है, तो ऐप एक निजी लोकल सर्टिफिकेट अथॉरिटी (CA) और उस CA द्वारा साइन किया गया सर्वर लीफ सर्टिफिकेट जनरेट करता है। https:// पर कनेक्ट होने से पहले क्लाइंट को एक्सपोर्ट की गई CA पर भरोसा करना होगा।
HTTPS सक्षम करना
- साइडबार नेविगेशन का उपयोग करके Server व्यू खोलें
- Use HTTPS चालू करें
- Export CA Certificate टैप करें और शेयर शीट का उपयोग करके हर क्लाइंट डिवाइस पर CA फ़ाइल AirDrop करें या सेव करें
- सर्वर शुरू करें — सुनिश्चित करें कि एंडपॉइंट URL
https://में बदल जाए
क्लाइंट पर CA पर भरोसा करना
एक्सपोर्ट की गई CA पर उस डिवाइस पर भरोसा करें जो AI क्लाइंट चला रही है (आमतौर पर आपका Mac):
- iPhone पर Server स्क्रीन से CA एक्सपोर्ट करें
- क्लाइंट Mac पर Keychain Access में PEM फ़ाइल खोलें
- Trust → Always Trust सेट करें
--use-system-ca के लिए Node की न्यूनतम वर्शन
Node ब्रिज (mcp-remote) NODE_OPTIONS=--use-system-ca का उपयोग केवल तब कर सकते हैं जब Node निम्न शर्तें पूरी करता हो:
| Node लाइन | न्यूनतम वर्शन |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | कोई भी |
पुराने Node पर, इसके बजाय NODE_EXTRA_CA_CERTS को उस PEM पथ पर सेट करें जिसे ब्रिज प्रोसेस पढ़ सके। असमर्थित Node पर --use-system-ca का उपयोग करने से प्रोसेस शुरू नहीं हो पाती।
ट्रस्ट स्कोप:
--use-system-caकेवल इस ऐप की CA पर नहीं, बल्कि पूरे सिस्टम Keychain पर भरोसा करता है।NODE_EXTRA_CA_CERTSभरोसे को एक ही PEM फ़ाइल तक सीमित करता है (पुराने Node के लिए फ़ॉलबैक)। यह फ़्लैग macOS/Windows के लिए दस्तावेज़ीकृत है।
| क्लाइंट प्रकार | सेटअप |
|---|---|
| Cursor, VS Code, Claude Code, Codex | क्लाइंट Mac पर Keychain ट्रस्ट — Server स्क्रीन से https:// एंडपॉइंट का उपयोग करें |
| mcp-remote (iOS / LAN) | mcp-remote चला रहे Mac पर Keychain में CA पर भरोसा करें। जब Node न्यूनतम वर्शन पूरी करता है तो स्निपेट NODE_OPTIONS=--use-system-ca का उपयोग करता है; पुराने Node पर NODE_EXTRA_CA_CERTS को पढ़ने योग्य PEM पथ पर सेट करें |
| curl / स्क्रिप्ट | --cacert /path/to/mcp-ca.pem पास करें, या NODE_EXTRA_CA_CERTS सेट करें |
CA फ़िंगरप्रिंट Server स्क्रीन पर दिखाया जाता है, ताकि आप सत्यापित कर सकें कि आपने सही सर्टिफिकेट एक्सपोर्ट किया है।
iOS का LAN IP बदलने पर
जब आपके iPhone का LAN IP बदलता है, तो ऐप अपडेट किए गए Subject Alternative Names के साथ लीफ सर्टिफिकेट को फिर से जनरेट करता है और HTTPS लिसनर को रीस्टार्ट करता है। यदि IP बदल गया है तो एंडपॉइंट URL को फिर से कॉपी करें। CA सर्टिफिकेट तब तक वही रहता है जब तक आप HTTPS को बंद और चालू करके इसे फिर से जनरेट न करें।
HTTPS एंडपॉइंट का उदाहरण
https://192.168.1.42:9000/mcp
होस्ट को उस मान से बदलें जो Server स्क्रीन पर दिखाया गया है।
कॉन्ट्रैक्ट वर्शन
| वर्शन | TCP टूल नाम | नोट्स |
|---|---|---|
| v1.1.0 (डिफ़ॉल्ट) | get_* |
नए सेटअप के लिए अनुशंसित |
| v1.0.0 | लेगेसी (health_metrics, …) |
Claude Desktop कम्पैटिबिलिटी अपडेट v1.0.0 |
| v0.0.1 | लेगेसी | सबसे पुरानी कम्पैटिबिलिटी |
HTTP हमेशा get_* टूल नामों का उपयोग करता है; कॉन्ट्रैक्ट वर्शन केवल स्कीमा डिफ़ॉल्ट को प्रभावित करता है।
क्लाइंट कॉन्फिगरेशन
Server स्क्रीन में हर इंटीग्रेशन के लिए कॉपी-पेस्ट स्निपेट शामिल हैं। वहां दिखाए गए एंडपॉइंट और टोकन का उपयोग करें। अपने क्लाइंट वर्शन के अनुसार फ़ॉर्मेट सत्यापित करें।
नीचे दिए सभी उदाहरण एक प्लेसहोल्डर LAN एड्रेस का उपयोग करते हैं—इसे Server स्क्रीन से मिले अपने 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 पर, Server स्क्रीन पर 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)
argsमेंhttps://192.168.1.42:9000/mcpका उपयोग करें- जब Node
--use-system-caकी न्यूनतम वर्शन पूरी करता है (22.x पर 22.19.0, 23.x पर 23.8.0, 24.x पर 24.6.0, या 25+ की कोई भी रिलीज़), तो यह जोड़ें:
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
पुराने Node पर, इसके बजाय NODE_EXTRA_CA_CERTS को पढ़ने योग्य PEM पथ पर सेट करें। कॉन्फिगरेशन अपडेट करने के बाद stdio क्लाइंट को रीस्टार्ट करें।
स्टार्टअप में देरी कम करना: npx -y पहली बार उपयोग करने पर mcp-remote डाउनलोड करता है और कैश एक्सपायर होने पर फिर से जांच करता है, जिससे कई सेकंड की देरी हो सकती है। इसे ग्लोबल रूप से पहले से इंस्टॉल करने से यह समस्या खत्म हो जाती है:
npm install -g mcp-remote@0.1.16
टूल आर्गुमेंट
डेट फ़ॉर्मेट
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 ब्रिज को अलग से अपडेट करें)
सुझाव
- जब तक क्लाइंट कनेक्ट हैं, Health Auto Export को iPhone पर फ़ोरग्राउंड में रखें
- यदि आपको लगे कि टोकन एक्सपोज़ हो गया है तो उसे फिर से जनरेट करें
- आपके iPhone का LAN IP बदलने के बाद एंडपॉइंट URL को फिर से कॉपी करें
चैट सपोर्ट
Settings → Advanced → Export Event Logs पर जाकर एक्सपोर्ट ऐप इवेंट लॉग से डायग्नोस्टिक्स इकट्ठा करें। ऐप इवेंट लॉग गाइड देखें। जनरेट की गई zip फ़ाइल को चैट सपोर्ट या ईमेल के ज़रिए शेयर करें।