Koble til agenten på fire trinn.
For Claude, ChatGPT eller Codex anbefales OAuth som tilkobling fordi den trygt kan vise HumanDesign.ai-verktøyene den innloggede brukeren har tilgang til.
1. Legg til det driftede endepunktet
Endepunkt
https://mcp.humandesign.ai/Velg Remote HTTP eller Streamable HTTP. Ikke legg til /mcp igjen: det kanoniske endepunktet er domenets rotsti.
2. Autentiser
Bruk klientens MCP Authenticate- eller Connect-handling, og fullfør HumanDesign.ai-innloggingen i nettleseren. Claude Code-brukere kan kjøre claude mcp login human-design-ai; Codex-brukere kan kjøre codex mcp login human_design_ai.
Hvis du bare trenger de seks beregnings- og referanseverktøyene, er en API-nøkkel fortsatt tilgjengelig via Bearer- eller X-Api-Key autentisering.
3. Finn verktøyene dine
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Oppdagelse er gratis. Synligheten til OAuth-verktøy følger brukerens serveravledede funksjonsbevillinger, Free/Individual/Personal/Pro-medlemskap, arbeidsområderolle, eierskap og produkttilganger. Synligheten til API-nøkler følger det separate Free/Creator/Startup/Business API-abonnementet.
4. Start med primærdiagrammet
Be agenten om å kalle chart_get_primary. Hvis det ikke finnes noe primærdiagram, kan medlemmer med Free, Individual, Personal og Pro bruke chart_generate: kontroller først normaliserte fødselsopplysninger og forhåndsvisningen på én enhet, og bekreft deretter kjøringen. Det lagrede diagrammet finnes via kontoeierskap, aldri ved å søke etter et navn som “Kyle” eller “My Chart”. Personal eller Pro kreves for å lese andres autoriserte diagrammer.
Tilkobling, initialize, ping, tools/list, biblioteksoppslag, statuskontroller og gjengivelse av eksisterende diagrammer bruker ikke kreditter. En ny beregning av primærdiagrammet bruker nøyaktig én beregningsenhet; gjengivelse gir ingen ekstra belastning.
Slik fungerer pålitelige beregninger
Agenten beregner ikke diagrammet selv. HumanDesign.ai validerer dato, sted, IANA-tidssone og sommertidskontekst før kvoten brukes, og returnerer deretter det versjonerte resultatet fra beregningstjenesten. Tvetydige steder og ugyldige inndata gir en tydelig feil uten å bruke en enhet. Hvis fødselstidspunktet er ukjent, registrerer tjenesten at lokal middag ble brukt, og varsler om at tidsfølsomme diagramdetaljer kan variere.
Trygge nye beregningsforsøk
MCP-verktøyene som bruker kvote generate_chart, generate_composite_chart, og get_transits krever en idempotencyKey. Bruk den samme nøkkelen med identiske normaliserte argumenter for ett tilsiktet nytt forsøk, og bruk en ny nøkkel for nytt arbeid. Et tilsvarende nytt forsøk bruker ingen ekstra kvote og kan beregne resultatet deterministisk på nytt; det er ikke en byte-for-byte-avspilling av et lagret svar. MCP-transittkall krever en eksplisitt dato, slik at et nytt forsøk alltid gjelder samme tidspunkt. Direkte REST- og Agent HTTP-klienter kan sende Idempotency-Key på støttede, avgrensede operasjoner uten strømming; den er fortsatt valgfri under kompatibilitetsutrullingen, så kall uten den kan ikke deduplisere et nytt transportforsøk. Batch og SSE avviser nye forsøksnøkler fra klienten og omfattes ikke av denne avtalen om deduplisering.
Testing av råprotokollen
Utviklere med API-nøkkel kan initialisere og kalle et beregningsverktøy direkte:
Initialiser
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Beregningskall
{
"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"
}
}
}Velg klient
Claude · Codex · Cursor · VS Code · Nedlastinger av programtillegg