# Приглашения и ключи сотрудников

> Как добавить человека в организацию одноразовой ссылкой и как он подключает своего агента собственным ключом.

К концу этой страницы вы сможете:

1. пригласить человека в организацию;
2. помочь ему выпустить свой ключ и подключить агента;
3. отозвать ключ, если ноутбук потерян или ключ утёк.

Пример: администратор «Северного ветра» Дмитрий приглашает Бориса (boris@sever-veter.ru) в отдел бэкенда с ролью «Сотрудник».

## Приглашение

1. Дмитрий переключается на организацию, открывает вкладку «Сотрудники» → «Пригласить сотрудника».

2. Заполняет почту, подразделение и роль. Поле «Срок доступа, дней» оставляет пустым — оно нужно для [подрядчиков](/organizations/contractors/).

3. Нажимает «Создать приглашение». Кабинет показывает ссылку-приглашение вида `https://app.mmwhub.ru/invite?token=…` с кнопкой «Копировать».

4. Дмитрий **сам** отправляет ссылку Борису — в рабочем мессенджере или письмом. MMW писем-приглашений не рассылает.

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

Свойства ссылки:

| Свойство | Значение |
|---|---|
| Срок | 7 дней с момента создания |
| Сколько раз | Один раз: после принятия ссылка больше не работает |
| Для кого | Только для указанной почты |
| Хранение | Ссылка показывается один раз; на сервере хранится только хеш токена |
| Отзыв | Администратор нажимает «Отозвать» в списке «Приглашения», пока приглашение не принято |

В списке «Приглашения» у каждой ссылки статус: «ожидает», «принято» или «отозвано». Приглашать, видеть список и отзывать приглашения может только администратор.

Ссылка даёт вход в организацию тому, кто войдёт под указанной почтой. Передавайте её только этому человеку. Если ссылка ушла не туда — отзовите её и создайте новую.

### Если приглашение не принимается

| Сообщение | Причина | Что делать |
|---|---|---|
| «Приглашение не найдено, уже использовано или устарело.» | Прошло 7 дней, ссылку отозвали или уже приняли | Администратор создаёт новое приглашение |
| «Приглашение выписано на другую почту.» | Человек вошёл под другой почтой | Выйти и войти под почтой из приглашения |
| «Сначала подтвердите электронную почту.» | Почта не подтверждена | Ссылка из письма; если письма нет — «Отправить письмо ещё раз» на странице «Организации» |
| «Вы уже состоите в этой организации.» | Человек уже участник | Ничего делать не нужно |

## Ключ сотрудника

Ключ каждый выпускает **себе сам**. Администратор не может выпустить ключ за другого человека.

1. Борис переключается на «Северный ветер» и открывает вкладку «Ключи».

2. В блоке «Мои ключи» вводит название, например «рабочий ноутбук», и нажимает «Выпустить ключ».

3. Кабинет показывает ключ `mmw_…` **один раз**: «Ключ показывается один раз. Скопируйте его в настройки MCP-клиента сейчас.»

4. Борис подключает агента этим ключом — так же, как личный ключ, см. [Подключение клиентов](/clients/overview/).

```bash
claude mcp add mmw-sever \
  -e MMW_API_KEY=mmw_ключ_организации \
  -- uvx --from https://app.mmwhub.ru/downloads/mmw-agent/mmw_agent-0.1.4-py3-none-any.whl mmw-agent
```

```json title="mcpServers"
{
  "mcpServers": {
    "mmw-sever": {
      "url": "https://mcp.mmwhub.ru/mcp",
      "headers": { "Authorization": "Bearer mmw_ключ_организации" }
    }
  }
}
```

Ключ организации работает только с памятью организации, личный ключ — только с личной памятью. Если нужны обе, подключите два сервера с разными именами, например `mmw` и `mmw-sever`.

Пока организация не активирована, агент с ключом организации получит отказ. Аудитор ключ выпустить не может: ему доступен только журнал.

## Что видит администратор

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

| | Владелец ключа | Администратор | Остальные |
|---|---|---|---|
| Выпустить | себе | только себе | — |
| Увидеть секрет | один раз, при выпуске | нет | нет |
| Видеть в списке | свои | все ключи организации | — |
| Отозвать | свои | любой | — |

Отзыв действует сразу: следующий вызов агента с этим ключом получит отказ. Новый ключ сотрудник выпускает сам.

## Что дальше