Hranostaj pro AI agenty a API

Hranostaj už není jen web pro lidi. Sbírku her teď můžete napojit i na vlastní aplikaci nebo na svého AI asistenta. Slouží k tomu dvě rozhraní: API pro vývojáře a MCP server pro AI asistenty jako Claude nebo ChatGPT. Obojí je zdarma, bez registrace.

K čemu to je

• API se hodí, když píšete vlastní aplikaci, web nebo skript a chcete v něm vyhledávat hry z Hranostaje, zobrazovat jejich pravidla nebo žebříčky.
• MCP se hodí, když chcete, aby váš AI asistent uměl sám prohledávat Hranostaj. Místo vymýšlení her „z hlavy“ pak vybírá ze skutečných her, které sepsali a ohodnotili lidé, a přidá k nim odkaz na originál nebo na přílohy, případně může zkombinovat více her a vytvořit tak úplně novou.

Obě rozhraní slouží jen ke čtení. Hry přes ně nelze přidávat, měnit ani mazat.

API pro vývojáře

API běží na adrese https://www.hranostaj.cz/api a vrací JSON. Kompletní popis všech endpointů najdete v dokumentaci OpenAPI. Strojově čitelná specifikace je na https://www.hranostaj.cz/openapi/hranostaj.yaml a můžete ji rovnou předhodit svému AI nástroji, pokud „vibecodujete“.

MCP server pro AI asistenty

MCP (Model Context Protocol) je standard, přes který si AI asistenti připojují další nástroje. Říká se jim konektory. Když si do svého asistenta přidáte konektor Hranostaje, může sám hledat hry a číst jejich pravidla.

Adresa MCP serveru je:

https://www.hranostaj.cz/mcp

Server nevyžaduje přihlášení.

Po připojení se stačí normálně zeptat, například:

• „Najdi na Hranostaji pět her do tělocvičny pro 15 dětí kolem deseti let, bez pomůcek.“
• „Potřebuju program na táborový den pro skauty, venku, na celé odpoledne. Vyber vhodné hry z Hranostaje a dej mi odkazy na tisk.“
• „Jaké jsou teď nejlépe hodnocené hry na Hranostaji?“

Hry jsou psané česky, asistent vám je ale klidně shrne nebo přeloží. Rozhodující je vždy původní znění na webu.

Jak přidat konektor do Claude

Vlastní konektor jde přidat ve všech tarifech včetně bezplatného. V bezplatném tarifu můžete mít jeden vlastní konektor.

1. Na claude.ai nebo ve své aplikaci otevřete Settings → Customize → Connectors
2. Klikněte na Add custom connector (případně Add → Custom → Web).
3. Jako název zadejte Hranostaj a jako URL https://www.hranostaj.cz/mcp. Přihlášení není potřeba, takže pokud se dialog ptá, zvolte No sign-in.
4. Klikněte na Add.
5. V konverzaci klikněte na +, vyberte Connectors a zkontrolujte, že je Hranostaj zapnutý.

V tarifech Team a Enterprise přidává vlastní konektor správce (Owner) organizace v Organization settings → Connectors. Ostatní členové si ho pak jen připojí.

Konektor přidaný na webu funguje i v aplikaci Claude pro počítač.

Jak přidat konektor do ChatGPT

Vlastní MCP servery v ChatGPT nejsou dostupné v bezplatném tarifu. Fungují v placených tarifech (Plus, Pro, Business, Enterprise, Edu); ve firemních tarifech je obvykle přidává správce.

1. Na chatgpt.com otevřete stránku Plugins (přes nastavení).
2. Klikněte na Add (nebo +) a zvolte Create custom MCP server.
3. Zadejte název Hranostaj a URL https://www.hranostaj.cz/mcp. Jako způsob ověření zvolte možnost bez přihlášení.
4. Potvrďte upozornění o rizicích a dokončete vytvoření.
5. V konverzaci vyberte Hranostaj v nabídce nástrojů pod tlačítkem +.

OpenAI tento postup v posledních měsících několikrát měnilo. Ve starší verzi bylo potřeba nejdřív zapnout Developer mode v Settings → Apps → Advanced settings. Pokud u sebe vidíte jiné názvy, hledejte v nastavení položku pro přidání vlastní aplikace nebo MCP serveru.

Pro pokročilé: Claude Code a další nástroje

Pokud používáte Claude Code, přidáte Hranostaj jedním příkazem:

claude mcp add --transport http hranostaj https://www.hranostaj.cz/mcp

Podobně jde MCP server připojit i do dalších klientů, které podporují vzdálené MCP servery přes HTTP (Streamable HTTP). Stačí jim zadat výše uvedenou adresu.

Pravidla používání

API i MCP jsou zdarma. Hranostaj je ale neziskový projekt na omezeném hostingu, proto prosíme:

• Nezahlcujte rozhraní velkým množstvím požadavků a nestahujte hromadně celý obsah webu. Pokud potřebujete větší objem dat, napište na info@hranostaj.cz.
• Obsah her je pod licencí GNU FDL 1.3. Když hru převezmete a zveřejníte jinde, uveďte jako zdroj Hranostaj.cz (na webu odkazem) nebo původní zdroj hry. To platí i pro text, který převypráví AI asistent.
• Rozhraní se mohou časem měnit. Přesná pravidla najdete v podmínkách použití.

Zkusili jste s tím něco zajímavého, nebo vám něco nefunguje? Napište nám, rádi se podíváme.