HumanDesign.aiPersonalВідкрити застосунок ↗
ДЛЯ ВАСЦентр допомоги

Підключення до HumanDesign.ai MCP

APIОновлено 28 серпня 2026 р.Час читання — 2 хв

Перш ніж почати

MCP HumanDesign.ai надає сумісним клієнтам ШІ структуровані інструменти Human Design. У цьому посібнику описано обчислення та довідковий каталог, для яких використовується ключ API. Якщо ваш клієнт підтримує підключення HumanDesign.ai через OAuth, скористайтеся цим способом, коли потрібен доступ до даних облікового запису, зокрема збережених даних платформи; дозволи та доступність OAuth визначаються під час входу.

Канонічна кінцева точка MCP — https://mcp.humandesign.ai/. Використовуйте POST / для запитів MCP. GET / не є перевіркою підключення та повертає 405 Method Not Allowed. POST /mcp є сумісним псевдонімом.

Безпечно додайте ключ API

Використовуйте один із цих заголовків запиту. Не додавайте ключ API до URL, не зберігайте його в репозиторії та не вставляйте в чат.

Authorization: Bearer YOUR_HDAI_API_KEY

або:

X-Api-Key: YOUR_HDAI_API_KEY

Підключіться та знайдіть доступні інструменти

  1. Налаштуйте клієнт MCP за допомогою https://mcp.humandesign.ai/.
  2. Надішліть initialize із версією протоколу 2025-11-25.
  3. Надішліть notifications/initialized.
  4. Викличте tools/list і використовуйте лише інструменти, повернуті для вашого ключа.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Виклики пошуку, наприклад initialize, ping, а tools/list не витрачають квоту обчислень. Успішний виклик tools/call списує одну спільну одиницю API; помилки перевірки та недоступні інструменти її не списують.

Виклик інструмента

Використовуйте назву інструмента та схему введення, повернуті методом tools/list. Наприклад, запит базової карти має такий вигляд:

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

Перегляд результату

У разі успішного виклику повертається короткий читабельний підсумок, текстовий блок JSON і structuredContent. Структурована відповідь використовує версійовану оболонку з version, tool, data, metaі необов’язковим полем error .

Поточний каталог обчислень і довідкових матеріалів надає лише інструменти. Не очікуйте MCP-підказок, MCP-ресурсів, інструментів створення звітів, серверних сеансів або блоків зображень карт у цьому каталозі.

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

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