Подключиться к HumanDesign.ai MCP
Перед началом работы
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
Подключитесь и найдите доступные инструменты
- Настройте клиент MCP с помощью
https://mcp.humandesign.ai/. - Отправьте
initializeс версией протокола2025-11-25. - Отправьте
notifications/initialized. - Вызовите
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, инструменты создания отчётов, серверные сеансы или блоки изображений карт.