> For the complete documentation index, see [llms.txt](https://docs.skillzrun.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skillzrun.com/administruvannya/shtuchnii-intelekt/mcp-server-keruvannya-kontentom-cherez-shi.md).

# MCP-сервер (керування контентом через ШІ)

Як підключити штучний інтелект до вашої школи, щоб він сам читав і створював контент — рівні, розділи, уроки, теорію, вправи з картинками, відео та слова

MCP — це спосіб підключити вашу школу до штучного інтелекту як інструмент. Після підключення ШІ не просто радить, як щось зробити, а **сам виконує дії у вашій школі**: читає структуру курсу, створює рівні та розділи, додає уроки, пише теорію, генерує вправи, додає відео та слова.

Це працює з будь-якою ШІ-системою, яка підтримує MCP — сама модель не принципова.

## Крок 1. Створіть API-ключ і скопіюйте посилання MCP

Перейдіть у **Налаштування компанії → API-ключі**, натисніть **«Створити»** — новий ключ з'явиться у списку.

Готову адресу MCP-сервера вашої компанії не потрібно складати вручну: вона відображається в тому ж рядку, що й сам ключ, — у колонці **«Посилання MCP»**, поруч із колонкою **«API Ключ»**. Просто скопіюйте посилання звідти.

Якщо хочете скласти адресу самостійно, її формат такий:

`https://mcp.skillzrun.com/mcp/{api-key}`

Замініть `{api-key}` своїм ключем із колонки **«API Ключ»**. Ключ у складі адреси надає доступ до вашої компанії: не публікуйте готову адресу й не передавайте її стороннім.

Детальніше про ключі — на сторінці [Робота з API](https://docs.skillzrun.com/administruvannya/robota-z-api).

## Крок 2. Підключіть сервер у вашій ШІ-системі

Нижче — порядок дій на прикладі ChatGPT. В інших системах кроки називаються інакше, але суть та сама.

1. Увійдіть у **Налаштування** і знайдіть розділ із плагінами (конекторами).
2. Увімкніть **режим розробника**.
3. Натисніть плюс для створення нового плагіна і заповніть:
   * **Назва** — будь-яка, на ваш розсуд.
   * **Опис** — необов'язково.
   * **Адреса MCP-сервера SkillzRun** — вставте посилання з колонки **«Посилання MCP»** (або адресу, зібрану вручну зі своїм API-ключем).
   * **Автентифікація** — налаштовувати не потрібно.
4. Натисніть **«Створити»**, потім **«Підключити»** і надайте дозволи на дії.
5. Відкрийте новий чат і перевірте з'єднання — наприклад, попросіть показати список ваших предметів.

{% hint style="info" %}
Дозволи можна надавати спокійно: підключення працює виключно з вашою компанією в SkillzRun і нікуди далі не сягає.
{% endhint %}

## Що ШІ може робити через MCP

**Читання**

* Список усіх ваших предметів.
* Список уроків предмета разом із тегами.
* Повна структура предмета: рівні → розділи → уроки.
* Деталі конкретного уроку разом із текстом теорії.

**Створення та редагування**

* **Рівні** — створення та редагування (назва, очки, зображення, поріг відкриття наступного рівня).
* **Розділи (теми)** — створення та редагування (назва, опис, колір, рівень, ілюстрація, стоп-елемент, прихованість).
* **Уроки** — створення.
* **Теорія уроку** — написання та оновлення.
* **Вправи** — створення, зокрема з картинкою до питання.
* **Відео** — створення відео за посиланням безпосередньо в уроці.
* **Слова** — пакетне створення слів і термінів в одному запиті, за потреби одразу з додаванням в урок.

Кожна операція створення повертає посилання на створений елемент — можна одразу перейти в адмінку й перевірити результат.

{% hint style="info" %}
Раніше через MCP можна було створювати лише уроки, а рівні та розділи доводилось готувати вручну. З оновленням від 31 серпня 2026 року ШІ може зібрати курс цілком — від рівня до окремого уроку.
{% endhint %}

## Створення відео

ШІ створює [відео](/navchannya/uroki/video.md) за посиланням **безпосередньо в уроці** вибраного предмета. Підтримуються:

* відео на YouTube;
* відео на Vimeo;
* вже завантажений відеофайл вашої компанії на `video.skillzrun.com` або `admin.skillzrun.com` (шлях має вигляд `media/video/{companyId}/{subjectId}/{fileName}`).

Що потрібно вказати:

* **Предмет** — обов'язково.
* **Урок** — вказуйте завжди: відео створюється одразу в цьому уроці. Урок має належати тому самому предмету.
* **Назва відео** — обов'язково.
* **Посилання** на відео — обов'язково.

{% hint style="warning" %}
Через MCP **не можна прикріпити до уроку вже створене відео** — ШІ вміє лише створювати нове відео одразу в уроці. Така можливість з'явиться пізніше. Якщо не вказати урок, відео створиться без прив'язки, і додати його до уроку доведеться вручну в адмінці.
{% endhint %}

Що варто знати:

* ШІ **не завантажує й не скачує файли**: відео додається лише за посиланням. Файли з інших джерел не підтримуються.
* Для файлів SkillzRun підходять лише файли вашої компанії.
* У відповідь ШІ повертає посилання на створене відео.

## Створення слів

ШІ створює [слова та терміни](/navchannya/uroki/slova-ta-termini.md) пакетом — багато слів в одному запиті — у вибраному предметі. Якщо вказати урок, слова одразу додаються до нього; урок має належати тому самому предмету.

Для кожного слова вказуються:

* **Слово або фраза** (мовою оригіналу) — обов'язково; у межах одного запиту не повинно повторюватись.
* **Переклад** — обов'язково.
* **Транскрипція** — необов'язково; за замовчуванням порожня.
* **Ознака фрази** — необов'язково; за замовчуванням слово не вважається фразою.
* **Картинка** — необов'язково. Це публічне посилання (HTTP/HTTPS), доступне без авторизації; картинка завантажується у сховище слів.

Що варто знати:

* Якщо картинку не вдалося завантажити, слово все одно створюється, а помилка повертається окремим списком (`imageErrors`). ШІ має повідомити вам про такі випадки — перевірте їх і додайте картинки вручну або повторіть запит.
* Аудіо для нових слів не створюється — озвучення потрібно додати окремо.
* Якщо слово з таким самим написанням уже існує, воно не дублюється: його можна додати до уроку, якщо там його ще немає. Дані наявного слова при цьому зберігаються без змін.
* У відповідь ШІ повертає посилання на створені слова.

## Картинки у вправах

До вправ, створених через MCP, можна додати **картинку до питання**: ситуацію на дорозі, схему, фото, дорожній знак тощо. Це працює для типів «Виберіть або введіть правильну відповідь», «Заповнити пропуски» та «Домашнє завдання».

ШІ не завантажує файли з вашого комп'ютера. Картинка додається **за публічним посиланням**: SkillzRun сам завантажує її за цим посиланням і зберігає у своєму сховищі. Після цього картинка більше не залежить від того, де вона лежала спочатку.

Вимоги до посилання:

* публічне посилання HTTP/HTTPS, яке відкривається **без входу в акаунт**;
* розмір картинки — до **10 МБ**;
* файл має завантажитися не довше ніж за 20 секунд;
* до одного питання — **одна картинка**. Картинки у варіантах відповіді через MCP не додаються.

Якщо до питання потрібно кілька картинок, об'єднайте їх в одне зображення заздалегідь — або попросіть ШІ зробити це.

{% hint style="warning" %}
Якщо картинку не вдалося завантажити, вправа **все одно створюється, але без картинки**, а причина повертається окремим списком (`imageErrors`). Відредагувати вправу через MCP не можна — таку вправу доведеться виправити вручну в адмінці. Тому перед масовим створенням перевірте посилання на одній тестовій вправі.
{% endhint %}

### Картинки з Google Drive

Найпростіше зберігати картинки на Google Drive:

1. Завантажте картинки в окрему папку на Google Drive.
2. Відкрийте доступ до папки: **«Усі, хто має посилання» → «Читач»**. Не ставте роль «Редактор» — інакше будь-хто з посиланням зможе видалити або замінити файли.
3. Передайте ШІ посилання на папку або на потрібні файли.

Звичайне посилання на файл у Google Drive відкриває сторінку перегляду, а не саму картинку. Для вправ потрібне пряме посилання на завантаження такого вигляду:

`https://drive.google.com/uc?export=download&id={ID файлу}`

ID файлу — це частина звичайного посилання між `/d/` і `/view`. Перетворювати посилання вручну не потрібно: якщо дати ШІ звичайні посилання, він зробить це сам.

### Багато картинок: список ID через Google Apps Script

Для кожної картинки ШІ потрібен її ID на Google Drive. Якщо картинок кілька, ШІ знайде їх сам через підключення Google Drive. Але для масових операцій (десятки й сотні файлів) це не працює: Google Drive віддає список файлів дуже маленькими порціями, і пошук кожного файлу окремо займає забагато часу.

Тому для великої кількості картинок спершу отримайте таблицю «назва файлу — ID» за допомогою короткого скрипта. Це займає близько хвилини:

1. Відкрийте папку з картинками на Google Drive і скопіюйте її ID з адресного рядка — це частина посилання після `/folders/`. Наприклад, у посиланні `https://drive.google.com/drive/folders/1AbCdEf...` ID — це `1AbCdEf...`.
2. Відкрийте [script.google.com](https://script.google.com) і натисніть **«Новий проєкт»**.
3. Видаліть код, який там є, і вставте замість нього:

```javascript
function listFiles() {
  const folder = DriveApp.getFolderById('ID_ВАШОЇ_ПАПКИ');
  const ss = SpreadsheetApp.create('ID картинок');
  const sh = ss.getActiveSheet();
  const rows = [['name', 'id']];
  const it = folder.getFiles();
  while (it.hasNext()) {
    const f = it.next();
    rows.push([f.getName(), f.getId()]);
  }
  sh.getRange(1, 1, rows.length, 2).setValues(rows);
  Logger.log(ss.getUrl() + ' — ' + (rows.length - 1) + ' files');
}
```

4. Замініть `ID_ВАШОЇ_ПАПКИ` на ID папки з першого кроку (лапки залиште).
5. Натисніть **«Виконати»**. Під час першого запуску Google попросить дозвіл на доступ до Google Drive і таблиць — надайте його (якщо з'явиться попередження «Додаток не перевірено», натисніть **«Додатково» → «Перейти до проєкту»**: це ваш власний скрипт).
6. Після виконання в журналі внизу з'явиться посилання на нову таблицю «ID картинок» і кількість файлів. Таблиця зберігається на вашому Google Drive.
7. Передайте ШІ цю таблицю (посилання або експорт у CSV) разом із завданням.

{% hint style="info" %}
Щоб ШІ правильно зіставив картинки з питаннями, назви файлів мають однозначно вказувати на питання — наприклад, за номером питання або за назвою файлу з вихідного експорту курсу. Якщо додаєте нові файли в папку пізніше, запустіть скрипт ще раз.
{% endhint %}

## Як це виглядає на практиці

Запити формулюються звичайною мовою. Наприклад:

* «Знайди урок *Основи першої медичної допомоги* у курсі та створи там теорію в HTML-форматі».
* «Створи теорію та вправи для всіх уроків, що залишились у цьому розділі».
* «Створи в цьому уроці відео за цим посиланням на YouTube».
* «Створи слова за цим списком із перекладами та додай їх до уроку».
* «Створи тест із цих питань; картинки до питань лежать у цій папці Google Drive».

ШІ може працювати у фоновому режимі, поки ви займаєтесь іншими справами в адмінці.

## Що варто врахувати

* Генеруються не всі типи вправ — частина типів наразі недоступна через MCP.
* Відеофайли через MCP не завантажуються — відео створюється лише за посиланням і одразу в уроці; прикріпити вже наявне відео до уроку поки неможливо.
* Картинки до вправ і слів додаються лише за публічним посиланням — файли з комп'ютера напряму не завантажуються.
* Результат варто перевіряти: штучний інтелект може помилятись у змісті.

{% hint style="warning" %}
Теорія, створена через MCP, **не розпізнається автоматично** штучним інтелектом і тому не потрапляє до бази знань [ШІ-агента в чаті](https://docs.skillzrun.com/administruvannya/shtuchnii-intelekt/vchitel-zi-shtuchnim-intelektom-shi-agent). Якщо плануєте використовувати агента — враховуйте це.
{% endhint %}