Σύνδεση στο HumanDesign.ai MCP
Πριν ξεκινήσετε
Το MCP HumanDesign.ai παρέχει σε συμβατά AI client δομημένα εργαλεία Human Design. Αυτός ο οδηγός καλύπτει τον κατάλογο υπολογισμών και αναφορών που χρησιμοποιεί κλειδί API. Αν ο client σας υποστηρίζει σύνδεση OAuth HumanDesign.ai, χρησιμοποιήστε αυτή τη ροή όταν χρειάζεστε πρόσβαση συνδεδεμένη με λογαριασμό, όπως αποθηκευμένα δεδομένα πλατφόρμας· τα δικαιώματα και η διαθεσιμότητα OAuth επιλέγονται κατά τη σύνδεση.
Το επίσημο endpoint MCP είναι https://mcp.humandesign.ai/. Χρησιμοποιήστε το POST / για αιτήματα MCP. GET / δεν αποτελεί έλεγχο σύνδεσης και επιστρέφει 405 Method Not Allowed. POST /mcp είναι ψευδώνυμο συμβατότητας.
Προσθέστε με ασφάλεια το κλειδί API σας
Χρησιμοποιήστε μία από αυτές τις κεφαλίδες αιτήματος. Μην τοποθετείτε κλειδί API σε URL, μην το καταχωρίζετε σε αποθετήριο και μην το επικολλάτε σε συνομιλία.
Authorization: Bearer YOUR_HDAI_API_KEY
ή:
X-Api-Key: YOUR_HDAI_API_KEY
Συνδεθείτε και εντοπίστε τα εργαλεία σας
- Ρυθμίστε τον MCP client σας με
https://mcp.humandesign.ai/. - Στείλτε
initializeμε έκδοση πρωτοκόλλου2025-11-25. - Στείλτε
notifications/initialized. - Καλέστε
tools/listκαι χρησιμοποιήστε μόνο τα εργαλεία που επιστρέφονται για το κλειδί σας.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Οι κλήσεις ανακάλυψης όπως initialize, ping, και tools/list δεν καταναλώνουν όριο υπολογισμού. Μια επιτυχής tools/call καταναλώνει μία κοινή μονάδα API· οι αποτυχίες επικύρωσης και τα μη διαθέσιμα εργαλεία δεν καταναλώνουν.
Κλήση εργαλείου
Χρησιμοποιήστε το όνομα εργαλείου και το σχήμα εισόδου που επιστρέφονται από το tools/list. Για παράδειγμα, ένα βασικό αίτημα χάρτη έχει την εξής μορφή:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core"
}
}
}
Ανάγνωση αποτελέσματος
Οι επιτυχημένες κλήσεις επιστρέφουν σύντομη ευανάγνωστη σύνοψη, μπλοκ κειμένου JSON και structuredContent. Η δομημένη απάντηση χρησιμοποιεί περίβλημα με έκδοση και version, tool, data, meta, καθώς και προαιρετικό πεδίο error .
Ο τρέχων κατάλογος υπολογισμού και αναφοράς παρέχει μόνο εργαλεία. Μην αναμένετε προτροπές MCP, πόρους MCP, εργαλεία δημιουργίας αναφορών, συνεδρίες διακομιστή ή μπλοκ εικόνων χαρτών από αυτόν τον κατάλογο.