Подключение AI-помощника (MCP) к платформе¶

Обзор¶

AI-помощник позволяет использовать популярные AI-чаты — Claude, ChatGPT и другие — для работы с данными платформы непосредственно в диалоге. Например, можно задавать вопросы о курсах, заданиях или учениках, не покидая чат.

Платформа предоставляет AI-помощника через удалённый сервер MCP (Model Context Protocol). После подключения AI-клиенты, такие как Claude, Claude Code, ChatGPT и Codex, могут работать с данными платформы непосредственно в чате.

URL MCP-сервера: https://mcp.prosvita.net/

ℹ️ Подключение осуществляется через OAuth. При подключении клиента открывается окно браузера с предложением войти в учётную запись платформы и предоставить разрешение на доступ. Никакие API-ключи или токены вручную копировать не требуется.

⚠️ Требуется активная учётная запись на платформе. AI-помощник будет видеть только те данные, к которым имеет доступ ваш аккаунт — например, учитель видит только свои уроки, а не уроки всей школы.

Как интегрировать AI-помощников на платформу¶

Claude (веб-версия и десктопное приложение)¶

Пользовательские коннекторы доступны на тарифах Claude Pro, Max, Team и Enterprise.
На тарифе Free Plan можно подключить только один коннектор.

Откройте Claude.ai в браузере или приложение Claude Desktop.
Войдите в свою учётную запись Claude. Claude может запросить подтверждение номера телефона через одноразовый код.
Перейдите в меню слева: Customize → Connectors.
Нажмите "+" → "Add custom connector".
Откроется форма настройки.
Укажите название коннектора. Например, "Prosvita MCP". Вставьте URL MCP-сервера:
```
https://mcp.prosvita.net/
```
Нажмите "Add", затем "Connect".
Откроется окно браузера со страницей входа на платформу.
Если у вас уже есть активная браузерная сессия на платформе, этот шаг будет пропущен, и вы сразу будете перенаправлены на экран предоставления согласия (шаг 10).
Войдите в свою учётную запись на платформе.
Появится экран предоставления согласия со списком разрешений, к которым получит доступ AI-помощник.
Нажмите "Allow" («Разрешить»).
После предоставления согласия вы будете автоматически перенаправлены в окно чата Claude, где коннектор уже будет активирован.

⚠️ На тарифах Team и Enterprise владелец организации должен сначала добавить коннектор в разделе Organization Settings → Connectors, прежде чем участники смогут им пользоваться.

Claude Code¶

Claude Code — это AI-помощник от Anthropic, который работает непосредственно в вашем терминале (командной строке на компьютере). Терминальный инструмент для разработчиков Claude Code является платным.

Что такое терминал (командная строка)?¶

Терминал — это программа, в которой команды вводятся текстом вместо использования мыши. Обычно он выглядит как тёмное (или светлое) окно с мигающим курсором. Необходимо ввести команду и нажать Enter.

Как открыть терминал?¶

Операционная система	Как открыть
Windows	Нажмите `Win + R`, введите `cmd` или `powershell`, затем нажмите OK
macOS	Нажмите `Cmd + Пробел`, введите `Terminal`, затем нажмите Enter

Подключение Claude Code к платформе¶

Описанные ниже действия необходимо выполнить только один раз (флаг --scope user делает сервер Prosvita доступным во всех ваших проектах). После этого Claude Code запомнит его навсегда.

Откройте терминал (как описано выше).
Скопируйте команду ниже полностью — не изменяйте ни одного символа:
```
claude mcp add --transport http prosvita https://mcp.prosvita.net/ --scope user
```
Вставьте её в терминал (Ctrl+V в Windows, Cmd+V в macOS) и нажмите Enter.
В командной строке появится следующее сообщение:
```
Added MCP server "prosvita"
```
Если появилось это сообщение, сервер успешно добавлен. Переходите к следующим шагам. Если вместо этого появилось сообщение об ошибке (любой текст красного цвета или содержащий слова error, not found и т.д.), это означает, что Claude Code не установлен или установлен некорректно. Переустановите Claude Code.

Запустите (или перезапустите) Claude Code. После запуска Claude Code отображает главный экран:

╭─────────────────────────────────────────╮
│  Claude Code  v2.x.x                    │
│  Welcome back!                          │
│                                         │
│  Sonnet 4.x · API Usage                 │
│  /your/project/path                     │
│                                         │
│  Tips for getting started:              │
│  > Run /mcp to check connections        │
│  > Use claude to help with files...     │
╰─────────────────────────────────────────╯
>

Мигающий курсор после > — это поле для ввода команд.

Проверьте подключение, введя команду /mcp, затем нажмите Enter.
Claude Code определит, что сервер требует авторизации, и откроет окно браузера.
```
MCP Servers:
prosvita  ⚠  Needs authorization
→ Opening browser for authentication...

>
```
ℹ️ Если вы уже ранее авторизовывались на платформе, браузер сразу откроется на экране предоставления разрешений (согласия на доступ к действиям на платформе).
После открытия браузера Claude Code отобразит страницу входа в вашу учётную запись платформы.
Войдите в свою учётную запись на платформе.
Появится экран предоставления согласия со списком разрешений, к которым получит доступ AI-помощник.
Нажмите "Allow" («Разрешить»).
Выполните команду /mcp из п. 7 ещё раз. Сервер prosvita должен отображаться как connected (подключён) со списком его инструментов.
```
MCP Servers:
prosvita  ✓  connected (12 tools)
```

ℹ️ Выполните команду claude mcp list, чтобы убедиться, что сервер зарегистрирован, или используйте /mcp в текущей сессии для просмотра текущего состояния подключения.

ChatGPT¶

Пользовательские MCP-коннекторы работают в Developer Mode (режиме разработчика), доступном для аккаунтов ChatGPT Plus, Pro, Business, Enterprise и Edu в веб-версии.

ℹ️ Подключение выполняется через сайт ChatGPT. Мобильное приложение не поддерживается.

Откройте ChatGPT.com и войдите в свою учётную запись.
Нажмите на своё имя в левом нижнем углу страницы и откройте Настройки.
Перейдите в Настройки → Приложения → Дополнительные настройки и включите Режим разработчика.
Вернитесь в меню Приложения и нажмите Создать приложение.
Укажите название (например, Prosvita AI) и краткое описание.
В поле Server URL укажите:
```
https://mcp.prosvita.net/
```
Для параметра Аутентификация выберите OAuth и нажмите Создать.
Включите переключатель Ссылаться на память и чаты.
Нажмите кнопку "Войти через Prosvita AI".
Появится экран предоставления согласия со списком разрешений, к которым получит доступ AI-помощник (если вы уже вошли в систему на платформе).
Предоставьте разрешение на доступ через свою учётную запись платформы, нажав кнопку "Разрешить" в окне браузера.
После предоставления разрешения вы будете автоматически перенаправлены в окно чата ChatGPT с уведомлением о подключении AI-помощника. В дальнейшем именно в этих настройках можно отключить помощника, изменить его название и управлять его конфигурацией.

Codex CLI¶

Codex подключается к удалённым серверам через свой файл конфигурации.

Откройте ~/.codex/config.toml и добавьте сервер. Параметр experimental_use_rmcp_client включает процесс OAuth для удалённых HTTP-серверах.
```
experimental_use_rmcp_client = true

[mcp_servers.prosvita]
url = "https://mcp.prosvita.net/"
```
Сохраните файл и запустите Codex.
При первом использовании Codex откроет окно браузера для авторизации — войдите в свой аккаунт платформы и нажмите Authorize (Авторизовать).
Теперь Codex показывает инструменты prosvita и может использовать их во время сессии.

ℹ️ Вы также можете зарегистрировать сервер интерактивно командой codex mcp add, а затем проверить это с помощью codex mcp list.

Устранение неполадок¶

«Authorization required» или повторные запросы входа — возможно, ваша сессия истекла. Подключите сервер заново и повторно пройдите вход в браузере.
Клиент не может подключиться к серверу — убедитесь, что https://mcp.prosvita.net/ доступен из вашей сети и не заблокирован файрволом, VPN или прокси.
Инструменты отсутствуют или ограничены — ИИ-помощник видит только то, к чему имеет доступ ваш аккаунт платформы. Проверьте свою роль и права на платформе.

Примеры использования¶

После подключения коннектора через одного из вышеуказанных AI-помощников окно чата отобразит список доступных инструментов для работы с MCP-коннектором и перечень действий, которые пользователь может выполнять в рамках своих прав доступа на платформе.

Рассмотрим в качестве примера раздел «Геймификация».

Пример 1:

Напишите в чате с AI-помощником:

"Предоставь мне список всех активных квестов на платформе."

AI-помощник проверит, подключён ли активный коннектор к Prosvita MCP, и отобразит список активных квестов из раздела «Геймификация».

Пример 2:

Напишите запрос:

"Нужно найти квест «Твоя личность»."

AI-помощник через коннектор получит и отобразит информацию о квесте с платформы.

После этого AI-помощник уточнит, что необходимо сделать с найденной информацией. В рамках прав своей роли на платформе пользователь может выполнять следующие действия:

Квесты:
- Создание, обновление и удаление квестов
- Назначение и удаление заданий в квестах
- Поиск квестов и получение квеста по ID

События (Events):
- Создание, обновление и удаление событий
- Получение событий по типу
- Управление типами событий

Объекты и пакеты:
- Поиск и автодополнение игровых объектов
- Создание пакетов объектов для квестов и событий

Другое:
- Синхронизация RPC-методов
- Управление пакетами (packages)

Таким образом, коннектор Prosvita MCP позволяет управлять геймификацией платформы напрямую через чат с AI-помощником без необходимости входить в административную панель.

Что это даёт на практике:

Скорость - вместо переходов по интерфейсу можно просто написать «создай квест с такими условиями», и он будет создан;
Удобство - поиск, редактирование и просмотр квестов, событий и объектов выполняются в одном месте;
Помощь AI - AI-помощник может предложить баланс наград, составить описание квеста или подобрать условия выполнения;
Массовые операции - можно попросить обновить несколько квестов одновременно или проанализировать всю структуру геймификации.