Opret forbindelse til HumanDesign.ai MCP
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
- Konfigurer din MCP-klient med
https://mcp.humandesign.ai/. - Send
initializemed protokolversion2025-11-25. - Send
notifications/initialized. - Kald
tools/listog 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.