API-ключи и OAuth
К концу этой страницы вы будете знать:
- как получить, сохранить, обновить и отозвать API-ключ;
- как ключ ограничивает агента одним проектом;
- как подключить claude.ai и ChatGPT по OAuth, не отдавая им ключ;
- что делать, если письмо для подтверждения почты не пришло.
Подтверждение почты
Заголовок раздела «Подтверждение почты»-
Зарегистрируйтесь на app.mmwhub.ru. При регистрации нужно отметить две обязательные галочки: согласие на обработку персональных данных и согласие с соглашением и политикой.
-
Откройте письмо от
noreply@mmwhub.techи перейдите по ссылке. Кабинет покажет «Почта подтверждена». -
Если письма нет, проверьте папку «Спам». Чтобы получить письмо снова, введите почту и пароль на странице входа: кабинет скажет, что почта не подтверждена, и покажет кнопку «Отправить письмо ещё раз». Повторно письмо уходит не чаще раза в минуту и не больше трёх раз в час.
Пока почта не подтверждена, войти в кабинет нельзя, а ссылки на ваши файлы в MMW Cloud не открываются. Аккаунты, которые уже оплачивали тариф, работают как раньше.
Подтверждённая почта нужна, в частности, чтобы принять приглашение в организацию.
API-ключ
Заголовок раздела «API-ключ»Ключ — это то, чем агент подтверждает, что действует от вашего имени. Свойства:
| Свойство | Значение |
|---|---|
| Формат | Начинается с mmw_ |
| Где передаётся | Заголовок Authorization: Bearer mmw_… или переменная MMW_API_KEY для mmw-agent. Никогда не в URL |
| Показ | Секрет показывается один раз |
| Хранение на сервере | Только хеш PBKDF2 и индекс для поиска; открытого ключа на сервере не остаётся |
| Отзыв | Действует сразу: следующий вызов с этим ключом получит отказ 401 |
Личный ключ
Заголовок раздела «Личный ключ»В кабинете, раздел «API-токен и подключение»:
| Кнопка | Что делает |
|---|---|
| «Показать» | Показывает секрет один раз. Повторно: «Уже показаны. Обновите их, чтобы создать новый секрет.» Новый ключ ждёт показа не дольше 7 дней — потом MMW перестаёт его хранить, и для работы нужно «Обновить» |
| «Обновить» | Отзывает текущий ключ и создаёт новый. Новый секрет показывается сразу, один раз, в ответе на нажатие — сохраните его; повторно его не показать. Подключения claude.ai и ChatGPT, которые вы разрешили этим ключом, отключаются вместе со старым ключом. Для отозванного ключа кнопка недоступна |
| «Отозвать» | Отключает ключ и подключения claude.ai и ChatGPT, разрешённые этим ключом. Чтобы продолжить работу, нажмите «Выпустить новый ключ» |
| «Выпустить новый ключ» | Появляется, когда активного ключа нет. Создаёт новый ключ и показывает его один раз, сразу после нажатия. Одновременно может быть до 5 активных личных ключей |
Ключ в организации
Заголовок раздела «Ключ в организации»В организации каждый выпускает ключ себе сам на вкладке «Ключи», а администратор видит и отзывает ключи, но не может их показать. Подробнее — Приглашения и ключи.
Журнал ключей
Заголовок раздела «Журнал ключей»Каждое действие с ключом (выпуск, показ, «Обновить», «Отозвать», выдача токена claude.ai или ChatGPT) записывается в вашу память MMW: когда, кто, с какого IP и из какого браузера. Ищите записи «Безопасность MMW». Подробнее: Журнал безопасности ключей.
Ключ и проект
Заголовок раздела «Ключ и проект»Аккаунт делится на проекты, проект — на рабочие области. Ключ можно привязать к проекту: агент с таким ключом видит только записи этого проекта и не может работать с рабочими областями другого. Новый ключ после «Обновить» привязывается к проекту по умолчанию.
Так удобно разделять, например, рабочий проект и личные заметки: два клиента, два ключа, две независимые памяти. Подробнее — Проекты и рабочие области.
OAuth: claude.ai и ChatGPT
Заголовок раздела «OAuth: claude.ai и ChatGPT»Веб-версии ассистентов не запускают локальный агент и не хранят ваш ключ в конфигурации. Они подключаются к MMW по OAuth: вы один раз подтверждаете доступ на странице MMW, а ассистент получает собственный токен на 30 дней. Ваш API-ключ ассистенту не передаётся.
- «Настройки → Коннекторы → Добавить свой коннектор».
- URL:
https://mcp.mmwhub.ru/mcp. - На странице MMW вставьте API-ключ и нажмите «Разрешить».
Подробнее — claude.ai.
- Включите режим разработчика (Developer mode) и добавьте коннектор с адресом
https://mcp.mmwhub.ru/mcp. - Откроется страница согласия MMW (для клиентов OpenAI она на английском).
- Войдите почтой и паролем аккаунта MMW или API-ключом и подтвердите доступ.
Подключение ChatGPT проверено в приёмке Core; доступность приложения и собственного OAuth зависит от вашего аккаунта ChatGPT. Подробнее — ChatGPT.
claude.ai / ChatGPT MMW ─────────────────── ─── «подключить коннектор» → страница согласия: вы вводите ключ или пароль ← ассистент получает свой токен на 30 дней вызов remember/search → токен проверяется, ключ ассистент не виделКогда токен ассистента перестаёт работать
Заголовок раздела «Когда токен ассистента перестаёт работать»Токен ассистента живёт 30 дней. Раньше он отключается в таких случаях:
| Как вы подключали | Что отключает токен |
|---|---|
| API-ключом | «Обновить» или «Отозвать» этого ключа в кабинете; кнопка «Отключить» у подключения |
| Почтой и паролем | Смена или сброс пароля; кнопка «Отключить» у подключения. Обновление ключа в кабинете такое подключение не трогает |
Все подключения claude.ai и ChatGPT видны в кабинете, на странице «Клиенты и ключ», в блоке «Подключения claude.ai и ChatGPT». У каждого есть своя кнопка «Отключить».
Частые ошибки
Заголовок раздела «Частые ошибки»| Симптом | Причина | Что делать |
|---|---|---|
401 при каждом вызове | Ключ отозван, обновлён или скопирован не полностью | Скопируйте актуальный ключ; при необходимости нажмите «Обновить» или «Выпустить новый ключ» |
| claude.ai или ChatGPT перестал видеть память | Ключ, которым вы разрешили доступ, обновлён или отозван, либо сменён пароль | Подключите коннектор заново |
| «У вас уже 5 активных ключей» | Достигнут предел личных ключей | Отзовите ненужный ключ и выпустите новый |
| «Уже показаны» при попытке показать ключ | Секрет показывается один раз | «Обновить» — создаст новый ключ, старый перестанет работать |
| Агент не видит записи, сохранённые из другого клиента | Ключи привязаны к разным проектам | Используйте ключ того же проекта |
| «Письмо уже отправлено недавно» | Повторная отправка чаще раза в минуту | Подождите минуту |