Вход, люди и ключи
Вход в консоль, подключение колыбели, первый владелец, приглашение людей, роли и ключи 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:infer | POST /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: … при выпуске —
скоупа нет в таблице выше.