HumanDesign.aiPersonalÅbn app ↗
TIL DIG SELVHjælpecenter

Opret forbindelse til HumanDesign.ai MCP

APIOpdateret 28. aug. 20262 minutters læsning

Før du begynder

HumanDesign.ai MCP giver kompatible AI-klienter strukturerede Human Design-værktøjer. Denne vejledning gennemgår beregnings- og referencekataloget, der bruger en API-nøgle. Hvis din klient understøtter HumanDesign.ai OAuth-forbindelse, skal du bruge den, når du har brug for kontotilknyttet adgang, f.eks. gemte platformdata. OAuth-rettigheder og tilgængelighed vælges ved login.

Det kanoniske MCP-endpoint er https://mcp.humandesign.ai/ . Brug POST / til MCP-anmodninger. GET / er ikke en forbindelsestest og returnerer 405 Method Not Allowed. POST /mcp er et kompatibilitetsalias.

Tilføj din API-nøgle sikkert

Brug en af disse request-headers. Indsæt ikke en API-nøgle i en URL, commit den i et repository, eller indsæt den i en chat.

Authorization: Bearer YOUR_HDAI_API_KEY

eller:

X-Api-Key: YOUR_HDAI_API_KEY

Opret forbindelse, og find dine værktøjer

  1. Konfigurer din MCP-klient med https://mcp.humandesign.ai/.
  2. Send initialize med protokolversion 2025-11-25.
  3. Send notifications/initialized.
  4. Kald tools/list og brug kun de værktøjer, der returneres til din nøgle.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Opdagelseskald som initialize, ping, og tools/list bruger ikke beregningskvoten. Et vellykket tools/call forbruger én fælles API-enhed; valideringsfejl og utilgængelige værktøjer gør ikke.

Kald et værktøj

Brug værktøjsnavnet og inputschemaet, der returneres af tools/list . Et grundlæggende diagramkald har f.eks. denne form:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core"
    }
  }
}

Læs svaret

Vellykkede kald returnerer et kort, læsbart resumé, en JSON-tekstblok og structuredContent . Det strukturerede svar bruger en versionsstyret kuvert med version, tool, data, metaog et valgfrit error -felt.

Det aktuelle katalog over beregning og reference indeholder kun værktøjer. Forvent ikke MCP-prompts, MCP-ressourcer, rapportgenereringsværktøjer, serversessioner eller diagram-billedblokke fra dette katalog.

Tilbage til toppen ↑Brug for hjælp? Kontakt support ↗

Find dit næste svar.