# MIREA Connect

**Расписание МИРЭА и поиск свободных аудиторий в вашем ИИ-ассистенте.**

## Шаг 1. Выберите и установите приложение

Выберите **один** вариант и хотя бы один раз откройте приложение после установки:

| Вариант | Что установить | Оплата |
|---|---|---|
| **ChatGPT / Codex** | [Приложение OpenAI для компьютера](https://learn.chatgpt.com/docs/app). Войдите через свой аккаунт ChatGPT. | Доступ и лимиты зависят от вашего тарифа. |
| **Claude** | [Claude Desktop](https://claude.com/download). Установите и войдите в аккаунт Claude. | Действуют тариф и лимиты Claude. |

## Шаг 2. Установите MIREA Connect

### Windows

1. Откройте меню **Пуск**.
2. Напишите **PowerShell** и откройте **Windows PowerShell**. Запускать от администратора не нужно.
3. Скопируйте всю команду ниже, вставьте в окно PowerShell и нажмите **Enter**:

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/Damanian638/mirea-connect/main/install.ps1 | iex"
```

4. Дождитесь окончания загрузки. Установщик сам скачает Python и необходимые компоненты. Не закрывайте окно, пока идёт установка.
5. Когда появится вопрос **«Куда подключить MIREA Connect?»**, перейдите к шагу 3 ниже.

### macOS или Linux

Откройте приложение **Терминал**, вставьте команду и нажмите **Enter**:

```bash
curl -LsSf https://raw.githubusercontent.com/Damanian638/mirea-connect/main/install.sh | sh
```

Дождитесь меню выбора приложения. Python и необходимые компоненты установятся автоматически.

## Шаг 3. Подключите выбранное приложение

В меню установщика введите **номер нужного пункта** и нажмите **Enter**. Номера зависят от того, какие программы найдены на вашем компьютере: ориентируйтесь на название.

### ChatGPT / Codex

1. Выберите в меню установщика пункт **Codex**. Так он называется в установщике, в том числе для приложения с общей конфигурацией ChatGPT / Codex.
2. Дождитесь сообщения **«Подключено: Codex»**.
3. Полностью закройте приложение и откройте снова.
4. Создайте новый локальный чат. В настройках **MCP** найдите сервер **mirea** и убедитесь, что он включён.
5. Перейдите к шагу 4.

Если пункта Codex нет: откройте приложение, завершите первоначальную настройку и снова запустите установку из шага 2. Если он всё ещё не появился, используйте [ручное подключение](docs/manual-connection.md).

Подключение использует общие настройки локального агента — это описано в [официальной документации OpenAI](https://learn.chatgpt.com/docs/developer-settings).

### Claude Desktop

1. Выберите в меню установщика пункт **Claude Desktop**.
2. Дождитесь сообщения **«Подключено: Claude Desktop»**.
3. Полностью завершите Claude, в том числе через значок возле часов, если приложение осталось работать в фоне. Затем откройте его снова.
4. Создайте новый чат. В меню инструментов возле поля сообщения проверьте, что доступен **mirea**.
5. Перейдите к шагу 4.

Если Claude Desktop нет в списке: запустите Claude, войдите в аккаунт, закройте приложение и повторите шаг 2. Эта установка предназначена для программы на компьютере. [Справка Claude о локальных подключениях](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop).

## Шаг 4. Проверьте, что всё работает

Отправьте в чат выбранного приложения:

> Используй MIREA Connect. Найди преподавателя по фамилии и покажи его расписание на ближайший понедельник. Сначала спроси у меня фамилию.

Ассистент должен обратиться к инструментам **mirea** и получить расписание. **Для публичного расписания вход в аккаунт МИРЭА не нужен.**

Теперь можно спросить, например:

> Найди свободные аудитории на проспекте Вернадского, 78, в понедельник с 10:40 до 12:10. Укажи точную дату и выдай списком.

> Покажи лабораторные и практические преподавателя Иванова И. И. на следующую неделю.

Свободная по расписанию аудитория может быть закрыта или иметь ограничения доступа. Время занятий — московское.

## Шаг 5. Войдите в МИРЭА, если нужны личные данные

Для проверки расписания этот шаг можно пропустить.

1. Напишите ассистенту: **«Войди в МИРЭА через MIREA Connect»**.
2. Откройте предложенную страницу входа в браузере на этом же компьютере.
3. Введите логин и пароль **на странице входа**. Если придёт код, введите его там же.
4. Дождитесь сообщения **«Готово»** и вернитесь в чат.

Пароль и код в чат присылать не нужно. Для СДО может потребоваться отдельный вход. Если университет завершит сессию, ассистент предложит войти снова; закрытие чата само по себе сессию не удаляет.

Коннектор получает данные в пределах прав вашей учётной записи. Выставление оценок и изменение курсов сейчас не реализованы.

## Если что-то не получилось

| Что произошло | Что сделать |
|---|---|
| Нужного приложения нет в меню | Установите его, откройте и войдите в аккаунт, затем повторите шаг 2. |
| Установка остановилась со словом «Ошибка» | Прочитайте сообщение над ним. Если там «Отказано в доступе» или «файл занят», полностью закройте Claude, ChatGPT / Codex и Cursor (в том числе значок возле часов) и повторите команду из шага 2. |
| Ассистент пишет, что найдено несколько преподавателей | Уточните запрос: фамилия и инициалы («Иванов И. И.») или полное ФИО. |
| Свободных аудиторий 0, хотя корпус большой | Проверьте название корпуса: ассистент получит список корпусов, где есть свободные аудитории. |
| Ассистент отвечает, что не видит MIREA Connect | Полностью перезапустите приложение, создайте новый чат и проверьте, включён ли сервер `mirea` в настройках MCP. |
| Команда `mirea-connect` не найдена | Закройте PowerShell и откройте снова. Если не помогло, используйте полный путь, который установщик вывел после слов «Готово. Команда:». |
| Не удалось войти или подтвердить код | Попросите ассистента начать вход заново. Вводите последний полученный код в новой форме. |
| Требуется обновление | Закройте приложение-ассистент, повторите команду из шага 2, затем откройте приложение снова. |

Если ошибка осталась, [сообщите о ней](https://github.com/Damanian638/mirea-connect/issues): напишите, какое приложение и Windows/macOS/Linux вы используете, и приложите текст ошибки. Пароли, коды и данные сессии не прикладывайте.

### Если вы пользуетесь ChatGPT в браузере

Сайт ChatGPT не читает локальную конфигурацию из этой инструкции. Для веб-версии нужен отдельный удалённый MCP-сервер или Secure MCP Tunnel. Это более сложный способ: [инструкция OpenAI](https://developers.openai.com/api/docs/guides/custom-mcp-server), [справка по удалённому серверу MIREA Connect](docs/technical.md#удалённый-сервер). Для начала используйте приложение на компьютере.

---

[Ручное подключение](docs/manual-connection.md) · [Техническая справка](docs/technical.md) · [Лицензия MIT](LICENSE) · [Сведения об исходном коде](THIRD_PARTY_NOTICES.md)