HumanDesign.aiMCPÖppna appen ↗
FÖR DIN AIDokumentation
Snabbstart

Anslut din agent i fyra steg.

För Claude, ChatGPT eller Codex rekommenderas OAuth eftersom det på ett säkert sätt kan ge åtkomst till den inloggade användarens tillåtna HumanDesign.ai-verktyg.

1. Lägg till den driftade slutpunkten

Slutpunkt

https://mcp.humandesign.ai/

Välj remote HTTP eller Streamable HTTP. Lägg inte till /mcp igen: den kanoniska slutpunkten är domänroten.

2. Autentisera

Använd klientens MCP-åtgärd för autentisering eller anslutning och slutför inloggningen till HumanDesign.ai i webbläsaren. Claude Code-användare kan köra claude mcp login human-design-ai; Codex-användare kan köra codex mcp login human_design_ai.

Om du endast behöver de sex beräknings- och referensverktygen finns API-nyckeln fortfarande via Bearer- eller X-Api-Key autentisering.

3. Hitta dina verktyg

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Verktygsupptäckt är kostnadsfri. OAuth-synligheten för verktyg följer användarens serverhärledda funktionsbeviljanden samt medlemskap i Free, Individual, Personal eller Pro, arbetsyteroll, ägarskap och produktbehörigheter. Synligheten för API-nycklar följer den separata API-planen Free, Creator, Startup eller Business.

4. Börja med ditt primära diagram

Be agenten att anropa chart_get_primary. Om det inte finns något primärt diagram kan medlemmar i Free, Individual, Personal och Pro använda chart_generate: granska först de normaliserade födelseuppgifterna och förhandsvisningen som kostar en enhet, och bekräfta sedan körningen. Det sparade diagrammet identifieras via kontots ägarskap, aldrig genom att söka efter ett namn som ”Kyle” eller ”Mitt diagram”. Personal eller Pro krävs för att läsa andra personers diagram som du har behörighet till.

Anslutning, initialize, ping, tools/list, läsning av bibliotek, statuskontroller och återgivning av befintliga diagram förbrukar inga krediter. En nyberäkning av ett primärt diagram förbrukar exakt en beräkningsenhet; återgivningen medför ingen ytterligare debitering.

Så fungerar säker beräkning

Agenten beräknar inte diagrammet själv. HumanDesign.ai validerar datum, plats, IANA-tidszon och sommartidskontext innan kvoten används och returnerar sedan den versionshanterade beräkningen från sin tjänst. Tvetydiga platser och ogiltiga uppgifter ger ett tydligt fel utan att förbruka en enhet. Om födelsetiden är okänd registrerar tjänsten lokal lunchtid och varnar för att tidskänsliga diagramdetaljer kan skilja sig.

Säkra omförsök av beräkningar

MCP-verktygen som förbrukar kvot generate_chart, generate_composite_chart, och get_transits kräver en idempotencyKey. Återanvänd samma nyckel med identiska normaliserade argument för ett avsett omförsök och använd en ny nyckel för nytt arbete. Ett matchande omförsök förbrukar ingen extra kvot och kan beräkna resultatet deterministiskt på nytt; det är inte en byte-för-byte-återgivning av ett lagrat svar. MCP-anrop för transiter kräver ett uttryckligt datum, så att ett omförsök alltid avser samma tidpunkt. REST- och Agent HTTP-klienter kan skicka Idempotency-Key för avgränsade operationer utan strömning där det stöds. Under kompatibilitetsutrullningen är den valfri, så anrop utan den kan inte slå samman ett transportomförsök. Batch och SSE avvisar omförsöksnycklar från anroparen och omfattas inte av avtalet om deduplicering av omförsök.

Testa råprotokollet

Utvecklare som använder en API-nyckel kan initiera och anropa ett beräkningsverktyg direkt:

Initiera

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

Beräkningsanrop

{
  "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älj klient

Claude · Codex · Cursor · VS Code · Nedladdningar av plugin

Till toppen ↑Behöver du hjälp? Kontakta support ↗

Hitta ditt nästa svar.