Подключение SmartNotes к Cradle

Отправляйте захваченные ноты в общую Inbox Cradle через MCP, где triage-агенты классифицируют issue и маршрутизируют их в нужный проект.

SmartNotes спроектирован как слой захвата для Cradle. Он не заменяет систему риска и тriage Cradle — он подаёт в неё чистые структурированные issue.

Как работает интеграция

SmartNotes выступает MCP-клиентом к Cradle. При подключении может вызывать два инструмента:

cradle_summarize_notes — чистит и суммаризует пачку нот, возвращает issue-карточки.
cradle_submit_issue — создаёт ticket в общей Inbox Cradle для ревью оператора.

Поток намеренно включает человека в цикл:

Вы захватываете ноты в SmartNotes.
Вы выбираете ноты и нажимаете Суммаризировать. SmartNotes вызывает cradle_summarize_notes и показывает issue-карточки.
Вы ревьюите карточки и отправляете нужные. SmartNotes вызывает cradle_submit_issue.
Cradle создаёт ticket, запускает triage по всем проектам и маршрутизирует issue в проект победившего агента.
Человек-оператор одобряет, редактирует или отклоняет ticket до того, как будет отправлен какой-либо автоответ.

Из SmartNotes нет автоответа. Каждый отправленный issue попадает на ревью оператора.

В SmartNotes Настройки → Cradle:

Включите Cradle MCP-клиент.
Введите URL сервера Cradle, например http://127.0.0.1:31416/mcp для локального сервера.
Введите API-ключ Cradle как минимум со scopes agents:execute и messages:write. Подойдёт и ключ admin:*.
Нажмите Ping, чтобы проверить соединение.

Если соединение активно, в основном UI Cradle появляется вкладка SmartNotes Inbox, и ноты могут импортироваться автоматически.

На стороне Cradle MCP-сервер должен быть включён:

В Cradle desktop: Интеграции → MCP-сервер.
Выберите хост и порт. По умолчанию для MCP-сервера Cradle это 127.0.0.1:31417.
Сохраните и запустите.

SmartNotes подключается к этому endpoint. Обе программы могут работать на одной машине или в одном доверенном LAN.

API-ключи Cradle хранятся в smartnotes-secrets.json, зашифрованные через Electron safeStorage.
Общение идёт по HTTP или HTTPS в зависимости от того, как открыт Cradle.
SmartNotes никуда не отправляет скриншоты или транскрипты, кроме настроенного сервера Cradle.
Обычные scope-checks Cradle работают: у ключа должен быть agents:execute для суммаризации и messages:write для отправки issue.

Симптом	Причина	Решение
«Connection failed»	Неверный URL или MCP-сервер Cradle не запущен	Проверьте хост/порт и что MCP-сервер включён в Cradle.
«Unauthorized»	Неверный или отозванный ключ	Создайте новый ключ в Cradle Интеграции → API-ключи.
Суммаризация не возвращает issue	Ноты пустые или модель не сработала	Захватите хотя бы одну ноту с чёткой речью и проверьте, что модель Whisper скачана.
Отправленные issue не появляются	Несовпадение проекта или не те scopes	Для теста используйте ключ `admin:*`, затем перейдите на scoped-ключ, привязанный к нужному проекту.