MCP konektor — připojení AI přímo k Builderu

Funkce pro plán Business Premium. MCP (Model Context Protocol) je otevřený standard, přes který se AI klienti — Claude Code, Claude Desktop a další — připojují k externím službám. S MCP konektorem vaše AI pracuje přímo v Builderu: tvoří prezentace, navrhuje šablony a překládá hotové prezentace — sama si načte návod, provede úkol a vrátí vám odkaz do editoru. Žádné ruční kopírování JSON.

V dialogu MCP (tlačítko na seznamu prezentací) si nahoře vyberte, kterého klienta používáte. Doporučená cesta je Claude Desktop / web — připojíte se přihlášením, bez tokenu i terminálu.

Claude Desktop / web (nejjednodušší — přes přihlášení)

Co potřebujete: aplikaci Claude Desktop nebo web claude.ai (plán Pro/Max). Žádný token, žádný terminál, žádná instalace.

Otevřete konektory — v Claude: Settings (Nastavení) → Connectors (Konektory) → Add custom connector (Přidat vlastní konektor).
Vložte adresu Builderu:
```
https://pmgclub.com/api/mcp
```
(Adresu najdete i v dialogu MCP v Builderu, s tlačítkem pro zkopírování.)
Přihlaste se a schvalte — klikněte Connect (Připojit) → přihlaste se k PMG Clubu → na souhlasné obrazovce klikněte Schválit a pokračovat.
Hotovo — Claude vidí nástroje Builderu. Přístup můžete kdykoli odvolat v Claude (tlačítko Disconnect) nebo v Připojených aplikacích na svém účtu.

Claude Code (v terminálu — přes token)

Pro AI asistenta v terminálu. Co potřebujete: účet Claude (Pro/Max) a aplikaci Claude Code.

Otevřete terminál — Mac: Cmd+mezerník → napište „Terminal" → Enter; Windows: PowerShell
Nainstalujte Claude Code (jednorázově) — vložte a potvrďte Enterem:
```
npm install -g @anthropic-ai/claude-code
```
Pokud terminál nezná npm, nainstalujte nejdřív Node.js z nodejs.org (tlačítko LTS) a terminál otevřete znovu.
Přihlaste se — napište claude, Enter, dokončete přihlášení v prohlížeči, pak Claude ukončete příkazem /exit
Vytvořte token — v Builderu klikněte MCP → záložka Claude Code → Vytvořit token. Token se zobrazí jen jednou; dialog rovnou nabízí hotový příkaz:
```
claude mcp add --transport http builder https://pmgclub.com/api/mcp --header "Authorization: Bearer VÁŠ_TOKEN"
```
Připojte Builder — zkopírovaný příkaz vložte do terminálu a potvrďte Enterem
Ověřte — spusťte claude a napište /mcp; v seznamu má být builder — connected

Vzorové pokyny

Pište normálně česky, Claude si vše vyřídí sám a vrátí odkaz do editoru:

„Vytvoř mi v Builderu prezentaci o našem věrnostním programu pro kavárny, 8 slidů, česky, s texty pro voice over."
„Navrhni mi v Builderu šablonu v barvách mé značky (tmavě modrá #0E1B2C a zlatá), slug moje-znacka. Pak mi v ní vytvoř prezentaci o letní nabídce."
„Vytvoř v Builderu prezentaci v designu moje-znacka o novém ceníku."
„Přelož mou prezentaci ‚Letní nabídka' do angličtiny." (texty i voiceover skripty; uloží se jako druhý jazyk do téhož souboru)
„Vytvoř novou prezentaci o Q4 výsledcích ve stejném stylu jako moje prezentace ‚Firemní šablona'." (převezme vzhled existující prezentace)
„Vypiš mé prezentace v Builderu."

Co AI přes konektor umí

Nástroj	Popis
`get_story_guide`	načte si aktuální návod a pravidla formátu
`list_designs`	zjistí designy, na které máte nárok (vč. vyhrazených)
`import_story`	vytvoří novou editovatelnou prezentaci (volitelně do složky), vrátí odkaz
`add_slides_to_presentation`	přidá slidy do existující prezentace (na konec nebo za index)
`replace_slides`	přetvoří (nahradí) rozsah slidů — destruktivní, se zálohou
`list_presentations`	vypíše vaše prezentace (včetně složky)
`list_folders`	vypíše vaše složky v Builderu
`create_folder`	založí složku
`get_design_guide`	načte si návod, jak navrhnout vzhled (šablonu)
`import_design`	vytvoří návrh šablony — vy ho doladíte v editoru
`get_translation_guide`	načte si návod, jak přeložit prezentaci
`get_presentation_texts`	vytáhne texty prezentace k překladu (texty slidů, voiceover skripty, titulky videa)
`set_presentation_translations`	uloží překlad jako druhý jazyk do téhož souboru (překryv)
`create_translated_copy`	vytvoří samostatnou přeloženou kopii — jakýkoli jazyk (i vietnamština)
`get_qlive_guide`	načte si návod, jak vytvořit Q-Live (živá anketa/kvíz)
`create_qlive_event`	vytvoří živou anketu/kvíz (koncept) i s otázkami, vrátí kód k připojení
`list_qlive_events`	vypíše tvé Q-Live eventy
`add_qlive_to_presentation`	vloží Q-Live (QR / živé výsledky) přímo do prezentace — nový nebo existující slide
`get_studio_guide`	načte si návod, jak vytvořit skladbu ve Studio3 BOX
`compose_song`	vytvoří skladbu ve Studio3 BOX z hudebního záměru (styl/nálada/bloky)
`list_songs`	vypíše tvé skladby ve Studio3 BOX

Záměrně nic víc: AI nemá přístup k mazání, exportům ani sdílení.

AI jako designér: přes import_design může vaše AI navrhnout i celý vzhled — vznikne jako šablona, kterou doladíte v editoru (finální slovo máte vy), a se slugem ji od té chvíle AI používá jako design pro obsah. Vzor: „Navrhni mi v Builderu šablonu v barvách mé značky (tmavě modrá + zlatá) a pak v ní vytvoř prezentaci o…"

Překlad prezentace přes vaši AI

Vaše AI umí přeložit i hotovou prezentaci — a to zdarma, protože překládá sama. Překlad se uloží jako druhý jazyk do TÉHOŽ souboru (originál v češtině zůstává), úplně stejně, jako byste v editoru klikli na Přeložit. Přeloží se texty na slidech, skripty pro voiceover i titulky videa.

Řekněte třeba: „Přelož mou prezentaci ‚Letní nabídka' do angličtiny." AI si načte návod, vytáhne texty, přeloží je a zapíše zpět. Pak:

Otevřete prezentaci v editoru.
Přepněte jazyk na cílový (např. EN) — uvidíte přeloženou verzi.
Zkontrolujte a případně ručně doupravte (vaše korekce mají přednost).
U voiceoveru si k přeloženému skriptu v editoru vygenerujte hlas.

Podporované jazyky (překryv s přepínačem): angličtina, němčina, francouzština, španělština, italština, polština, slovenština, ukrajinština.

Nebo samostatná kopie (jakýkoli jazyk). Když chceš plnou lokalizovanou verzi pro daný trh — třeba vietnamskou — řekni: „Vytvoř vietnamskou kopii mé prezentace." AI naklonuje deck a texty přeloží napřímo → vznikne nová samostatná prezentace (originál zůstane beze změny), kterou nezávisle upravíš, nadabuješ a exportuješ. Funguje pro libovolný jazyk. Kopie je snímek — když pak změníš originál, kopie se sama neaktualizuje.

Q-Live (živá anketa/kvíz) přes AI

Tvoje AI umí přes konektor vytvořit i Q-Live — živou anketu nebo kvíz, do které se publikum připojí kódem a hlasuje z mobilu. Řekni třeba: „Vytvoř mi ke slidu o platbách Q-Live kvíz, 5 otázek." AI založí event jako koncept (nic neběží, dokud ho naživo nespustíš) a vrátí 6místný kód pro připojení.

Otázky můžou být: výběr z možností, kvíz se správnou odpovědí, hodnocení na škále, slovní mrak nebo volná odpověď.

Vložení do prezentace — automaticky: AI umí Q-Live vložit do decku sama (add_qlive_to_presentation) — buď jako nový samostatný slide (nadpis + QR/výsledky), nebo na konkrétní stávající slide. Takže „Vytvoř prezentaci o platbách a na konec přidej Q-Live kvíz" zvládne AI na jeden pokyn. Widget můžeš potom v editoru posunout.

Nebo ručně: v Builderu přidej objekt Q-Live (živé výsledky) nebo Q-Live QR a vyber event podle vráceného kódu.

Na plátně se ukáže QR/kód k připojení a živé výsledky. Event se aktivuje až při živém spuštění — do té doby nezatěžuje nic.

Hodí se hlavně když stavíš celou prezentaci přes vlastní AI: necháš ji rovnou připravit i ankety z kontextu obsahu a rovnou je vložit.

Úpravy existující prezentace a zálohy

AI umí přes konektor i upravit hotovou prezentaci — přidat slidy (add_slides_to_presentation) nebo přetvořit rozsah slidů (replace_slides). Aby vám AI nikdy nepřepsala práci nevratně:

Před každou úpravou přes MCP se automaticky uloží záloha předchozího stavu (týká se i překladů a vkládání Q-Live).
V editoru se objeví žlutý pruh „⚠️ Upraveno přes MCP" s tlačítkem Zálohy — uvidíte seznam s časem a důvodem a jedním klikem Vrátíte libovolnou verzi. (Vrácení se samo taky zazálohuje, takže není co pokazit.)
Přetvoření (replace_slides) je destruktivní — nahrazené slidy ztratí svůj ruční design. AI je vedená k tomu, aby se vás napřed zeptala a upozornila, že se prezentace může výrazně změnit.

Drží se posledních ~20 záloh na prezentaci.

Studio3 BOX — hudba přes AI

Přes konektor umí tvoje AI vytvořit i skladbu ve Studio3 BOX. Neskládá noty sama — dodá jen záměr (styl, nálada, délka) a hudbu složí vestavěný engine. Řekni třeba: „Vytvoř mi ve Studio3 svižnou taneční skladbu, 8 bloků."

Styly: vzlet (melodická/budovaná), party (svižná taneční), miniatura (kratší, klidnější). Nálada světlá/temná, délka 4/8/12 bloků.
Vrátí DNA (krátký kód) — stejné DNA = stejná skladba, takže si ji uložíš nebo z ní uděláš variace.
Kromě záměru můžeš AI požádat i o doladění zvuku: bicí kit, hlasy (pad/lead/bass), BPM, delay a hlavně reverby — master reverb i samostatný reverb na každý hlas (bicí/akordy/melodie/bas), buď jen síla, nebo plný reverb (délka, předzpoždění, filtry, reverzní dozvuk). Např. „…s velkým reverbem na melodii a piano lead."
Můžeš doladit i parametry syntézy každého nástroje (posuvníky „🎛 Zvuk") — např. „e-piano méně kovové a s delším pingem, smyčce velká sekce." AI si přesné parametry a rozsahy načte z návodu.
Skladba se objeví ve Studio3 BOX → Moje skladby; tam si ji pustíš, doladíš dál a vyexportuješ (WAV je Premium).

Kredity a náklady

Obsah i překlad tvoří vaše AI ve vašem účtu (Claude, ChatGPT…) — kredity PMG Clubu se při práci přes MCP nespotřebovávají. Tlačítko Přeložit přímo v editoru používá naši AI a stojí kredity jako obvykle; překlad přes vlastní AI (MCP) je zdarma. Generování hlasu (voice over) v editoru je kreditované vždy.

Bezpečnost tokenů

Token má platnost, dokud ho nezrušíte (tlačítko koše v dialogu MCP)
V databázi je uložen jen otisk — po zavření dialogu ho už nikdo nezobrazí
U každého tokenu vidíte, kdy byl naposledy použit
Token nikomu neposílejte — kdo ho má, může vaším jménem vytvářet prezentace

Alternativa bez MCP

Pokud vaše AI MCP nepodporuje, funguje dál Import z AI se staženým návodem — stejný formát, jen soubor přenesete ručně. Viz nápověda „Import z AI (Story JSON)".