Dla twórców
Serwer MCP klyo: wydaj grę HTML5 asystentem AI
MCP (Model Context Protocol) to otwarty standard, przez który asystenci AI sięgają po cudze narzędzia. U nas służy do wydawania gier. Robisz grę razem z Claude albo ChatGPT? Może ją u nas wydać sam: wysyła paczkę, wypełnia opis, a ty dostajesz gotową grę do obejrzenia i jeden przycisk. Bez przeklikiwania formularza po każdej poprawce.
Jak to podłączyć
- 01
Podpisz zasady w przeglądarce
Wejdź na dev.klyo.pl i przyjmij regulamin dla twórców. Tego kroku asystent nie zrobi za ciebie i tak ma być: umowę podpisuje człowiek.
- 02
Dodaj klyo do swojego asystenta
Najprościej: podłącz jednym kliknięciem: wybierasz swoje AI (Claude, ChatGPT, Gemini, Copilot, Claude Code, opencode), resztę robimy za Ciebie. Ręcznie: w ustawieniach asystenta dodaj serwer narzędzi (MCP) pod adresem
https://panel.klyo.pl/mcp?profil=gry. Zalogujesz się swoim kontem klyo i zdecydujesz, na co się zgadzasz, tak samo jak przy podłączaniu dysku albo poczty. - 03
Powiedz, co ma zrobić
„Wydaj tę grę na klyo, paczka leży pod tym adresem” wystarczy. Asystent poda adres paczki ZIP, nazwę, opis dla gracza i odpowiedzi ankiety wieku. Chcesz tablicę wyników i miejsce na hubie rekordów? Powiedz „dodaj tablicę wyników klyo”, a narzędzie klyo_game_sdk opisze mu wywołania (gotowa → postęp → wynik) i próg wyniku.
- 04
Obejrzyj i wypuść
Gra czeka w studiu z podglądem i kodem QR. Zagrywasz w nią na telefonie, a potem klikasz „Wypuść do katalogu”. Dopiero to kliknięcie stawia grę przed graczami.
Dla twórców
Twoje AI w studiu, na twoim planie
Działa to tak samo jak w VS Code i Cursorze: asystent AI pracuje po twojej stronie, w ramach twojej subskrypcji Claude lub ChatGPT, a dane logowania pozostają na twoim urządzeniu. klyo nie uruchamia asystenta na swoich serwerach i nie ma dostępu do twojego logowania. Otrzymujemy wyłącznie gotowy tekst, który publikujemy dopiero po twojej akceptacji.
- 01
„Wypełnij swoim AI” w formularzu nowej gry
Jeden przycisk na cały formularz. Twoje AI wpisuje nazwę, hasło, opis po angielsku i po polsku, rodzaj, sterowanie i czas partii, a ty patrzysz, jak pola wypełniają się na żywo. Jedno pole poprawiasz w tej samej rozmowie, na przykład „skróć hasło”, i formularz zmienia się od razu. Ankietę treści zaznaczasz sam.
- 02
„Przetłumacz swoim AI” w oknie tłumaczeń
Języki wybierasz przyciskami w oknie, brakujące są już zaznaczone. Kolejne możesz dopisać później w rozmowie, na przykład „a teraz niemiecki”. Każde tłumaczenie trafia do okna „Tłumaczenia” jako propozycja: sprawdzasz je i klikasz „Zatwierdź”. Google liczy dopiero tekst zatwierdzony przez człowieka.
- 03
„Napisz swoim AI” przy wizytówce
Twoje AI pisze „o mnie” i hasło pod twoją nazwą wyłącznie na podstawie twoich gier. Pokazuje ci tekst i zapisuje go dopiero po twojej zgodzie.
- 04
Okno sprawdza połączenie
Po kliknięciu okno mówi, czy twoje AI jest połączone z klyo, na podstawie tej samej listy co strona połączeń. Połączone: znak ✓ i przycisk „Otwórz w Claude” albo „Otwórz w ChatGPT”. Niepołączone: najpierw „Połącz klyo ze swoim AI”. Robisz to raz.
Pracujesz w Claude Code, Cursorze albo VS Code? W oknie kliknij „Skopiuj polecenie” i wklej je tam. Narzędzia są te same.
Dla twórców
Czego asystent NIE może
Podpisać za ciebie umowy. Regulamin dla twórców przyjmujesz w przeglądarce, na swoim koncie. Bez tego narzędzie odmawia z jasnym powodem, a nie po cichu.
Wypuścić gry do katalogu. Asystent doprowadza grę do stanu „czeka na ciebie”. Ostatni krok (ten, po którym gra jest widoczna dla ludzi) należy do człowieka.
Zaznaczyć za ciebie ankiety treści ani oświadczeń. Z ankiety wynika wiek i reklamy przy grze, więc to deklaracja człowieka. Asystent wypełnia resztę formularza, ankietę klikasz ty.
Dotknąć twoich pieniędzy. Numer konta, dane do rozliczeń i wypłaty są poza zasięgiem narzędzi. Asystent nie zobaczy ich i nie zmieni.
Ominąć sprawdzenia. Paczka przechodzi to samo sito co przy wgraniu z przeglądarki: rozmiar, liczba plików, cudze reklamy, złośliwy kod, wulgaryzmy w nazwie i opisie, ankieta wieku.
pl.klyo/games
Jesteśmy w oficjalnym rejestrze MCP
Rejestr Model Context Protocol to spis, z którego asystenci i programiści biorą serwery narzędzi. Żeby do niego wejść, trzeba udowodnić, że domena naprawdę należy do nas. Potwierdziliśmy to podpisem klucza w DNS klyo.pl. To nie jest katalog, do którego się wpisuje. To katalog, do którego się wchodzi.
- Nie musisz nam wierzyć na słowo. Wpis jest publiczny i każdy może go sprawdzić, razem z adresem naszego serwera i stroną, którą właśnie czytasz.
- Twój klient sam nas znajdzie. Narzędzia czytające rejestr podpowiedzą klyo, gdy zapytasz o wydanie gry. Bez szukania adresu po forach.
- Nazwa jest nasza na stałe.
pl.klyoto nasza przestrzeń w rejestrze; nikt inny się pod nią nie wystawi, bo nie ma dostępu do naszej domeny.
Dla twórców
Inne serwery MCP do wydawania gier przeglądarkowych
Nie jesteśmy jedynym serwerem MCP, który wydaje gry przeglądarkowe. Oto, co każdy z nich daje grze i twórcy, żebyś mógł wybrać sam.
| klyo games | Playgama | AIGameShare | Playfrog | |
|---|---|---|---|---|
| Narzędzia dla twórcy | 22 | 25+ | 5 | 2 |
| Logowanie | OAuth 2.1, nic nie wklejasz | OAuth 2.1 | token z konta wklejany do konfiguracji | brak; osobny token zarządzania dla każdej gry |
| Paczka | ZIP do 350 MB i 5 000 plików | ZIP do 300 MB | HTML do 2 MB albo ZIP do 30 MB | do 2,5 MB |
| Co dostaje gra | własny adres g-<nazwa>.klyo.pl, stronę w katalogu po angielsku i po polsku, tablicę wyników, klipy graczy, statystyki dzień po dniu | publiczny link do gry z piaskownicy Playgama | link do udostępnienia z zagraniami, polubieniami i tablicą wyników | link do gry; grę trzeba przejąć w ciągu 7 dni |
| Pieniądze dla twórcy | 70% przychodu z reklam od dnia akceptacji portalu przez Google AdSense (jeszcze nie) | reklamy przez Playgama po przekroczeniu progu sesji; wypłaty od 100 USD | nie podają | nie podają |
Sprawdzone 23 września 2026 w dokumentacji każdego serwisu: Playgama, AIGameShare, Playfrog. Zasady tamtych serwisów zmieniają się bez zapowiedzi; jeśli coś się rozjechało, napisz, a poprawimy tego samego dnia.
Co jeszcze potrafią narzędzia
klyo_my_games | wypisuje twoje gry i ich stan: czeka, w katalogu, wstrzymana, odrzucona z powodem |
|---|---|
klyo_publish_game | wysyła paczkę i przygotowuje grę do wypuszczenia: nazwa, hasło, opis po angielsku i po polsku, rodzaj, ankieta treści; te same pola i limity co w kreatorze |
klyo_game_stats | wejścia i zagrania dzień po dniu |
klyo_game_requirements | kontrakt produkcyjny gry, pierwsze wywołanie agenta: ekrany, wejście, cykl gry, dźwięk, grafika, warstwa społeczna, test lokalny, bramka jakości, etapy wydania |
klyo_game_scaffold | Klyo Kit, szkielet gry na poziomie studia: pliki-startery i API (menu, pauza, koniec, dźwięk, motyw, wejście, online, hot-seat); asystent pisze tylko rozgrywkę |
klyo_release_rollback | cofnięcie gry do poprzedniej wersji jednym ruchem: pliki poprzedniej leżą obok, nic nie trzeba wgrywać |
klyo_game_diagnostics | dlaczego gra nie wstała: brakujące pliki i błędy z przeglądarki, po kolei, a do tego dopasowanie do ekranów, bramka jakości (krytyczne / ostrzeżenia), a z zmierz: true pomiar na żądanie dla asystenta bez przeglądarki |
klyo_game_files | czyta pliki twojej gry albo paczki z poczekalni: spis ze skrótami, treść pliku, różnice nowej wersji względem tej, w którą grają gracze |
klyo_game_patch | poprawia pliki gry bez ZIP-a, w warsztacie obok wersji u graczy; z nowa zaczyna grę od zera ze szkieletu Klyo Kit, z from_upload dokłada obraz, dźwięk albo czcionkę; wypuszczasz jak każdą nową wersję |
klyo_delete_game | zdejmuje twoją grę z portalu: adres zostaje twój i możesz wgrać grę z powrotem; drugie wywołanie usuwa ją z twojej listy na dobre, a wyniki zostają przy adresie |
klyo_fix_game | poprawia TREŚĆ wydanej gry (opis, jak grać, ile trwa partia, rodzaj, nastrój) bez ruszania paczki, więc bez ponownego badania plików |
klyo_game_cover | kafel, po którym gracz pozna grę: klatki są zdjęciami z twojej działającej gry, więc okładka pokazuje to, co gracz naprawdę zobaczy |
klyo_game_sdk | co gra może zawołać u nas: tablica wyników, zapis postępu, pełny ekran, reklama za nagrodę, klip. Przeczytaj to, ZANIM napiszesz grę |
klyo_update_game | wgrywa nową wersję gry, która już stoi w katalogu: paczka trafia do poczekalni z adresem podglądu, a odpowiedź niesie pomiar z plików: ile % kodu, wyglądu i dźwięku się zmieniło, nowe pliki i napisy, rodzaj zmiany |
klyo_release_version | wypuszcza czekającą wersję do graczy, ten sam krok co „Wypuść” w studiu; rodzaj zmiany domyślnie z pomiaru, „co nowego” przy nowej funkcji |
klyo_upload_package | wysyła paczkę prosto z twojego dysku, bez publicznego adresu |
klyo_fill_game_form | wypełnia na żywo otwarty formularz „Nowa gra” w studiu; ty patrzysz i poprawiasz, ankiety i oświadczeń nie dotyka, publikujesz sam |
klyo_game_translate | tłumaczenia tekstów gry robione przez twoje AI: najpierw oryginał i brakujące języki, potem propozycje, które zatwierdzasz w studiu |
klyo_creator_card | wizytówka twórcy: „o mnie” i hasło pisane na podstawie twoich gier, zapis dopiero po twojej zgodzie |
klyo_add_post | wpis w społeczności: pytanie, prośba o testy, premiera |
klyo_game_play | gra w twoją grę na twoim urządzeniu: studio otwarte u ciebie, zgoda jednym kliknięciem „Pozwól”; ruchy klawiatury, myszy i dotyku, a w odpowiedzi zdjęcia ekranu i stan gry, także gry 3D |
Pola i reguły: te same co w kreatorze
Asystent wypełnia dokładnie to, co człowiek klika w studiu. Limity stoją w schemacie narzędzia (bramka przed wywołaniem), a serwer sprawdza je drugi raz i odpowiada kodem błędu wskazującym pole.
| Nazwa | Do 30 znaków, jak w Google Play i App Store: sama nazwa gry, bez hasła i bez „zagraj za darmo”. Nie od cudzej marki. |
|---|---|
| Hasło pod nazwą | Obowiązkowe. Jedno zdanie do 80 znaków, bez kropki: czym gra jest, słowami, których gracz szuka. Stoi jako H2 i w tytule karty w Google. |
| Opis | Minimum 25 słów, do Google około 220 (krótszy = strona gry poza wyszukiwarką). Co się robi, jak wygląda partia, dla kogo, czym się różni. Jak człowiek: bez pauz „—”, bez „zanurz się”, bez list. |
| Język tekstu | Pole jezyk_tekstu (pl, en, de, fr, es, pt, it, ru, uk, tr) mówi, w jakim języku napisano teksty. Pozostałe języki tłumaczy twoje AI narzędziem klyo_game_translate, na twoim planie; każdy język przechodzi sprawdzenie i czeka w studiu na twoje „Zatwierdź”. Znaczniki <xx>…</xx> tylko dla wersji, którą twórca naprawdę napisał sam. |
| Rodzaj, półki, nastrój | Rodzaj z listy, do trzech; półki katalogu i nastrój opcjonalnie; listy są w schemacie i pochodzą z tego samego pliku, którym filtruje katalog. |
| Ankieta treści | Dziesięć pytań tak/nie (obiekt ankieta): przemoc rysunkowa, realistyczna, strach, wulgaryzmy, nagość, używki, hazard, interakcje, zakupy, dostęp do lokalizacji. Z odpowiedzi wynika etykieta wieku, reklamy i wejście do aplikacji w sklepach. Asystent ma zapytać twórcę, nie zgadywać. |
| Wiek od twórcy | wiek_min (3, 7, 12, 16, 18) może tylko podnieść etykietę ponad wynik ankiety, nigdy jej nie obniża. |
| Etap gry | etap: w_budowie, demo albo gotowa; przy dwóch pierwszych etap_dni (7 lub 30) mówi, kiedy przypomnieć o decyzji. Asystent ma o to zapytać. |
| Sklepy | sklep_play i sklep_apple: adresy tej samej gry w Google Play i App Store: odznaki na stronie gry i w tekstach udostępnienia. |
| Jak grać, partia, układ, wynik | Sterowanie na telefonie i komputerze (do 300 znaków), czas partii (do 40), układ poziom/pion/oba, najwyższy możliwy wynik jako zapora na tablicy. |
Które klienty AI działają z klyo
Stan na dziś, z naszego dziennika logowań, nie z obietnic. Gdy twój klient nie przechodzi logowania, połącz go kluczem: ten sam adres, te same narzędzia.
- ChatGPTdziała
Logowanie przez klyo (OAuth) w płatnym planie ChatGPT, w przeglądarce, z włączonym trybem dewelopera.
- Claudedziała
Logowanie przez klyo (OAuth), na stronie i w aplikacjach. Własny łącznik: wklej adres, a pola klienta OAuth zostaw puste.
- Własny program albo agentdziała
Klucz z dev.klyo.pl w nagłówku
Authorization: Bearer klyo_sk_…. Bez okna logowania. - Claude Code, Codex, Cursor, VS Codeniesprawdzone
Obsługują zdalne serwery MCP z logowaniem, ale u nas jeszcze nikt nie przeszedł nimi całej drogi. Gdy logowanie nie ruszy, użyj klucza.
Twój klient zatrzymał się na logowaniu? Serwer odpowiada wtedy kodem invalid_request z opisem. Wygeneruj klucz i podaj go w nagłówku: to działa w każdym kliencie, który pozwala dopisać nagłówek HTTP.
Własny agent: klucz zamiast logowania
Claude i ChatGPT logują się na twoje konto same. Jeśli piszesz własnego agenta albo skrypt, dostaniesz klucz i podasz go w nagłówku. To ta sama droga i te same narzędzia, tylko bez okna logowania.
- 01
Wygeneruj klucz w studiu
Na dev.klyo.pl, w zakładce „MCP i klucz” → „Klucz dla programu” kliknij „Wygeneruj klucz”, a potem „Sprawdź”: zobaczysz, ile narzędzi gier dostanie twój program i czy już się połączył. Pokazujemy go raz, więc zapisz go od razu. Klucz zaczyna się od
klyo_sk_i możesz go w każdej chwili unieważnić. - 02
Podaj go przy połączeniu
Nagłówek
Authorization: Bearer klyo_sk_…przy adresiehttps://panel.klyo.pl/mcp?profil=gry. Twój agent widzi dokładnie te narzędzia co Claude, ani jednego więcej. - 03
Sprawdzaj, co robi gra
Po otwarciu podglądu wywołaj diagnozę. Dostaniesz pliki, o które gra prosiła, a których nie ma w paczce, i błędy z przeglądarki, zamiast zgadywania z białego okna.
Przykład: pytanie o diagnozę
curl -s "https://panel.klyo.pl/mcp?profil=gry" \
-H "Authorization: Bearer klyo_sk_TWOJ_KLUCZ" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"klyo_game_diagnostics",
"arguments":{"slug":"lumina-thief"}}}'
Twoja przeglądarka jest okiem
Nie mamy farmy przeglądarek i nie potrzebujemy jej. Gra uruchamia się u ciebie, na twoim procesorze, a nasz czujnik w stronie podglądu melduje nam, co się w niej wysypało. Dzięki temu asystent widzi to samo, co zobaczyłbyś ty, otwierając grę.
- 01
Otwórz podgląd u siebie
Playwright, zwykły Chrome albo telefon z kodu QR. Dopisz do adresu
?s=twoj-znacznik(dowolne 1–24 znaki). - 02
Pograj naprawdę
Kliknij, przesuń, poczekaj na drugą planszę. Czujnik zbiera wyjątki, nieudane pliki, wpisy z konsoli i to, czy gra w ogóle wystartowała.
- 03
Zapytaj o diagnozę
klyo_game_diagnosticsz polemsesjarównym twojemu znacznikowi. Dostaniesz WYŁĄCZNIE błędy ze swojego przebiegu, a do tego liczbę cudzych, żeby nic nie znikło po cichu.
Kolejność ma znaczenie: pytanie zadane przed otwarciem gry zwróci pustą odpowiedź, bo nie było czego zebrać.
Asystent gra w twoją grę na twoim urządzeniu
Asystent w rozmowie nie ma ekranu, więc do tej pory znał grę tylko z listy błędów i z miniatur. Teraz może w nią zagrać: naciska klawisze, klika, dotyka i przeciąga, a po każdej serii ruchów dostaje zdjęcia ekranu i stan gry. Gra działa w studiu otwartym u ciebie, na twojej karcie graficznej, więc asystent widzi także gry 3D, których nasz serwer nie wyświetli. Serwer klyo nie rysuje ani jednego piksela, tylko przekazuje ruchy.
- 01
Otwórz studio
Wejdź na dev.klyo.pl na komputerze albo telefonie, na którym gra ma być sprawdzona. Jeśli asystent już poprosił o grę, od razu zobaczysz „Twój asystent chce zagrać w …” (prośba czeka 10 minut).
- 02
Kliknij „Pozwól”
Od tej chwili asystent może grać na tym urządzeniu. Gra otwiera się w okienku w rogu ekranu, a na telefonie na całym ekranie, i widzisz każdy ruch.
- 03
Asystent gra i patrzy
Wysyła do 40 ruchów naraz na jednej osi czasu do 3 sekund, także równocześnie: biegnij, obracaj kamerę, skacz. W odpowiedzi dostaje do 4 zdjęć ekranu, wiadomość, czy gra wystartowała, wynik i płynność samej gry.
- 04
Zatrzymaj, kiedy chcesz
„Zatrzymaj” w okienku gry albo „Wyłącz” na pasku kończy granie od razu. Kolejna prośba asystenta znowu zapyta cię o zgodę.
- Tylko twoje gry. Asystent otwiera wyłącznie gry twojego konta: wersję z warsztatu albo paczkę z poczekalni pod adresem podglądu, a gdy ich nie ma, wersję u graczy.
- Zdjęcia zostają w rozmowie. Trafiają tylko do rozmowy, która o nie poprosiła. Nie zapisujemy ich w bazie ani na dysku; w pamięci serwera czekają najwyżej 10 minut, żeby ponowione wywołanie nie grało drugi raz.
- Ruchy jak od gracza, z jednym zastrzeżeniem. Gra dostaje klawisze, kliknięcia, dotknięcia i ruch myszy jak od człowieka, ale przeglądarka oznacza je jako niezaufane. Pełny ekran i dźwięk czekają więc na twoje kliknięcie, a blokadę kursora dla gier z kamerą na myszy udajemy.
- Gra potrzebuje zestawu klyo. Ruchy wykonuje zestaw z
games.klyo.pl/sdk/klyo-gry-sdk.js. Gra bez niego albo ze starą kopią w paczce odpowiada „bez zestawu”, a asystent mówi, co podmienić. - Jedno granie naraz. Jedno wywołanie naraz na konto, do 600 na godzinę. Studio schowane w tle wstrzymuje grę, więc trzymaj je na wierzchu, obok rozmowy.
- Błędy z tego grania. Każda sesja ma własny znacznik czujnika, więc
klyo_game_diagnosticszsesjapokazuje wyłącznie błędy z gry asystenta. - Gdy bramka jakości pisze, że grafiki 3D jeszcze nie widzieliśmy. Nasz serwer mierzy grę bez karty graficznej, więc gry 3D nie zobaczy i nie da jej zielonego światła. Wtedy obraz z twojego urządzenia pokazuje asystentowi, czy gra działa, a decyzję o wydaniu podejmujesz ty, jak zawsze.
Instrukcja dla twórcy krok po kroku, z nazwami przycisków ze studia
Paczka z dysku, bez wystawiania gry światu
Nie stawiaj tunelu i nie wrzucaj niewydanej gry na publiczny hosting. Narzędzie klyo_upload_package oddaje asystentowi bilet wgrywania (token ważny godzinę, który otwiera wyłącznie wysyłanie plików na twoje konto) oraz listę paczek, które już czekają u nas bez gry. Asystent z powłoką (Claude Code, Codex, Cursor) wysyła plik sam, w dwóch żądaniach; asystent w rozmowie (claude.ai, ChatGPT) prosi cię, żebyś wgrał ZIP w studiu: paczka ląduje w poczekalni, nic się nie publikuje, a on bierze jej numer z listy. Poniżej ten sam przepis w skrócie.
- 01
Zapowiedz plik
POST /api/upload/initz nagłówkiemAuthorization: Bearer <bilet>i{ filename, total_size, content_type }→ dostajeszupload_idichunk_size. - 02
Wyślij bajty
PATCH /api/upload/<upload_id>z tym samym biletem,Upload-OffsetiContent-Type: application/offset+octet-stream. Do 32 MB jednym żądaniem; większy plik w kawałkach. Przerwane wysyłanie wznów:HEADpoda, ile już mamy. - 03
Wydaj albo podmień
klyo_publish_gamelubklyo_update_gamezupload_idzamiastzip_url.
Publiczny adres ZIP-a zostaw dla gry, która naprawdę stoi już w sieci, na przykład przy przenoszeniu z itch.io.
Standard produkcyjny gry: asystent zna minimum, zanim napisze kod
Zwykły człowiek pisze do swojego asystenta „chcę grę w statki”. Asystent podłączony do klyo najpierw woła klyo_game_requirements i dostaje kontrakt: telefon, tablet i komputer; dotyk, mysz i klawiatura; pion i poziom z reakcją na zmianę rozmiaru; dźwięk z odzyskaniem po powrocie z tła; zapis, tablica wyników, pauza i powtórka jednym gestem; jedna paleta i jeden styl; bez cudzych marek i bez cudzych reklam. Nie pyta o to użytkownika, tylko od razu buduje na tym poziomie. Wersja 1 standardu jest zamrożona od 23.09.2026: nowy wymóg dochodzi tylko wtedy, gdy prawdziwa gra na klyo trafi na prawdziwy problem.
- Test u siebie, nie na naszym serwerze. Asystent pobiera
games.klyo.pl/sdk/klyo-test.mjsi uruchamia go lokalnie: cztery ekrany, przewijanie, ułamek ekranu, tekst, nasłuchy dotyku, waga, czas, wyjątki. Przed wydaniem dokłada--slaby-telefon --jezyki: tani telefon i oba języki. Wynik makrytyczneiostrzezenia, więc poprawia i testuje w pętli, aż przejdzie. Ciężką pracę robi komputer twórcy; klyo mierzy przy wgraniu i wydaniu tym samym plikiem. - Bramka jakości, także dla paczki wgranej ręcznie. Każda paczka w poczekalni jest mierzona na czterech ekranach zaraz po wgraniu;
klyo_game_diagnosticsi okno podglądu w studiu pokazują tę samąbramka: wyjątki, brakujące pliki, cudze reklamy, brak zestawu, brak dotyku i przewijanie blokują wydanie jako „gotowa” (demo i „w budowie” przechodzą); mały ekran, mały tekst, waga, brak tablicy i cudze marki wymagają powodu. - Etapy wydania. Lokalnie → podgląd (
g-podglad-…, poza katalogiem i Google) → publikacja z etapemw_budowie/demo/gotowa→ nowa wersja z podglądem, gracze grają w starą, poprzednia zostaje do przywrócenia. Człowiek zatwierdza dwa momenty: publikację i wypuszczenie wersji.
Nowa wersja gry: przez asystenta tak samo jak w studiu
Trzy kroki, te same co przyciski „Nowa wersja” i „Wypuść” w studiu. Asystent nie zgaduje, co się zmieniło: mierzymy to z plików i mówimy mu, co z tego wynika dla klipu. Klip do nowej wersji nagrywasz sam: w studiu, po wypuszczeniu (okno nagrywania otwiera się samo przy nowym wyglądzie albo funkcji).
- 01
Wgraj
klyo_update_gamezslugiupload_id(plik z dysku) albozip_url. Gra w katalogu nie zmienia się od razu: nowa wersja czeka w poczekalni pod własnym adresem podglądu. Odpowiedź:zmiana(kod / wygląd / dźwięk w %, nowe pliki i napisy,podpowiedz: poprawka | funkcja | interfejs),adres_nowej,wyrokidalej. - 02
Zagraj
To twoje sprawdzenie, nie asystenta: otwórz adres podglądu, najlepiej na telefonie. Studio pokazuje tę samą wersję w oknie gry z torem „wersja → zagraj → wypuść → klip”.
- 03
Wypuść
klyo_release_versionzslug;zmianapomiń (weźmiemy zmierzoną) albo podaj, gdy wiesz lepiej;nowoscto jedno zdanie do feedu przy nowej funkcji. Przed podmianą cała nowa wersja przechodzi sito jeszcze raz. Gracze dostają ją od razu (kto gra, wybiera: zaktualizuj albo dokończ partię), poprzednia zostaje u nas, strona gry się przebudowuje, a ekrany mierzymy raz, po wypuszczeniu. Obserwujący dostają powiadomienie, gdy gra jest w katalogu.
Skutek dla klipu: przy poprawce klip zostaje; przy nowej funkcji klip zostaje, a „co nowego” idzie do feedu jako „Nowość”; przy nowym wyglądzie (interfejs) stary klip schodzi z kafelka i z feedu, dopóki nie nagrasz nowego w studiu.
Poprawka bez ZIP-a: warsztat gry
Asystent czyta pliki twojej gry i poprawia je u nas, bez paczki od ciebie. Działa to z grą w katalogu i z paczką, która czeka w poczekalni. Gracze do końca grają w wersję, którą znają: poprawki trafiają do warsztatu, czyli nowej wersji obok, z własnym adresem podglądu. Wypuszczasz ją tak samo jak każdą nową wersję.
- 01
Zacznij od zera, jeśli gry jeszcze nie ma
klyo_game_patchznowa(plansza,zrecznosciowaalbologiczna) zakłada paczkę ze szkieletu Klyo Kit prosto w poczekalni i w tym samym wywołaniu wpisuje rozgrywkę. Asystent w rozmowie, bez dysku i bez ZIP-a, ma od tej chwili własną grę pod adresem podglądu. - 02
Przeczytaj
klyo_game_fileszsluggry alboupload_idpaczki. Bezpathdostajesz spis plików ze skrótemhash, zpathtreść pliku (do 200 KB naraz, dalej odfrom_line), a zchanges: trueróżnice nowej wersji względem tej u graczy. - 03
Popraw
klyo_game_patchz listąedits: dokładny fragmentold_stringzamieniony nanew_string, cały plik wcontentalbodelete: true. Przy pliku, który istnieje, podajeszexpected_hashz odczytu: jeśli ktoś zmienił plik w międzyczasie, nic się nie zapisze. Zmiany z jednego wywołania wchodzą wszystkie albo żadna. Pierwsza poprawka otwiera warsztat, a studio od razu pokazuje go jako „Nowa wersja czeka”. - 04
Zagraj i sprawdź
Adres podglądu przychodzi w odpowiedzi. Otwórz go (najlepiej na telefonie), a
klyo_game_diagnosticspokaże błędy, brakujące pliki i sito właśnie tej wersji, a nie tej u graczy. Asystent bez przeglądarki podajezmierz: true: otwieramy podgląd za niego i oddajemy błędy oraz miniatury czterech ekranów pod pełnymi adresami, więc widzi, jak gra wygląda. Pliki bez zmian od pomiaru nie uruchamiają przeglądarki drugi raz; jeden pomiar naraz na konto, sześć na godzinę. Asystent może też zagrać sam, na twoim urządzeniu:klyo_game_play, opis wyżej. - 05
Wypuść
Gra:
klyo_release_versionalbo „Wypuść” w studiu. Paczka z poczekalni:klyo_publish_gamewyda ją razem z poprawkami. Przed podmianą cała gra przechodzi sito jeszcze raz.
- Wersja u graczy się nie zmienia. Warsztat to kopia obok, a każdy zapis tworzy nowy plik, więc to, co pobierają gracze, nie zmienia się ani na chwilę.
- Tekst w rozmowie, pliki biletem. Treść zmiany zapisuje pliki tekstowe (html, htm, js, mjs, css, json, svg, txt, xml, webmanifest). Obraz, dźwięk, czcionkę albo duży plik (do 20 MB) asystent wysyła biletem z
klyo_upload_packagei podaje wfrom_upload: bez base64, a początek pliku musi pasować do rozszerzenia. - To samo sito co przy wgraniu. Każdy zmieniony plik sprawdzamy od razu: złośliwy kod, cudze reklamy, nic spoza klyo. Odmowa nie zapisuje niczego.
- Limity. Plik do 1 MB, jedno wywołanie do 256 KB i 20 zmian, trzy otwarte warsztaty na konto i jeden na grę, do 300 poprawek na godzinę. Wypuszczeń, cofnięć i nowych paczek do 10 na godzinę: każde uruchamia pomiar ekranów, a przeglądarka do pomiarów jest jedna dla wszystkich twórców.
- Porządek. Warsztat bez zmian przez 7 dni wygasa, a wersja u graczy zostaje nietknięta. Podgląd, na który nic już nie wskazuje, znika po 7 dniach. Adresy podglądów nie trafiają do Google.
- Ślad. Każda poprawka zapisuje się w dzienniku twojego konta: plik, skrót przed i po, rozmiar.
- Cofanie w trakcie pracy. Przed każdą poprawką zapisujemy punkt
auto-N(jest w odpowiedzi), a asystent może nazwać własny przezcheckpoint.revertwraca do dowolnego punktu,discardporzuca cały warsztat. To nie jest cofnięcie wydania: gracze nic z tego nie widzą. - Przed wydaniem także słaby telefon. Przy wgraniu i wypuszczeniu mierzymy grę jeszcze raz na telefonie z procesorem spowolnionym czterokrotnie i siecią jak słabe 3G: płynność, zacięcia, pamięć i czas do pierwszej klatki. Poniżej 15 klatek na sekundę gra nie przejdzie bramki jako gotowa. Asystent bez przeglądarki zamawia ten sam pomiar przed wydaniem:
klyo_game_diagnosticszzmierzipelny. - W każdym języku gry. Klyo Kit mówi dziesięcioma językami (polski, angielski, niemiecki, francuski, hiszpański, portugalski, włoski, rosyjski, ukraiński, turecki), a gra tymi, w których ma swoje napisy. Ten sam telefon otwieramy w każdym zadeklarowanym języku, z miniaturą. Klucz zamiast słowa i język zadeklarowany, którego gra nie pokazuje, blokują wydanie; angielski w miejscu tłumaczenia, zdanie takie samo jak po angielsku i tekst, który nie mieści się w przycisku albo wychodzi poza ekran, to ostrzeżenia. Napisy rysowane na płótnie sprawdzasz na miniaturach obok siebie.
- Wolne klatki z przyczyną. Sama liczba klatek nie mówi, czyja to wina. Mierzymy osobno czas kodu gry w każdej klatce, pracę przeglądarki i to, jaka część obrazu naprawdę się zmienia. Wolny kod to
niski_fps; lekki kod i wolne rysowanie towolne_rysowaniez radą, co rysować raz, a co co klatkę. - Bezpieczeństwo. Kod gry otwieramy u siebie wyłącznie w odizolowanej przeglądarce, bez dostępu do naszej sieci wewnętrznej. Gra pod własnym adresem nie może też działać w imieniu zalogowanego gracza.
Przegląd jakości premium: siedem punktów przed wydaniem
Bramka łapie błędy, ale nie powie, czy gra wygląda tanio. Dlatego asystent, zanim wyda grę jako gotową albo wypuści nowy wygląd lub funkcję, przechodzi siedem punktów i przy każdym podaje dowód: co konkretnie zrobił. Nie oceniamy gustu i nie mamy własnego modelu. Zestawiamy deklarację ze śladami w kodzie i pokazujemy ci w studiu punkty, których kod nie potwierdza, zanim klikniesz „Wypuść”.
- Grafika: jeden kierunek artystyczny: jedna paleta, jeden styl, scena i elementy z jednej skóry, żadnych gołych prostokątów.
- Animacja: każda zmiana stanu ma przejście, jest animacja wygranej i przegranej, a ruch wyłącza się u osób, które tego chcą.
- Dźwięk: dźwięk na każdą akcję i każdy wynik, wyciszenie w ustawieniach, powrót dźwięku po wyjściu z tła.
- Reakcja na ruch: odpowiedź na każdą akcję w 100 ms: obraz, dźwięk, na telefonie wibracja; widać, czyj ruch i dlaczego ruch jest niedozwolony.
- Motyw jasny i ciemny: oba warianty według ustawień urządzenia i przełącznik w grze.
- Języki: wszystkie napisy z tabeli tłumaczeń, co najmniej polski i angielski, każdy zadeklarowany język sprawdzony na telefonie (nie dotyczy gry bez słów).
- Online: zaproszenie linkiem, czekanie na przeciwnika, powrót po rozłączeniu, rewanż jednym gestem (nie dotyczy gry solo).
Tablica wyników: gra, która deklaruje wynik (wynik_max), a nie wysyła go przez klyo.score, nie przejdzie bramki jako gotowa. Gra bez punktów podaje powód w opisie. Przy demo i grze w budowie przegląd można pominąć, a przy samej poprawce (zmiana: "poprawka") też.
Częste pytania
Co tu znaczy MCP?
Model Context Protocol: otwarty standard, przez który asystent AI woła narzędzia na cudzych serwerach. To nie jest hosting. Platformą jest klyo games, a MCP to sposób, w jaki twój asystent z nią rozmawia: wysyła paczkę, wypełnia opis i oddaje link do gry.
Którzy asystenci AI wydadzą grę na klyo?
Każdy klient, który obsługuje zdalne serwery MCP z logowaniem. Instrukcje krok po kroku mamy dla: Claude (claude.ai, aplikacje i Claude Code), ChatGPT w trybie dewelopera, Cursor, VS Code z Copilotem, opencode i Gemini Enterprise. Adres serwera dodajesz raz; pierwsze wywołanie narzędzia otwiera logowanie klyo i zakłada konto.
Skąd asystent weźmie adres paczki?
Z miejsca, w którym już pracujecie: repozytorium, dysk, własny serwer. Adres musi być publiczny i prowadzić prosto do pliku ZIP, w którym na wierzchu leży index.html. Paczka może ważyć do 350 MB i zawierać do 5 000 plików.
Czy to działa z Unity i Godotem?
Tak, jeśli eksportujesz do przeglądarki. Przyjmujemy pliki WebAssembly, dane Unity i paczki Godota tak samo jak zwykły HTML z JavaScriptem.
Co, jeśli gra nie wstanie?
Zobaczysz to w podglądzie, zanim cokolwiek wypuścisz. Jeśli grze brakuje pliku, powiemy którego, a przy przenoszeniu z innego portalu dobierzemy brakujące pliki spod adresu źródłowego.
Czy asystent poprawi grę bez paczki ZIP?
Tak. klyo_game_files czyta pliki gry, a klyo_game_patch poprawia pliki tekstowe w warsztacie, obok wersji, w którą grają gracze. Zmiany widzisz w studiu jako „Nowa wersja czeka” i wypuszczasz je jednym kliknięciem. Obrazy i dźwięki nadal podmienia się paczką.
Agent widzi, co się dzieje w grze?
Widzi to, co widziałaby konsola przeglądarki po twojej stronie: pliki, o które gra poprosiła bezskutecznie, i błędy JavaScriptu w kolejności, w jakiej wystąpiły. Zbieramy je, dopóki gra CZEKA: w podglądzie paczki i pod własnym adresem przed twoim kliknięciem „Wypuść do katalogu”. W chwili publikacji przestajemy: gra należy wtedy do gracza i nie wysyła nam niczego.
Czy klyo płaci za moje AI albo widzi moje logowanie?
Nie. Twoje AI działa na twojej subskrypcji, a logowanie zostaje u ciebie, tak jak w VS Code i w Cursorze. My dostajemy tylko gotowy tekst i nic nie publikujemy bez twojej zgody.
Jak wybrać języki tłumaczenia?
W oknie „Przetłumacz swoim AI” klikasz języki, które chcesz. Możesz też napisać w rozmowie „a teraz niemiecki”. Każdy język pojawia się w oknie „Tłumaczenia” do zatwierdzenia.
Skąd wiem, że moje AI jest połączone z klyo?
Okno w studiu pokazuje to po kliknięciu: znak ✓ i nazwę połączonego AI. Pełna lista połączeń i odłączanie są na stronie połączeń.
Dlaczego strony mojej gry nie ma w Google?
Strona gry wchodzi do Google, gdy w danym języku ma co najmniej 220 słów opisu napisanego albo przyjętego przez twórcę oraz nazwę i hasło w tym języku. Krótsza ma zakaz indeksowania, żeby cienka strona nie ciągnęła w dół całego portalu. Tak samo strona, która w ponad 42% powtarza inną stronę gry: wtedy dopisz zdania, które mówią tylko o tej grze. klyo_my_games pokazuje przy każdej grze w tlumaczenia.indeks powód z liczbami, na przykład „opis ma 198/220 słów”. Strony gier są po polsku i po angielsku, a teksty mogą mieć dziesięć języków.
Jak sprawdzić, co Google widzi teraz?
klyo_game_stats z sprawdz_google: true pyta Google o strony gry w tej chwili (raz na godzinę na grę) i przy każdej stronie podaje, kiedy pytaliśmy i kiedy robot Google był na niej ostatnio. O ponowne zindeksowanie zwykłej strony prosi się w Search Console przyciskiem przy adresie: Google nie przyjmuje takiej prośby przez API, a mapa witryny zgłasza stronę sama.
Kiedy powstaje strona kategorii, na przykład pasjans?
Gdy w kategorii są co najmniej trzy gry. Strona z jedną grą to dla Google kopia kafla, a za takie strony obniża cały portal. Pierwsza gra w kategorii może zajść wysoko sama, stroną gry z pełnym opisem; strona kategorii dołączy przy trzeciej.
Mój klucz nie widzi części narzędzi. Co zrobić?
klyo_status wypisuje ukryte narzędzia, powód (zakres albo rodzaj konta) i sposób odblokowania. Zakres klyo:publish obejmuje poprawki podglądu (klyo:edit_preview), a nowe klucze ze studia mają komplet zakresów.
Sprawdzanie opisu zatrzymało grę. Dlaczego?
Odmowa zawsze podaje słowo, które ją spowodowało. Opis sprawdzamy w języku każdego znacznika (<en>, <pl>), a słowa gatunku, jak strzał w Statkach czy strzelanie kulką, nie wymagają zaznaczenia przemocy w ankiecie. Przemoc to zabijanie, krew, broń i gatunek strzelanki.
Jak usunąć paczkę z poczekalni?
klyo_delete_game z upload_id zamiast slug. Paczka, z której powstała już gra, zostaje, bo jest podglądem tej gry.
Bramka pisze „wyjątki”, a gra działa. Co to znaczy?
Wyjątek to błąd JavaScriptu zgłoszony przez przeglądarkę. Meldunki stanu gry (stan:) i dziennik nagrywania (obraz:, kompozyt:) wyjątkami nie są i wydania nie zatrzymują. Wynik wysyłany przez zestaw trzymany w zmiennej też się liczy: podgląd melduje wtedy „gra wysłała wynik”.
Czy gry online przetrwają zerwane połączenie?
Tak. Każdy ruch ma numer i własny identyfikator. Gdy telefon na chwilę straci sieć, strona po powrocie dociąga ruchy, które ominęły gracza, raz i w kolejności, a ruch wysłany w złej chwili ponawia się sam, bez dublowania. Szybki mecz sam dobiera przeciwnika, a „Wyjdź z pokoju” naprawdę zamyka pokój.
Odpowiedź narzędzia jest za duża dla asystenta. Co zrobić?
Użyj limit. klyo_ads_ideas oddaje najpopularniejsze frazy (domyślnie 50, z liczbą wszystkich), a z tylko_zarodki tylko podane frazy z liczbami. klyo_keyword_map skraca listy do 40 i liczy stan z całości. klyo_my_games niesie przy grze sam wyrok nagrania, bez pomiarów.
Czy mogę zmierzyć grę w wybranych językach?
Tak. klyo_game_diagnostics z zmierz, pelny i jezyki: ["pl","en","de"] sprawdza dokładnie te języki, razem ze słabym telefonem. Drugi pomiar zamówiony w czasie pierwszego czeka w kolejce i rusza sam.
Czy asystent może sam zagrać w moją grę?
Tak, na twoim urządzeniu. Otwórz studio na dev.klyo.pl i kliknij „Pozwól”, gdy asystent poprosi. Gra działa u ciebie, na twojej karcie graficznej, a asystent wysyła ruchy i dostaje zdjęcia ekranu. Serwer klyo gier nie wyświetla, a granie zatrzymasz jednym kliknięciem.
Czy muszę używać asystenta?
Nie. Wszystko, co robi narzędzie, zrobisz w przeglądarce na dev.klyo.pl: wybierasz paczkę, od razu widzisz grę w oknie i uzupełniasz opis.