HumanDesign.aiMCPОткрыть приложение ↗
ДЛЯ ВАШЕГО ИИДокументация
Краткое руководство

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

Для 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 · Загрузки плагинов

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

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