Подключите агента за четыре шага.
Для Claude, ChatGPT или Codex рекомендуется OAuth: он безопасно предоставляет доступ к разрешённым инструментам HumanDesign.ai вошедшего пользователя.
1. Добавьте размещённую конечную точку
Конечная точка
https://mcp.humandesign.ai/Выберите удалённый 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 и переход на летнее время, а затем возвращает результат с указанием версии из своей службы расчётов. Неоднозначные местоположения и неверные входные данные приводят к понятной ошибке без расходования единицы. Если время рождения неизвестно, служба указывает, что использовалось местное время 12:00, и предупреждает о возможных отличиях зависящих от времени данных карты.
Безопасные повторные попытки расчёта
Для инструментов 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 · Загрузки плагинов