Forbind din agent i fire trin.
OAuth anbefales til Claude, ChatGPT og Codex, fordi det sikkert kan vise den indloggede brugers tilladte HumanDesign.ai-værktøjer.
1. Tilføj det hostede slutpunkt
Slutpunkt
https://mcp.humandesign.ai/Vælg Remote HTTP eller Streamable HTTP. Tilføj ikke /mcp igen: det kanoniske slutpunkt er domænets rodsti.
2. Godkend
Brug klientens MCP Authenticate- eller Connect-handling, og gennemfør HumanDesign.ai-login i browseren. Claude Code-brugere kan køre claude mcp login human-design-ai; Codex-brugere kan køre codex mcp login human_design_ai.
Hvis du kun har brug for de seks beregnings- og referenceværktøjer, kan du stadig bruge en API-nøgle via Bearer- eller X-Api-Key godkendelse.
3. Find dine værktøjer
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Opdagelse er gratis. OAuth-værktøjernes synlighed følger brugerens funktionsbevillinger fra serveren, Free/Individual/Personal/Pro-medlemskab, arbejdsområderolle, ejerskab og produkttilladelser. Synligheden af API-nøgler følger det separate Free/Creator/Startup/Business-API-plan.
4. Start med dit primære diagram
Bed agenten om at kalde chart_get_primary. Hvis der ikke findes et primært diagram, kan medlemmer af Free, Individual, Personal og Pro bruge chart_generate: gennemgå først de normaliserede fødselsoplysninger og forhåndsvisningen på én enhed, og bekræft derefter kørslen. Det gemte diagram findes via kontoens ejerskab, aldrig ved at søge efter et navn som “Kyle” eller “My Chart”. Personal eller Pro kræves for at læse andres autoriserede diagrammer.
Forbindelse, initialize, ping, tools/list, biblioteksopslag, statuskontroller og gengivelse af eksisterende diagrammer bruger ikke kreditter. En ny beregning af det primære diagram bruger præcis én beregningsenhed; gengivelsen medfører ingen ekstra betaling.
Sådan fungerer pålidelige beregninger
Agenten beregner ikke diagrammet selv. HumanDesign.ai validerer dato, sted, IANA-tidszone og sommertidskontekst, før kvoten bruges, og returnerer derefter den versionsstyrede beregning fra sin beregningstjeneste. Tvetydige steder og ugyldige input giver en tydelig fejl uden at bruge en enhed. Hvis fødselstidspunktet er ukendt, registrerer tjenesten, at lokal middag blev anvendt, og advarer om, at tidsfølsomme diagramoplysninger kan afvige.
Sikre nye beregningsforsøg
De MCP-værktøjer, der bruger kvote, generate_chart, generate_composite_chart, og get_transits kræver en idempotencyKey. Genbrug den samme nøgle med identiske normaliserede argumenter ved ét tilsigtet nyt forsøg, og brug en ny nøgle til nyt arbejde. Et matchende nyt forsøg bruger ingen yderligere kvote og kan genberegne resultatet deterministisk; det er ikke en byte-for-byte-gengivelse af et gemt svar. MCP-transitkald kræver en eksplicit dato, så et nyt forsøg altid vedrører samme tidspunkt. Direkte REST- og Agent HTTP-klienter kan sende Idempotency-Key på understøttede, afgrænsede handlinger uden streaming; den er fortsat valgfri under kompatibilitetsudrulningen, så kald uden den kan ikke deduplikere et transportforsøg. Batch og SSE afviser klientens gentagenøgler og er uden for denne aftale om deduplikering.
Test af rå protokol
Udviklere med en API-nøgle kan initialisere og kalde et beregningsværktøj direkte:
Initialisering
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Beregningskald
{
"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"
}
}
}Vælg din klient
Claude · Codex · Cursor · VS Code · Plugin-downloads