HumanDesign.aiPersonalОткрыть приложение ↗
ДЛЯ ВАСЦентр помощи

Подключиться к HumanDesign.ai MCP

APIОбновлено 28 августа 2026 года2 минуты на чтение

Перед началом работы

HumanDesign.ai MCP предоставляет совместимым ИИ-клиентам структурированные инструменты Human Design. В этом руководстве описан каталог расчётов и справки, доступный по ключу API. Если ваш клиент поддерживает OAuth-подключение HumanDesign.ai, используйте его для доступа к аккаунту, например к сохранённым данным платформы; разрешения 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, инструменты создания отчётов, серверные сеансы или блоки изображений карт.

Наверх ↑Нужна помощь? Свяжитесь со службой поддержки ↗

Найдите следующий ответ.