• klyo games
• Для розробників
• MCP

Як підключити

1. 01

   Прийми умови в браузері

   Зайди на dev.klyo.pl і прийми умови для розробників. Асистент цього за тебе не зробить, і в цьому вся суть: угоду підписує людина.

2. 02

   Додай klyo до свого асистента

   Найпростіше: підключи одним кліком. Обери свій ШІ (Claude, ChatGPT, Gemini, Copilot, Claude Code, opencode), решту зробимо ми. Вручну: у налаштуваннях асистента додай сервер інструментів (MCP) за адресою https://panel.klyo.pl/mcp?profil=gry. Ти входиш через свій акаунт klyo і сам вирішуєш, на що погоджуєшся, так само як підключаєш диск чи пошту.

3. 03

   Скажи, чого хочеш

   Досить сказати «Опублікуй цю гру на klyo, пакет лежить за цією адресою». Асистент передає адресу архіву ZIP, назву, опис для гравців і відповіді на віковий опитувальник. Хочеш таблицю рекордів і місце в центрі рекордів? Скажи «додай таблицю рекордів klyo», і інструмент klyo_game_sdk опише виклики (ready → progress → score) і межу результату.

4. 04

   Переглянь і опублікуй

   Гра чекає в студії з попереднім переглядом і QR-кодом. Ти граєш у неї на телефоні, а потім натискаєш «Випустити в каталог». Тільки цей клік показує гру гравцям.

1. 01

   «Заповни своїм ШІ» у формі нової гри

   Одна кнопка на всю форму. Твій ШІ вписує назву, гасло, опис англійською та польською, жанр, керування й тривалість гри, а ти бачиш, як поля заповнюються наживо. Щоб змінити одне поле, попроси в тому самому чаті, наприклад «зроби гасло коротшим», і форма одразу оновиться. Анкету про вміст позначаєш сам.

2. 02

   «Переклади своїм ШІ» у вікні перекладів

   Обери мови кнопками у вікні, відсутні вже позначені. Інші можна додати пізніше в чаті, наприклад «тепер німецькою». Кожен переклад потрапляє у вікно «Переклади» як пропозиція: ти перевіряєш його і натискаєш «Схвалити». Google зараховує лише текст, який схвалила людина.

3. 03

   «Напиши своїм ШІ» у картці автора

   Твій ШІ пише «про мене» і гасло під твоїм ім'ям лише на основі твоїх ігор. Він показує тобі текст і зберігає його тільки після твоєї згоди.

4. 04

   Вікно перевіряє підключення

   Після кліку вікно покаже, чи підключено твій ШІ до klyo, за тим самим списком, що й на сторінці підключень. Підключено: ✓ і кнопка «Відкрити в Claude» або «Відкрити в ChatGPT». Не підключено: спершу з'явиться «Підключи klyo до свого ШІ». Це робиться один раз.

Працюєш у Claude Code, Cursor чи VS Code? Натисни у вікні «Скопіювати інструкцію» і встав її туди. Інструменти ті самі.

• Не мусиш вірити нам на слово. Запис публічний, і будь-хто може його перевірити разом з адресою нашого сервера та сторінкою, яку ти читаєш.
• Твій клієнт знайде нас сам. Інструменти, що читають реєстр, запропонують klyo, коли ти спитаєш про публікацію гри, без пошуку адрес.
• Назва назавжди наша. pl.klyo це наш простір імен у реєстрі; ніхто інший не може публікувати під ним, бо ніхто інший не керує нашим доменом.

Перевірено 23 вересня 2026 у власній документації кожного сервісу: Playgama, AIGameShare, Playfrog. Ці сервіси змінюють правила без попередження. Якщо щось уже не збігається, напиши нам, і ми виправимо того ж дня.

Що ще вміють інструменти

Поля й правила: ті самі, що й у студії

Асистент заповнює рівно те, що людина клацає в студії. Обмеження записані в схемі інструмента (це перевірка ще до виклику), а сервер перевіряє їх знову й відповідає кодом помилки, який вказує на потрібне поле.

Власний агент: ключ замість входу

Claude і ChatGPT самі входять у твій акаунт. Якщо пишеш власного агента чи скрипт, отримуєш ключ і передаєш його в заголовку. Той самий шлях і ті самі інструменти, тільки без вікна входу.

1. 01

   Створи ключ у студії

   На dev.klyo.pl, у розділі «Інтеграція з сервером (API)», натисни «Згенерувати ключ». Ми показуємо його лише раз, тож збережи одразу. Ключ починається з klyo_sk_, і ти можеш відкликати його будь-коли.

2. 02

   Надсилай його під час підключення

   Заголовок Authorization: Bearer klyo_sk_… до https://panel.klyo.pl/mcp?profil=gry. Твій агент бачить рівно ті інструменти, що й Claude, жодного більше.

3. 03

   Стеж, що робить гра

   Коли попередній перегляд відкрито, виклич діагностику. Отримаєш файли, які гра запитувала, але яких немає в пакеті, і помилки з браузера, замість гадати по білому екрану.

Приклад: запит діагностики

curl -s "https://panel.klyo.pl/mcp?profil=gry" \
  -H "Authorization: Bearer klyo_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"klyo_game_diagnostics",
                 "arguments":{"slug":"lumina-thief"}}}'

Твій браузер і є очима

Ми не тримаємо ферми браузерів, і вона нам не потрібна. Гра працює на твоєму комп'ютері, а наш датчик на сторінці попереднього перегляду повідомляє, що зламалося. Твій асистент бачить рівно те, що побачив би ти, відкривши гру сам.

1. 01

   Відкрий попередній перегляд сам

   Playwright, звичайний Chrome або телефон через QR-код. Додай до адреси ?s=your-marker (будь-які 1–24 символів).

2. 02

   Справді пограй

   Клацай, перетягуй, дочекайся другого екрана. Датчик збирає винятки, файли, що не завантажилися, вивід консолі та те, чи гра взагалі запустилася.

3. 03

   Попроси діагностику

   klyo_game_diagnostics з sesja, де вказано твою мітку. Отримаєш ЛИШЕ помилки зі свого запуску плюс кількість чужих, тож ніщо не зникне непомітно.

Порядок важливий: якщо запитати до запуску гри, відповідь буде порожня, бо ще нічого було збирати.

Твій асистент грає у твою гру на твоєму пристрої

Асистент у чаті не має екрана, тож досі знав твою гру лише зі списків помилок і мініатюр. Тепер він може в неї зіграти: натискає клавіші, клацає, торкається й перетягує, а після кожної серії ходів отримує знімки екрана і стан гри. Гра працює в студії, відкритій у тебе, на твоїй відеокарті, тому асистент бачить навіть 3D-ігри, які наш сервер показати не може. Сервер klyo не малює жодного пікселя, він лише передає ходи.

1. 01

   Відкрий студію

   Відкрий dev.klyo.pl на комп'ютері чи телефоні, на якому хочеш тестувати. Якщо асистент уже попросив зіграти, одразу побачиш «Твій асистент хоче зіграти …» (запит чекає 10 хвилин).

2. 02

   Натисни «Дозволити»

   Відтепер асистент може грати на цьому пристрої. Гра відкривається в маленькому вікні в кутку екрана, на телефоні на весь екран, і ти бачиш кожен хід.

3. 03

   Асистент грає і дивиться

   Він надсилає до 40 ходів за раз на одній шкалі часу до 3 секунд, зокрема одночасно: бігти, повернути камеру, стрибнути. Назад отримує до 4 знімків екрана, інформацію, чи запустилася гра, рахунок і наскільки плавно працює сама гра.

4. 04

   Зупини, коли захочеш

   «Стоп» у вікні гри або «Вимкнути» на панелі одразу все завершує. Наступний запит асистента знову попросить твого дозволу.

• Лише твої ігри. Асистент відкриває тільки ігри твого акаунта: версію з майстерні або пакет із черги за його адресою попереднього перегляду, а інакше ту версію, яку мають гравці.
• Знімки екрана лишаються в чаті. Вони потрапляють лише в той чат, що їх запросив. Ми не зберігаємо їх ні в базі, ні на диску; вони чекають у пам'яті сервера щонайбільше 10 хвилин, щоб повторний виклик не зіграв двічі.
• Ходи як у гравця, але з одним нюансом. Гра отримує клавіші, кліки, дотики й рух миші так, ніби від людини, але браузер позначає їх як недовірені. Тому повний екран і звук чекають на твій клік, а захоплення курсора для ігор з оглядом мишею імітується.
• Грі потрібен klyo SDK. Ходи виконує SDK з games.klyo.pl/sdk/klyo-gry-sdk.js. Гра без нього або зі старою копією в пакеті відповідає «немає SDK», і асистент підкаже, що замінити.
• Один запуск за раз. Один виклик за раз на акаунт, до 600 на годину. Вкладка студії у фоні ставить гру на паузу, тож тримай її видимою поруч із чатом.
• Помилки саме з цієї гри. Кожна сесія має власну мітку датчика, тому klyo_game_diagnostics з sesja показує лише помилки з гри твого асистента.
• Коли перевірка якості каже, що ще не бачила 3D-графіки. Наш сервер вимірює ігри без відеокарти, тож не бачить 3D-гру і не дасть їй зеленого світла. Тоді картинка з твого пристрою покаже асистентові, чи гра працює, а рішення про випуск, як завжди, за тобою.

Покрокова інструкція для розробників з назвами кнопок зі студії

Пакет з диска, не виставляючи гру назовні

Не відкривай тунель і не викладай невипущену гру на публічний хостинг. Інструмент klyo_upload_package дає асистентові перепустку для завантаження (токен, дійсний одну годину, який дозволяє лише надсилати файли на твій акаунт) і список пакетів, що вже чекають у нас без гри. Асистент із терміналом (Claude Code, Codex, Cursor) сам надсилає файл двома запитами; асистент у чаті (claude.ai, ChatGPT) просить тебе перетягнути ZIP у студію: пакет потрапляє в чергу, нічого не публікується, а асистент бере номер зі списку. Коротка версія нижче.

1. 01

   Оголоси файл

   POST /api/upload/init із заголовком Authorization: Bearer <pass> і { filename, total_size, content_type } → отримаєш upload_id і chunk_size.

2. 02

   Надішли байти

   PATCH /api/upload/<upload_id> з тією самою перепусткою, Upload-Offset і Content-Type: application/offset+octet-stream. До 32 МБ за один запит; більші файли частинами. Щоб продовжити, HEAD покаже, скільки в нас уже є.

3. 03

   Опублікуй або онови

   klyo_publish_game або klyo_update_game з upload_id замість zip_url.

Публічну адресу ZIP залиш для гри, яка справді вже є в мережі, наприклад під час переїзду з itch.io.

Стандарт виробництва ігор: асистент знає мінімум ще до першого рядка коду

Звичайна людина каже своєму асистентові: «Хочу гру в морський бій». Асистент, підключений до klyo, спершу викликає klyo_game_requirements і отримує контракт: телефон, планшет і комп'ютер; дотик, миша й клавіатура; вертикальна й горизонтальна орієнтація з реакцією на зміну розміру; звук, що відновлюється після повернення з фону; збереження, таблиця рекордів, пауза й повтор одним жестом; одна палітра й один стиль; без чужих брендів і чужої реклами. Він ні про що з цього не питає користувача, а одразу будує на такому рівні. Версія 1 стандарту заморожена з 23.09.2026: нова вимога з'являється лише тоді, коли справжня гра на klyo натрапляє на справжню проблему.

1. Тестування на комп'ютері розробника, а не на нашому сервері. Асистент завантажує games.klyo.pl/sdk/klyo-test.mjs і запускає його локально: чотири екрани, прокручування, частка екрана, текст, обробники дотику, розмір, час, винятки. Перед випуском додає --slaby-telefon --jezyki: дешевий телефон і обидві мови. Результат містить krytyczne (критичні) і ostrzezenia (попередження), тож асистент виправляє й тестує знову, доки все не пройде. Важка робота відбувається на комп'ютері розробника; klyo вимірює тим самим файлом під час завантаження й випуску.
2. Перевірка якості, також для пакетів, завантажених вручну. Кожен пакет у черзі одразу після завантаження вимірюється на чотирьох екранах; klyo_game_diagnostics і попередній перегляд у студії показують ту саму bramka: винятки, відсутні файли, чужа реклама, відсутність SDK, дотику й блокування прокручування не дають випустити гру як «готову» (демо й «у розробці» проходять); малий екран, дрібний текст, розмір, відсутність таблиці рекордів і чужі бренди потребують пояснення.
3. Етапи випуску. Локально → попередній перегляд (g-podglad-…, поза каталогом і Google) → публікація з етапом w_budowie / demo / gotowa → нова версія з власним попереднім переглядом, поки гравці мають стару, а попередня версія лишається для відновлення. Людина затверджує два моменти: публікацію і випуск версії.

Нова версія твоєї гри: через асистента так само, як у студії

Три кроки, ті самі, що й кнопки «Нова збірка» та «Випустити» в студії. Асистент не вгадує, що змінилося: ми вимірюємо це за файлами й кажемо, що це означає для кліпу. Кліп для нової версії ти записуєш сам: у студії, після випуску (вікно запису відкривається саме, якщо змінився вигляд або з'явилася нова функція).

1. 01

   Завантаж

   klyo_update_game зі slug і upload_id (файл із диска) або zip_url. Гра в каталозі не змінюється одразу: нова версія чекає в залі очікування за власною адресою для перегляду. Відповідь: zmiana (код / вигляд / звук у %, нові файли й рядки, podpowiedz: poprawka | funkcja | interfejs), adres_nowej, wyrok і dalej.

2. 02

   Пограй

   Це твоя перевірка, а не асистента: відкрий адресу попереднього перегляду, найкраще на телефоні. Студія показує ту саму версію у вікні гри з доріжкою «версія → гра → випуск → кліп».

3. 03

   Випусти

   klyo_release_version з slug; zmiana можна пропустити (візьмемо виміряну) або передати, якщо знаєш краще; nowosc це одне речення для стрічки про нову функцію. Перед заміною вся нова версія ще раз проходить перевірку. Гравці отримують її одразу (хто саме грає, обирає: оновити чи завершити партію), попередня лишається в нас, сторінка гри перебудовується, а екрани ми вимірюємо один раз, після випуску. Підписники отримують сповіщення, коли гра з'являється в каталозі.

Що це означає для кліпу: poprawka (виправлення) залишає кліп; funkcja (нова функція) залишає кліп, а «що нового» потрапляє в стрічку з позначкою «Нове»; після interfejs (новий вигляд) старий кліп зникає з плитки та зі стрічки, доки ти не запишеш новий у студії.

Виправлення без ZIP: майстерня гри

Твій асистент читає файли твоєї гри й редагує їх просто тут, без пакета від тебе. Це працює і з грою в каталозі, і з пакетом, що чекає в залі очікування. Гравці до кінця грають у знайому їм версію: правки йдуть у майстерню, нову версію поруч із власною адресою попереднього перегляду. Випускаєш її так само, як будь-яку нову версію.

1. 01

   Почни з нуля, якщо гри ще немає

   klyo_game_patch з nowa (plansza, zrecznosciowa або logiczna) створює пакет із каркаса Klyo Kit одразу в залі очікування і тим самим викликом записує ігровий процес. Асистент у чаті, без диска й без ZIP, із цієї миті має власну гру за адресою попереднього перегляду.

2. 02

   Читання

   klyo_game_files із slug гри або upload_id пакета. Без path отримуєш список файлів із hash для кожного, з path вміст файлу (до 200 КБ за раз, далі з from_line), а з changes: true те, чим версія відрізняється від тієї, що мають гравці.

3. 03

   Редагування

   klyo_game_patch зі списком edits: точний old_string, замінений на new_string, цілий файл у content або delete: true. Для наявного файлу передаєш expected_hash зі свого читання: якщо хтось тим часом змінив файл, нічого не збережеться. Правки одного виклику заходять усі разом або жодна. Перша правка відкриває майстерню, і студія одразу показує її як «Нова версія чекає».

4. 04

   Зіграй і перевір

   Адреса попереднього перегляду повертається у відповіді. Відкрий її (найкраще перевіряти на телефоні), а klyo_game_diagnostics покаже помилки, відсутні файли й результати перевірок саме цієї версії, а не тієї, що мають гравці. Асистент без браузера передає zmierz: true: ми відкриваємо попередній перегляд за нього й повертаємо помилки та мініатюри чотирьох екранів за повними адресами, тож він бачить, як виглядає гра. Файли, не змінені з останнього вимірювання, браузер повторно не запускають; одне вимірювання за раз на акаунт, шість на годину. Твій асистент може й сам зіграти, на твоєму пристрої: klyo_game_play, описано вище.

5. 05

   Випусти

   Гра: klyo_release_version або «Випустити» в студії. Пакет із зали очікування: klyo_publish_game публікує його разом із правками. Перед заміною вся гра ще раз проходить перевірку.

• Версія, яку мають гравці, не змінюється. Майстерня це копія поруч, а кожне збереження створює новий файл, тож те, що завантажують гравці, ні на мить не змінюється.
• Текст у розмові, файли за квитком. Вміст правки записує текстові файли (html, htm, js, mjs, css, json, svg, txt, xml, webmanifest). Зображення, звук, шрифт чи великий файл (до 20 МБ) асистент надсилає з квитком klyo_upload_package і передає в from_upload: без base64, а початок файлу має відповідати його розширенню.
• Та сама перевірка, що й під час завантаження. Кожен змінений файл перевіряється одразу: шкідливий код, стороння реклама, нічого ззовні klyo. Відмова нічого не зберігає.
• Ліміти. Файл до 1 МБ, один виклик до 256 КБ і 20 правок, три відкриті майстерні на акаунт і одна на гру, до 300 правок на годину. Випуски, відкати й нові пакети до 10 на годину: кожен запускає вимірювання екранів, а вимірювальний браузер один на всіх розробників.
• Порядок. Майстерня без змін протягом 7 днів спливає, а версія, яку мають гравці, лишається недоторканою. Попередній перегляд, на який уже ніщо не вказує, зникає через 7 днів. Адреси попереднього перегляду не потрапляють у Google.
• Слід. Кожна правка записується в журнал твого акаунта: файл, хеш до й після, розмір.
• Скасування під час роботи. Перед кожною правкою ми зберігаємо точку auto-N (вона є у відповіді), а асистент може назвати власну через checkpoint. revert повертає до будь-якої точки, discard відкидає всю майстерню. Це не відкат випуску: гравці нічого з цього не бачать.
• Слабкий телефон і перед випуском. Під час завантаження й випуску ми ще раз вимірюємо гру на телефоні з учетверо сповільненим процесором і мережею, як слабкий 3G: плавність, ривки, пам'ять і час до першого кадру. Нижче 15 кадрів на секунду гра не пройде бар'єр як завершена. Асистент без браузера замовляє те саме вимірювання перед випуском: klyo_game_diagnostics із zmierz і pelny.
• Кожною мовою гри. Klyo Kit говорить десятьма мовами (польська, англійська, німецька, французька, іспанська, португальська, італійська, російська, українська, турецька), а гра говорить тими, для яких має власні тексти. Ми відкриваємо той самий телефон кожною заявленою мовою, з мініатюрою. Ключ замість слова і заявлена мова, якої гра не показує, блокують випуск; англійська замість перекладу, речення, однакове з англійським, і текст, що не влазить у кнопку чи виходить за екран, дають попередження. Текст, намальований на canvas, перевіряй на мініатюрах поруч.
• Повільні кадри з причиною. Сама кількість кадрів не каже, чия це провина. Ми окремо вимірюємо час коду гри в кожному кадрі, роботу браузера і те, скільки картинки справді змінюється. Повільний код це niski_fps; легкий код із повільним малюванням це wolne_rysowanie, з порадою, що малювати один раз, а що щокадру.
• Безпека. Код гри ми відкриваємо в себе лише в ізольованому браузері без доступу до нашої внутрішньої мережі. Гра за власною адресою також не може діяти від імені гравця, що увійшов.

Преміальний огляд якості: сім пунктів перед випуском

Бар'єр якості ловить помилки, але не може сказати, чи гра виглядає дешево. Тому перш ніж асистент опублікує гру як завершену або випустить новий вигляд чи функцію, він проходить сім пунктів і для кожного дає доказ: що саме зробив. Ми не судимо смак і не запускаємо власної моделі. Ми звіряємо заяву зі слідами в коді й показуємо тобі в студії пункти, яких код не підтверджує, ще до того, як ти натиснеш «Випустити».

• Художній напрям: один візуальний напрям: одна палітра, один стиль, сцена й елементи з одного скіна, жодних голих прямокутників.
• Анімація: кожна зміна стану має перехід, є анімація перемоги й поразки, а рух вимикається для тих, хто про це просить.
• Звук: звук для кожної дії й кожного результату, вимкнення звуку в налаштуваннях, звук повертається після виходу з фону.
• Відгук на кожен хід: відповідь на кожну дію протягом 100 мс: картинка, звук, вібрація на телефоні; зрозуміло, чий хід і чому хід заборонений.
• Світла й темна тема: обидва варіанти за налаштуванням пристрою, плюс перемикач у грі.
• Мови: кожен текст із таблиці перекладів, щонайменше польська й англійська, кожна заявлена мова перевірена на телефоні (не потрібно для гри без слів).
• Онлайн: запрошення за посиланням, очікування суперника, повернення після розриву зв'язку, реванш одним жестом (не потрібно для одиночної гри).

Таблиця рекордів: гра, яка заявляє рахунок (wynik_max), але не надсилає його через klyo.score, не пройде бар'єр як завершена. Гра без очок пояснює причину в описі. Огляд можна пропустити для демо й гри в розробці, а також для простого виправлення (zmiana: "poprawka").

Часті запитання