Настройка

Вход, люди и ключи

Вход в консоль, подключение колыбели, первый владелец, приглашение людей, роли и ключи API со скоупами.

В Cradle два вида доступа. Люди входят в консоль без ключа: аккаунтом сайта или кодом из письма, а их права определяет роль в организации колыбели. Программы (боты, интеграции, CLI) ходят с ключом API и скоупами. Ключ в консоль не вводится.

1. Войдите на сайт

Откройте https://opencradle.ai/ru/console. Введите e-mail, нажмите Отправить код, введите код из письма и нажмите Войти. Кнопка Войти через Google есть не на всех сайтах.

Как проверить. Открывается консоль: слева «Команды», «Колыбели», «Безопасность», «Настройки».

Если нет.

  • «Вы в списке ожидания» — доступ к консоли открывает администратор сайта, письмо придёт на ваш e-mail.
  • «Слишком много запросов. Подождите минуту.» — подождите и запросите код снова.
  • «Код устарел или отсутствует. Запросите новый.» и «Неверный код.» — запросите новый код кнопкой Отправить повторно.

2. Подключите колыбель

Откройте Колыбели.

  • Сервер на этом же компьютере: карточка Этот компьютер → Подключить.
  • Сервер за SSH-туннелем GPU-сервера: карточка GPU-сервер → Подключить (Ключи и модели).
  • Любой другой сервер: Добавить колыбель → в окне «Новая колыбель» заполните Название и URL (например http://<хост>:31416), нажмите Проверить, затем Добавить сервер.

Колыбель, которая доверяет сайту (по умолчанию доверяют все), принимает вас без второго входа. Адрес вне вашего компьютера публикуйте по HTTPS — см. Удалённый сервер.

Как проверить. Карточка колыбели показывает «онлайн», а в таблице «КОМАНДА → КОЛЫБЕЛЬ» ниже появляются её команды.

Если нет.

  • «недоступна» — по адресу нет сервера или его закрывает сеть: проверьте curl <URL>/api/v1/health.
  • «Нужно войти» — колыбель не приняла токен сайта; нажмите Войти и пройдите шаг 4.
  • «Вас нет в организации на этой колыбели» — вас никто не добавил; шаги 3 и 5.

3. Первый владелец

Колыбель, в которой нет ни одного участника, достаётся первому человеку с действительным токеном, пришедшему с этой же машины (в том числе через SSH-туннель GPU-сервера). Он становится owner организации default. Для этого достаточно нажать Подключить на карточке Этот компьютер.

Для сервера, до которого вы добираетесь по сети, этого не будет — вы получите 403 not_a_member. Владельца заводит оператор с ключом admin:* (например, ключом установщика), одним из двух способов:

Переменная окружения службы — владелец создаётся при каждом запуске сервера:

CRADLE_BOOTSTRAP_OWNER=you@example.com

Или команда:

cradle members add --org default --email you@example.com --role owner

Новая организация вместо default: cradle members create-org <slug> --owner <e-mail> [--name <название>] [--plan free|pro]. Список организаций — cradle members orgs.

Как проверить.

cradle members list --org default

В таблице есть ваш e-mail с ролью owner.

Если нет. error: organization not found — неверный slug организации: посмотрите cradle members orgs. Если участники уже есть, автоматического владельца не будет: добавляйте людей командой выше.

4. Вход в колыбель по коду

Нужен, когда колыбель не доверяет сайту (в закрытом контуре доверие выключают CRADLE_CONSOLE_ISSUER=off) или вас добавили командой cradle members add. Карточка показывает «Нужно войти»: нажмите Войти, введите E-mail, нажмите Получить код, введите «Код из письма — 6 цифр» и нажмите Войти.

Код — 6 цифр, живёт 10 минут, на него даётся 5 попыток. Если на колыбели не настроена почта (settings.smtp в app-state.json: host, port, secure, user, password, from), письма нет, а код достаёт оператор:

cradle users code you@example.com

Тот же код печатается в журнал сервера строкой [auth] login code for <e-mail>: <код>. Получить код может только человек, которого завели: cradle users add <e-mail> или cradle members add ….

Как проверить. Карточка колыбели показывает «онлайн», открываются команды.

Если нет.

  • «Код не подошёл или истёк.» — запросите новый (Другой e-mail, затем снова Получить код).
  • «Учётная запись отключена оператором.» — cradle users enable <e-mail>.
  • «Вас нет ни в одной организации этой колыбели. Попросите владельца добавить вас» — шаг 5.
  • «Колыбель не ответила.» — проверьте адрес и сервер.

5. Пригласите людей

Оператор с ключом admin:* (<subject> в последней команде — из столбца SUBJECT списка):

cradle members add --org default --email colleague@example.com --role member
cradle members list --org default
cradle members remove --org default --subject <subject>

Человек затем добавляет колыбель в консоли и входит по коду (шаг 4). Временно закрыть доступ — cradle users disable <e-mail> (сессии отзываются), cradle users enable <e-mail> возвращает; список людей — cradle users list.

Роль определяет права человека:

РольЧто может
memberрабочий набор консоли: сообщения, агенты (читать, менять, запускать), базы знаний, тикеты (читать, одобрять), разговоры, модели, чтение команд, каналов и настроек
adminвсё это, плюс управление организацией: команды, каналы, правила риска, бюджеты, настройки; добавляет и убирает только member
ownerвсё, что admin; меняет роли и убирает админов; последнего владельца убрать нельзя

Экрана участников в консоли нет: ими управляют командами cradle members … выше.

Как проверить. cradle members list --org default показывает человека с нужной ролью.

Если нет. Человек видит 403 not_a_member — он не в организации или вход идёт в другую колыбель; проверьте e-mail в списке.

6. Ключи API и скоупы

Ключ нужен боту, интеграции, скрипту или MCP-клиенту. Выпускает его оператор с ключом admin:*. Ключ привязан к одной команде — по её id (не по slug):

cradle teams list --json
cradle keys create --name "site-bot" --scopes messages:read,messages:write --team <team-id>

В ответе teams list --json у нужной команды есть поле id — его и подставляйте в --team.

Без --team команда ответит error: team not found: personal. Ключ печатается один раз (plaintext), сервер хранит только хэш. Необязательный срок действия — --expires-at <миллисекунды Unix>. Список — cradle keys list, отзыв — cradle keys revoke <id> (полный id виден в cradle keys list --json).

В ключ можно записать только эти скоупы:

СкоупЧто открывает
messages:writeотправить сообщение в HTTP API: POST /api/v1/messages; MCP cradle_submit_issue
messages:readзабрать ответы GET /api/v1/messages/:chatId, GET /api/v1/admin/health, поток событий GET /api/v1/events
agents:read, agents:write, agents:executeчитать агентов; создавать и менять; запускать одного без тикета (POST /api/v1/admin/agents/:id/execute)
kb:read, kb:writeчитать базы знаний и искать; создавать, загружать, удалять
models:read, models:writeчитать модели и ключи провайдеров; регистрировать модели и сохранять ключи
models:inferPOST /v1/messages и GET /v1/models (Anthropic-совместимый вход)
tickets:read, tickets:approveчитать тикеты; одобрять, отклонять, переназначать
conversations:readразговоры и задачи; файлы ответов GET /api/v1/files/:id
teams:read, channels:readвидеть команды и состояние каналов
settings:read, settings:writeчитать и менять настройки колыбели
admin:*всё, включая выпуск ключей и управление людьми

Скоуп org:admin — часть роли человека, ключу его выдать нельзя (ответ 400). Ключ с admin:* может выбирать команду заголовком X-Cradle-Team: <slug>, остальные ключи работают только в своей команде.

Как проверить.

curl -s -H "Authorization: Bearer ck_live_..." http://127.0.0.1:31416/api/v1/auth/me

В ответе — "kind":"key", teamSlug и список scopes вашего ключа.

Если нет. 401 unauthorized — ключ неверен, отозван или истёк; 403 с полем missing — не хватает скоупа из этого поля; unknown scope: … при выпуске — скоупа нет в таблице выше.