Συνδέστε τον agent σας σε τέσσερα βήματα.
Για Claude, ChatGPT ή Codex, συνιστάται OAuth, επειδή μπορεί να παρέχει με ασφάλεια τα επιτρεπόμενα εργαλεία HumanDesign.ai του συνδεδεμένου χρήστη.
1. Προσθέστε το φιλοξενούμενο endpoint
Endpoint
https://mcp.humandesign.ai/Επιλέξτε remote HTTP ή Streamable HTTP. Μην προσθέσετε ξανά /mcp : το επίσημο endpoint είναι η ρίζα του domain.
2. Έλεγχος ταυτότητας
Χρησιμοποιήστε την ενέργεια Authenticate ή Connect του MCP client και ολοκληρώστε τη σύνδεση στο πρόγραμμα περιήγησης HumanDesign.ai. Οι χρήστες Claude Code μπορούν να εκτελέσουν claude mcp login human-design-ai· οι χρήστες Codex μπορούν να εκτελέσουν codex mcp login human_design_ai.
Αν χρειάζεστε μόνο τα έξι εργαλεία υπολογισμού και αναφοράς, το κλειδί API εξακολουθεί να διατίθεται μέσω ελέγχου ταυτότητας Bearer ή X-Api-Key authentication.
3. Εντοπίστε τα εργαλεία σας
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Ο εντοπισμός είναι δωρεάν. Η ορατότητα εργαλείων OAuth ακολουθεί τις παραχωρήσεις δυνατοτήτων που προκύπτουν από τον διακομιστή, τη συνδρομή Free/Individual/Personal/Pro, τον ρόλο χώρου εργασίας, την ιδιοκτησία και τα δικαιώματα χρήσης του χρήστη. Η ορατότητα με κλειδί API ακολουθεί το ξεχωριστό πρόγραμμα API Free/Creator/Startup/Business.
4. Ξεκινήστε με τον κύριο χάρτη σας
Ζητήστε από τον agent να καλέσει chart_get_primary. Αν δεν υπάρχει κύριος χάρτης, τα μέλη Free, Individual, Personal και Pro μπορούν να χρησιμοποιήσουν chart_generate: ελέγξτε πρώτα τα κανονικοποιημένα στοιχεία γέννησης και την προεπισκόπηση μίας μονάδας και έπειτα επιβεβαιώστε την εκτέλεση. Ο αποθηκευμένος χάρτης εντοπίζεται με βάση την ιδιοκτησία λογαριασμού, ποτέ με αναζήτηση ονόματος όπως «Kyle» ή «My Chart». Για ανάγνωση εξουσιοδοτημένων χαρτών άλλων ατόμων απαιτείται Personal ή Pro.
Η σύνδεση, initialize, ping, tools/list, οι αναγνώσεις βιβλιοθήκης, οι έλεγχοι κατάστασης και η απεικόνιση υπάρχοντος χάρτη δεν καταναλώνουν πιστώσεις. Ένας νέος υπολογισμός κύριου χάρτη καταναλώνει ακριβώς μία μονάδα υπολογισμού· η απεικόνιση δεν προκαλεί δεύτερη χρέωση.
Πώς διασφαλίζεται η αξιοπιστία υπολογισμών
Ο agent δεν υπολογίζει ο ίδιος τον χάρτη. Το HumanDesign.ai επικυρώνει ημερομηνία, τοποθεσία, ζώνη ώρας IANA και πληροφορίες θερινής ώρας πριν καταναλωθεί όριο και, έπειτα, επιστρέφει αποτέλεσμα με έκδοση από την υπηρεσία υπολογισμών του. Ασαφείς τοποθεσίες και μη έγκυρες τιμές επιστρέφουν σαφές σφάλμα χωρίς κατανάλωση μονάδας. Αν η ώρα γέννησης είναι άγνωστη, η υπηρεσία καταγράφει ότι χρησιμοποίησε τοπικό μεσημέρι και προειδοποιεί ότι οι λεπτομέρειες του χάρτη που εξαρτώνται από την ώρα ενδέχεται να διαφέρουν.
Ασφαλείς επαναλήψεις υπολογισμού
Τα εργαλεία MCP που καταναλώνουν μονάδες generate_chart, generate_composite_chart, και get_transits απαιτούν ένα idempotencyKey. Επαναχρησιμοποιήστε το ίδιο κλειδί με τα ίδια κανονικοποιημένα ορίσματα για μία προβλεπόμενη επανάληψη και χρησιμοποιήστε νέο κλειδί για νέα εργασία. Μια αντιστοιχισμένη επανάληψη δεν καταναλώνει πρόσθετο όριο και μπορεί να επανυπολογίσει ντετερμινιστικά το αποτέλεσμα· δεν αναπαράγει byte προς byte αποθηκευμένη απάντηση. Οι κλήσεις MCP transit απαιτούν ρητή ημερομηνία, ώστε η επανάληψη να αφορά πάντα την ίδια στιγμή. Οι άμεσοι client REST και Agent HTTP μπορούν να στέλνουν Idempotency-Key σε υποστηριζόμενες λειτουργίες με περιορισμένο μέγεθος και χωρίς ροή· κατά τη σταδιακή διάθεση συμβατότητας παραμένει προαιρετικό, επομένως οι κλήσεις χωρίς αυτό δεν μπορούν να αποδιπλοποιήσουν επανάληψη μεταφοράς. Τα Batch και SSE απορρίπτουν κλειδιά επανάληψης που ορίζει ο καλών και εξαιρούνται από αυτή τη σύμβαση αποδιπλοποίησης.
Δοκιμή ακατέργαστου πρωτοκόλλου
Οι προγραμματιστές που χρησιμοποιούν κλειδί API μπορούν να αρχικοποιήσουν και να καλέσουν απευθείας ένα εργαλείο υπολογισμού:
Αρχικοποίηση
{
"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"
}
}
}Επιλέξτε client
Claude · Codex · Cursor · VS Code · Λήψεις προσθέτων