HumanDesign.aiMCPВідкрити застосунок ↗
ДЛЯ ВАШОГО ШІДокументація
Короткий посібник

Підключіть агента за чотири кроки.

Для Claude, ChatGPT або Codex рекомендовано підключення OAuth, оскільки воно безпечно надає доступ до дозволених інструментів HumanDesign.ai користувача, який увійшов у систему.

1. Додайте розміщену кінцеву точку

Кінцева точка

https://mcp.humandesign.ai/

Виберіть Remote HTTP або Streamable HTTP. Не додавайте /mcp повторно: канонічною кінцевою точкою є кореневий домен.

2. Автентифікуйтеся

Скористайтеся дією Authenticate або Connect клієнта MCP і завершіть вхід через браузер HumanDesign.ai. Користувачам Claude Code потрібно виконати claude mcp login human-design-ai; користувачам Codex — codex mcp login human_design_ai.

Якщо потрібні лише шість інструментів розрахунку й довідки, ключ API можна використовувати з автентифікацією Bearer або X-Api-Key автентифікацією.

3. Знайдіть доступні інструменти

JSON-RPC

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

Виявлення інструментів безкоштовне. Видимість інструментів OAuth визначається внутрішніми дозволами користувача, тарифом Free/Individual/Personal/Pro, роллю в робочому просторі, правами власності й доступними функціями продукту. Видимість інструментів API залежить від окремого тарифу API Free/Creator/Startup/Business.

4. Почніть із основної карти

Попросіть агента викликати chart_get_primary. Якщо основної карти ще немає, учасники Free, Individual, Personal і Pro можуть скористатися chart_generate: спочатку перевірити нормалізовані дані про народження й попередній перегляд за одну одиницю, потім підтвердити виконання. Збережена карта визначається за правом власності на обліковий запис, а не пошуком імені на кшталт «Кайл» або «Моя карта». Для читання авторизованих карт інших людей потрібен Personal або Pro.

Підключення, initialize, ping, tools/list, читання бібліотеки, перевірки статусу й візуалізація наявних карт не витрачають кредити. Новий розрахунок основної карти витрачає рівно одну одиницю; візуалізація не спричиняє повторного списання.

Як забезпечується надійність розрахунків

Агент не розраховує карту самостійно. Перед списанням квоти HumanDesign.ai перевіряє дату, місце, часовий пояс IANA й умови переходу на літній час, а потім повертає результат із номером версії зі своєї служби розрахунків. Неоднозначне місце або некоректні дані спричиняють чітке повідомлення про помилку без витрати одиниці. Якщо час народження невідомий, служба вказує, що використала місцевий полудень, і попереджає, що чутливі до часу деталі карти можуть відрізнятися.

Безпечне повторення запитів на розрахунок

Для інструментів MCP, що витрачають квоту, generate_chart, generate_composite_chart, а get_transits потрібен idempotencyKey . Для однієї запланованої повторної спроби використовуйте той самий ключ із тотожними нормалізованими аргументами; для нової роботи створюйте новий ключ. Повторний запит із тим самим ключем не витрачає додаткову квоту й може детерміновано перерахувати результат; він не відтворює збережену відповідь побайтово. Для запитів транзитів MCP потрібно вказати дату, щоб повторний виклик завжди стосувався того самого моменту. Клієнти прямого REST і Agent HTTP можуть передавати Idempotency-Key для підтримуваних обмежених операцій без потокового передавання; під час розгортання сумісності це поле необов’язкове, тому виклики без нього не усувають повтори транспортних запитів. Для Batch і SSE ключі повтору від клієнта відхиляються; ці режими не входять до контракту дедуплікації повторів.

Перевірка необробленого протоколу

Розробники з ключем API можуть ініціалізувати з’єднання й безпосередньо викликати інструмент розрахунку:

Ініціалізація

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

Виклик розрахунку

{
  "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"
    }
  }
}

Виберіть клієнт

Claude · Codex · Cursor · VS Code · Завантаження плагінів

Нагору ↑Потрібна допомога? Зверніться до служби підтримки ↗

Знайдіть відповідь на наступне запитання.