HumanDesign.ai MCP'ye bağlanın
Başlamadan önce
HumanDesign.ai MCP, uyumlu yapay zekâ istemcilerine yapılandırılmış Human Design araçları sunar. Bu kılavuz, API anahtarı kullanan hesaplama ve referans kataloğunu açıklar. İstemciniz HumanDesign.ai OAuth bağlantısını destekliyorsa, kaydedilmiş platform verileri gibi hesaba bağlı erişim gerektiğinde bu yöntemi kullanın; izinler ve kullanılabilirlik oturum açarken belirlenir.
Kanonik MCP uç noktası: https://mcp.humandesign.ai/olup MCP istekleri için POST / kullanın. GET / bir bağlantı testi değildir ve 405 Method Not Allowed. POST /mcp bir uyumluluk takma adıdır.
API anahtarınızı güvenle ekleyin
Aşağıdaki istek başlıklarından birini kullanın. API anahtarını URL'ye koymayın, depoya kaydetmeyin veya sohbete yapıştırmayın.
Authorization: Bearer YOUR_HDAI_API_KEY
ya da:
X-Api-Key: YOUR_HDAI_API_KEY
Bağlanın ve araçlarınızı keşfedin
- MCP istemcinizi şu ayarla yapılandırın:
https://mcp.humandesign.ai/. - Gönderin:
initializeprotokol sürümüyle2025-11-25. - Gönderin:
notifications/initialized. - Çağırın:
tools/listve yalnızca anahtarınız için döndürülen araçları kullanın.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
gibi keşif çağrıları initialize, ping, ve tools/list hesaplama kotasını tüketmez. Başarılı bir tools/call bir ortak API birimi tüketir; doğrulama hataları ve kullanılamayan araçlar tüketmez.
Bir aracı çağırın
Şu tarafından döndürülen araç adını ve girdi şemasını kullanın: tools/list. Örneğin temel grafik isteği şöyle görünür:
{
"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"
}
}
}
Sonucu okuyun
Başarılı çağrılar kısa ve okunabilir bir özet, JSON metin bloğu ve structuredContentsunar. Yapılandırılmış yanıt, sürümlenmiş bir zarf içinde version, tool, data, metave isteğe bağlı error alanını kullanır.
Mevcut hesaplama/referans kataloğu yalnızca araçları sunar. MCP istemleri, MCP kaynakları, rapor oluşturma araçları, sunucu oturumları veya grafik görseli blokları beklemeyin.