अपने एजेंट को चार चरणों में जोड़ें।
Claude, ChatGPT या Codex के लिए OAuth अनुशंसित है, क्योंकि यह साइन-इन किए उपयोगकर्ता के अनुमत HumanDesign.ai टूल सुरक्षित रूप से उपलब्ध कराता है।
1. होस्ट किया गया endpoint जोड़ें
Endpoint
https://mcp.humandesign.ai/रिमोट HTTP या Streamable HTTP चुनें। /mcp को फिर से न जोड़ें: मानक endpoint डोमेन का रूट है।
2. प्रमाणीकरण करें
क्लाइंट का MCP Authenticate या Connect विकल्प उपयोग करें और HumanDesign.ai ब्राउज़र लॉगिन पूरा करें। Claude Code उपयोगकर्ता यह चला सकते हैं claude mcp login human-design-ai; Codex उपयोगकर्ता यह चला सकते हैं codex mcp login human_design_ai.
यदि आपको केवल छह गणना/संदर्भ टूल चाहिए, तो Bearer या X-Api-Key प्रमाणीकरण के माध्यम से API कुंजी अभी भी उपलब्ध है।
3. अपने टूल खोजें
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}खोज मुफ़्त है। OAuth टूल दृश्यता सर्वर द्वारा निर्धारित क्षमता अनुमतियों, Free/Individual/Personal/Pro सदस्यता, कार्यक्षेत्र भूमिका, स्वामित्व और उत्पाद अधिकारों पर निर्भर है। API-कुंजी दृश्यता अलग Free/Creator/Startup/Business API योजना पर निर्भर है।
4. अपने मुख्य चार्ट से शुरू करें
एजेंट से कॉल करने को कहें chart_get_primary। यदि कोई मुख्य चार्ट मौजूद नहीं है, तो Free, Individual, Personal और Pro सदस्य ये उपयोग कर सकते हैं chart_generate: पहले सामान्यीकृत जन्म-विवरण और एक यूनिट वाला पूर्वावलोकन जाँचें, फिर गणना की पुष्टि करें। सहेजा गया चार्ट खाता-स्वामित्व के आधार पर ढूँढा जाता है, “Kyle” या “My Chart” जैसे नाम खोजकर नहीं। अन्य लोगों के अधिकृत चार्ट पढ़ने के लिए Personal या Pro चाहिए।
कनेक्शन, initialize, ping, tools/list, लाइब्रेरी पठन, स्थिति जाँच और मौजूदा चार्ट रेंडर करने पर क्रेडिट नहीं लगते। नए मुख्य चार्ट की गणना ठीक एक गणना यूनिट लेती है; रेंडरिंग का दूसरा शुल्क नहीं है।
गणना पर भरोसा कैसे करें
एजेंट खुद चार्ट की गणना नहीं करता। कोटा खर्च होने से पहले HumanDesign.ai तारीख, स्थान, IANA समय क्षेत्र और daylight-saving संदर्भ सत्यापित करता है, फिर अपनी गणना सेवा से संस्करणयुक्त परिणाम लौटाता है। अस्पष्ट स्थान और अमान्य इनपुट पर यूनिट खर्च किए बिना स्पष्ट त्रुटि मिलती है। यदि जन्म का समय अज्ञात है, तो सेवा दर्ज करती है कि स्थानीय दोपहर उपयोग की गई थी और चेतावनी देती है कि समय-संवेदी चार्ट विवरण अलग हो सकते हैं।
गणना की सुरक्षित पुनः कोशिश
कोटा लेने वाले MCP टूल generate_chart, generate_composite_chartऔर get_transits को एक idempotencyKeyआवश्यक है। एक ही नियोजित पुनः प्रयास के लिए समान सामान्यीकृत तर्कों के साथ वही कुंजी दोबारा उपयोग करें; नए काम के लिए नई कुंजी लें। समान retry पर अतिरिक्त कोटा नहीं लगता और परिणाम नियत रूप से फिर निकाला जा सकता है; यह संग्रहीत प्रतिक्रिया का byte-for-byte replay नहीं है। MCP transit कॉल के लिए स्पष्ट तारीख आवश्यक है, ताकि retry हमेशा उसी क्षण को संदर्भित करे। सीधे REST और Agent HTTP क्लाइंट भेज सकते हैं Idempotency-Key समर्थित सीमित, non-streaming ऑपरेशन पर; संगतता बदलाव के दौरान यह वैकल्पिक है, इसलिए इसके बिना कॉल transport retry को deduplicate नहीं कर सकते। Batch और SSE caller की retry कुंजियाँ अस्वीकार करते हैं और इस retry-deduplication अनुबंध से बाहर हैं।
कच्चा प्रोटोकॉल परीक्षण
API कुंजी वाले डेवलपर सीधे initialize कर गणना टूल कॉल कर सकते हैं:
Initialize
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}गणना कॉल
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}अपना क्लाइंट चुनें
Claude · Codex · Cursor · VS Code · प्लगइन डाउनलोड