API-ключи и OAuth

К концу этой страницы вы будете знать:

1. как получить, сохранить, обновить и отозвать API-ключ;
2. как ключ ограничивает агента одним проектом;
3. как подключить claude.ai и ChatGPT по OAuth, не отдавая им ключ;
4. что делать, если письмо для подтверждения почты не пришло.

Подтверждение почты

1. Зарегистрируйтесь на app.mmwhub.ru. При регистрации нужно отметить две обязательные галочки: согласие на обработку персональных данных и согласие с соглашением и политикой.

2. Откройте письмо от noreply@mmwhub.tech и перейдите по ссылке. Кабинет покажет «Почта подтверждена».

3. Если письма нет — проверьте папку «Спам». Запросить письмо снова можно кнопкой «Отправить письмо ещё раз» на странице «Организации». Повторно отправить можно не чаще раза в минуту.

Подтверждённая почта нужна, в частности, чтобы принять приглашение в организацию.

API-ключ

Ключ — это то, чем агент подтверждает, что действует от вашего имени. Свойства:

Свойство	Значение
Формат	Начинается с mmw_
Где передаётся	Заголовок Authorization: Bearer mmw_… или переменная MMW_API_KEY для mmw-agent. Никогда не в URL
Показ	Секрет показывается один раз
Хранение на сервере	Только хеш PBKDF2 и индекс для поиска; открытого ключа на сервере не остаётся
Отзыв	Действует сразу: следующий вызов с этим ключом получит отказ 401

Личный ключ

В кабинете, раздел «API-токен и подключение»:

Кнопка	Что делает
«Показать»	Показывает секрет один раз. Повторно: «Уже показаны. Обновите их, чтобы создать новый секрет.»
«Обновить»	Отзывает текущий ключ и создаёт новый; новый секрет тоже можно показать один раз
«Отозвать»	Отключает ключ. Чтобы продолжить работу, выпустите новый

Ключ в организации

В организации каждый выпускает ключ себе сам на вкладке «Ключи», а администратор видит и отзывает ключи, но не может их показать. Подробнее — Приглашения и ключи.

Осторожно

Ключ даёт доступ к памяти. Не вставляйте его в чаты с ассистентом, тикеты, Git, скриншоты и письма в поддержку. Если ключ утёк — сразу нажмите «Обновить» или «Отозвать» и пропишите новый ключ в клиентах.

Ключ и проект

Аккаунт делится на проекты, проект — на рабочие области. Ключ можно привязать к проекту: агент с таким ключом видит только записи этого проекта и не может работать с рабочими областями другого. Новый ключ после «Обновить» привязывается к проекту по умолчанию.

Так удобно разделять, например, рабочий проект и личные заметки: два клиента, два ключа, две независимые памяти. Подробнее — Проекты и рабочие области.

OAuth: claude.ai и ChatGPT

Веб-версии ассистентов не запускают локальный агент и не хранят ваш ключ в конфигурации. Они подключаются к MMW по OAuth: вы один раз подтверждаете доступ на странице MMW, а ассистент получает собственный токен на 30 дней. Ваш API-ключ ассистенту не передаётся.

claude.ai

1. «Настройки → Коннекторы → Добавить свой коннектор».
2. URL: https://mcp.mmwhub.ru/mcp.
3. На странице MMW вставьте API-ключ и нажмите «Разрешить».

Подробнее — claude.ai.

ChatGPT (бета)

1. Включите режим разработчика (Developer mode) и добавьте коннектор с адресом https://mcp.mmwhub.ru/mcp.
2. Откроется страница согласия MMW (для клиентов OpenAI она на английском).
3. Войдите почтой и паролем аккаунта MMW или API-ключом и подтвердите доступ.

Подключение ChatGPT поддерживается в бета-режиме. Подробнее — ChatGPT.

  claude.ai / ChatGPT           MMW
  ───────────────────           ───
  «подключить коннектор»  →     страница согласия: вы вводите ключ или пароль
                          ←     ассистент получает свой токен на 30 дней
  вызов remember/search   →     токен проверяется, ключ ассистент не видел

Совет

Если доступ ассистента больше не нужен, удалите коннектор в настройках ассистента. Если вы вводили на странице согласия API-ключ и сомневаетесь в его сохранности — обновите ключ в кабинете.

Частые ошибки

Симптом	Причина	Что делать
401 при каждом вызове	Ключ отозван, обновлён или скопирован не полностью	Скопируйте актуальный ключ; при необходимости нажмите «Обновить»
«Уже показаны» при попытке показать ключ	Секрет показывается один раз	«Обновить» — создаст новый ключ, старый перестанет работать
Агент не видит записи, сохранённые из другого клиента	Ключи привязаны к разным проектам	Используйте ключ того же проекта
«Письмо уже отправлено недавно»	Повторная отправка чаще раза в минуту	Подождите минуту

Что дальше

Подключение клиентов Куда вписать ключ в каждом клиенте.

Безопасность Хеши ключей, изоляция, Memory Guard.

Проекты и рабочие области Как делить память между проектами.

Ошибки Коды ответов и что с ними делать.