Ajanınızı 4 adımda bağlayın.
Claude, ChatGPT veya Codex için OAuth önerilen bağlantı yöntemidir; oturum açmış kullanıcının izin verilen HumanDesign.ai araçlarını güvenle sunabilir.
1. Barındırılan uç noktayı ekleyin
Uç nokta
https://mcp.humandesign.ai/Uzak HTTP veya Streamable HTTP'yi seçin. Şunu tekrar eklemeyin: /mcp , kanonik uç nokta alan adının köküdür.
2. Kimlik doğrulaması yapın
İstemcinin MCP Authenticate veya Connect eylemini kullanın ve HumanDesign.ai tarayıcı oturum açma işlemini tamamlayın. Claude Code kullanıcıları şunu çalıştırabilir: claude mcp login human-design-aiCodex kullanıcıları şunu çalıştırabilir: codex mcp login human_design_ai.
Yalnızca altı hesaplama/referans aracına ihtiyacınız varsa API anahtarı Bearer veya X-Api-Key kimlik doğrulaması üzerinden kullanılabilir.
3. Araçlarınızı keşfedin
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Keşif ücretsizdir. OAuth araç görünürlüğü, sunucudan türetilen kullanıcı özellik izinlerini, Free/Individual/Personal/Pro üyeliğini, çalışma alanı rolünü, sahipliği ve ürün yetkilerini izler. API anahtarı görünürlüğü ise ayrı Free/Creator/Startup/Business API planına bağlıdır.
4. Birincil grafiğinizle başlayın
Ajandan şunu çağırmasını isteyin: chart_get_primary. Birincil grafik yoksa Free, Individual, Personal ve Pro üyeleri şunu kullanabilir: chart_generate: önce normalleştirilmiş doğum bilgilerini ve tek birimlik önizlemeyi gözden geçirin, ardından çalıştırmayı onaylayın. Kaydedilen grafik adla arama yapılarak değil, hesap sahipliğiyle bulunur; “Kyle” veya “Grafiğim” gibi adlar aranmaz. Başkalarının yetkili grafiklerini okumak için Personal veya Pro gerekir.
Bağlantı, initialize, ping, tools/list, kitaplık okumaları, durum denetimleri ve mevcut grafik görsellerinin oluşturulması kredi tüketmez. Yeni birincil grafik hesaplaması tam olarak bir hesaplama birimi tüketir; görselini oluşturmak ikinci bir ücret getirmez.
Hesaplama güveni nasıl sağlanır?
Ajan grafiği kendisi hesaplamaz. HumanDesign.ai; kota tüketilmeden önce tarihi, konumu, IANA saat dilimini ve yaz saati uygulaması bağlamını doğrular, ardından hesaplama hizmetinden sürümlenmiş sonucu döndürür. Belirsiz konumlar ve geçersiz girdiler birim harcamadan açık bir hata döndürür. Doğum saati bilinmiyorsa hizmet yerel öğlen saatini kullandığını kaydeder ve saate duyarlı grafik ayrıntılarının farklı olabileceği konusunda uyarır.
Güvenli hesaplama yeniden denemeleri
Kota tüketen MCP araçları generate_chart, generate_composite_chart, ve get_transits bir idempotencyKeygerektirir. Amaçlanan tek bir yeniden deneme için aynı anahtarı aynı normalleştirilmiş bağımsız değişkenlerle yeniden kullanın; yeni bir işlem için yeni anahtar kullanın. Eşleşen bir yeniden deneme ek kota tüketmez ve sonucu deterministik olarak yeniden hesaplayabilir; saklanan bir yanıtın bayt bayt tekrarı değildir. MCP transit çağrıları, yeniden denemenin aynı ana ait olması için açık tarih gerektirir. Doğrudan REST ve Agent HTTP istemcileri desteklenen, sınırlandırılmış ve akışsız işlemlerde Idempotency-Key gönderebilir; uyumluluk aşamasında isteğe bağlıdır, bu yüzden bunu içermeyen çağrılar aktarım yeniden denemesini tekilleştiremez. Batch ve SSE, çağıranın yeniden deneme anahtarlarını reddeder ve bu yeniden deneme tekilleştirme sözleşmesinin dışındadır.
Ham protokol testi
API anahtarı kullanan geliştiriciler bir hesaplama aracını doğrudan başlatıp çağırabilir:
Başlatma
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Hesaplama çağrısı
{
"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"
}
}
}İstemcinizi seçin
Claude · Codex · Cursor · VS Code · Eklenti indirmeleri