Verbind je agent in vier stappen.
Voor Claude, ChatGPT of Codex is OAuth de aanbevolen verbinding, omdat hiermee de toegestane HumanDesign.ai-tools van de aangemelde gebruiker veilig beschikbaar komen.
1. Voeg het gehoste eindpunt toe
Eindpunt
https://mcp.humandesign.ai/Kies voor remote HTTP of Streamable HTTP. Voeg /mcp niet opnieuw toe: het canonieke eindpunt is de hoofddomeinroute.
2. Verifieer je identiteit
Gebruik de MCP-actie Authenticate of Connect van de client en voltooi de HumanDesign.ai-browseraanmelding. Claude Code-gebruikers kunnen uitvoeren claude mcp login human-design-ai; Codex-gebruikers kunnen uitvoeren codex mcp login human_design_ai.
Als je alleen de zes reken- en referentietools nodig hebt, kun je nog steeds een API-sleutel gebruiken via Bearer- of X-Api-Key verificatie.
3. Ontdek je tools
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Ontdekken is gratis. De OAuth-zichtbaarheid van tools volgt de door de server afgeleide bevoegdheidstoekenningen, het Free/Individual/Personal/Pro-lidmaatschap, de werkruimterol, het eigendom en productmachtigingen van de gebruiker. De zichtbaarheid van API-sleutels volgt het afzonderlijke API-plan Free/Creator/Startup/Business.
4. Begin met je hoofdchart
Vraag de agent om aan te roepen chart_get_primary. Als er geen hoofdchart bestaat, kunnen leden van Free, Individual, Personal en Pro chart_generate: controleer eerst de genormaliseerde geboortegegevens en de preview van één eenheid en bevestig daarna de uitvoering. De opgeslagen chart wordt opgehaald op basis van accounteigendom, nooit via een naamzoekopdracht zoals “Kyle” of “My Chart”. Voor de geautoriseerde charts van anderen is Personal of Pro vereist.
Verbinding, initialize, ping, tools/list, bibliotheeklezingen, statuscontroles en het weergeven van bestaande charts verbruiken geen tegoed. Een nieuwe hoofdchartberekening verbruikt precies één rekeneenheid; bij het weergeven komt er geen tweede afschrijving bij.
Hoe betrouwbare berekeningen werken
De agent berekent de chart niet zelf. HumanDesign.ai valideert de datum, locatie, IANA-tijdzone en zomertijdcontext voordat quota wordt verbruikt en retourneert vervolgens het geversioneerde resultaat van de rekendienst. Onduidelijke locaties en ongeldige invoer geven een duidelijke fout zonder een eenheid te verbruiken. Als de geboortetijd onbekend is, registreert de service dat lokale middag is gebruikt en waarschuwt deze dat tijdgevoelige chartdetails kunnen afwijken.
Veilig opnieuw proberen bij berekeningen
MCP-tools die quota verbruiken generate_chart, generate_composite_chart, en get_transits vereisen een idempotencyKey. Hergebruik dezelfde sleutel met identieke genormaliseerde argumenten voor één bedoelde nieuwe poging en gebruik een nieuwe sleutel voor nieuwe taken. Een overeenkomende nieuwe poging verbruikt geen extra quota en kan het resultaat deterministisch opnieuw berekenen; het is geen byte-voor-byteweergave van een opgeslagen antwoord. MCP-transitaanroepen vereisen een expliciete datum zodat een nieuwe poging altijd naar hetzelfde moment verwijst. Rechtstreekse REST- en Agent HTTP-clients kunnen verzenden Idempotency-Key voor ondersteunde, begrensde bewerkingen zonder streaming; deze blijft optioneel tijdens de compatibiliteitsfase, dus aanroepen zonder deze sleutel kunnen een transportpoging niet ontdubbelen. Batch en SSE weigeren door de client opgegeven herhaalsleutels en vallen buiten dit contract voor deduplicatie van pogingen.
Ruwe protocoltest
Ontwikkelaars met een API-sleutel kunnen een rekentool rechtstreeks initialiseren en aanroepen:
Initialiseren
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Rekenaanroep
{
"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"
}
}
}Kies je client
Claude · Codex · Cursor · VS Code · Plug-indownloads