Telly Marketing

← Telly Marketing

Propojit Telly kontext s tvou AI

Připoj interní kontext Telly přímo do své AI: marketingovou knihovnu, sportovní kalendář i kalendář dovolených. Propojení funguje přes takzvaný MCP server. Představ si ho jako zásuvku, do které se tvoje AI zapojí a sama si z ní bere data Telly, kdykoliv je při psaní nebo tvoření potřebuje. Nastavíš jednou, funguje pořád. Umí to Claude Desktop, Claude Code, Cursor, Codex i Antigravity.

1. Získej token

Token je tvůj osobní klíč (dlouhý kód), kterým se tvoje AI prokazuje. Vygeneruje ti ho admin a pošle, stačí napsat Honzovi. Token si hned ulož, z bezpečnostních důvodů ho uvidíš jen jednou.

2. Přidej server do své AI

Najdi níže nástroj, který používáš, a vlož nastavení podle návodu. Všude pak nahraď <TVŮJ_TOKEN> tokenem z kroku 1.

Claude Code

Spusť v terminálu tento příkaz:

claude mcp add --transport http telly https://marketing.telly.cz/mcp --header "Authorization: Bearer <TVŮJ_TOKEN>"

Cursor / Claude Desktop

Vlož do konfiguračního souboru MCP. V Cursoru je to ~/.cursor/mcp.json, v Claude Desktop ho otevřeš přes Nastavení (Settings) → Developer → Edit Config: 

{
  "mcpServers": {
    "telly": {
      "url": "https://marketing.telly.cz/mcp",
      "headers": { "Authorization": "Bearer <TVŮJ_TOKEN>" }
    }
  }
}

Codex (OpenAI)

Do ~/.codex/config.toml (sdílí ho CLI i IDE rozšíření):

[mcp_servers.telly]
url = "https://marketing.telly.cz/mcp"
bearer_token_env_var = "TELLY_MCP_TOKEN"

Codex čte token z proměnné prostředí. Přidej si tento řádek do souboru ~/.zshrc a otevři nový terminál:

export TELLY_MCP_TOKEN="<TVŮJ_TOKEN>"

Antigravity (Google)

Do ~/.gemini/config/mcp_config.json (sdílí ho IDE i CLI). Pozor: klíč je serverUrl, ne url:

{
  "mcpServers": {
    "telly": {
      "serverUrl": "https://marketing.telly.cz/mcp",
      "headers": { "Authorization": "Bearer <TVŮJ_TOKEN>" }
    }
  }
}

Tyhle nástroje se rychle vyvíjejí a přesná podoba nastavení se může změnit. Pokud návod nefunguje, zeptej se přímo své AI: „Jak do tebe přidám vzdálený MCP server s adresou a tokenem?" Aktuální postup ti řekne sama. Adresa serveru je https://marketing.telly.cz/mcp.

3. Vyzkoušej

Ve své AI napiš třeba:

Co MCP přes AI umí

Nástroje po modulech, ze stejného zdroje jako průvodce hubem. Modul za rolí se ukáže jen jejímu držiteli.

🔍 Výzkumy

  • dej_dokument: souhrn konkrétního výzkumu z knihovny (slug vyzkum-…)
  • dej_zakaznickou_bazi: analýzy zákaznické báze z CRM: smlouvy po službách, ARPU a zdražení, balíčky, profil zákazníka, okresy a obce, slevy, odchody podle ankety call centra; jen se zaškrtnutým přístupem (admin → Data)

📺 Sledovanost TV trhu

  • dej_sledovanost: trh: podíly stanic, Top 20 pořadů po týdnech a měsících, vývoj stanic z dat ATO, jen pro interní práci
  • dej_sledovanost_telly: zákazníci Telly: podíly kanálů, pořady, minuty na diváka, kanály bez vlivu balíčků, trh vs. Telly, vývoj kanálů

📈 Vyhodnocení kampaní

  • dej_kampane: přehled kampaní se souhrnnými metrikami; s parametrem id detail kampaně po týdnech od startu, události a rozpad nabídky; interní prodejní čísla

📊 Zdroje dat

  • dej_seo_vykon: Search Console: top dotazy, stránky nebo sekce webu (kliky, imprese, CTR, pozice), až 16 měsíců; rez=znacky = zájem o vlastní značku a imprese na dotazy s cizími značkami operátorů po měsících
  • dej_seo_trend: které dotazy rostou, padají, jsou nové nebo zmizely mezi dvěma obdobími
  • dej_navstevnost: GA4: přehled se srovnáním, kanály, hostitelé, top stránky, řada po dnech, týdnech nebo měsících; rez=udalosti = klíčové události (trialy, leady, nákupy), jedna událost po kanálech nebo v čase
  • dej_google_ads: kampaně Google Ads: náklady, kliky, CPC, klíčové události, CPA; období od–do, srovnání rok zpět, filtr kampaní, řada po dnech, týdnech nebo měsících (až 13 měsíců)
  • dej_sklik: kampaně Skliku: náklady, kliky, konverze, CPA; období od–do, srovnání rok zpět, filtr kampaní, řada po dnech, týdnech nebo měsících (až 13 měsíců); rez=inzeraty texty inzerátů s výkonem
  • dej_meta_ads: kampaně na Facebooku a Instagramu: náklady, kliky na odkaz, konverze, CPA; období od–do, srovnání rok zpět, filtr kampaní, řada po dnech, týdnech nebo měsících (až 13 měsíců); rez=reklamy texty reklam s výkonem (+ Reklama ID, náklady, CPM a CPA po reklamě); rez=nahledy obrázek a post jen k vybraným ID (nejdřív texty, pak grafika k vybraným); rez=komentare a rez=diskuze = komentáře pod reklamami (odpovědi stránky; sentiment, témata, stížnosti lidí)
  • dej_seo_pozice: Marketing Miner: pozice sledovaných slov, viditelnost, konkurence v SERPu; rez=vyvoj = viditelnost a top 3 / top 10 po měsících, rez=stitky = skupiny slov
  • dej_google_ads_api: Google Ads přímo z API: kampaně se stavem a rozpočtem, sestavy, klíčová slova se skóre kvality, vyhledávací dotazy, konverze podle Ads; období od–do, srovnání rok zpět, filtr kampaní, řada po dnech, týdnech nebo měsících (až 13 měsíců); rez=podklady texty nadpisů a popisků s výkonem, rez=reklamy celé reklamy
  • dej_meta_posty: organické posty na Facebooku a Instagramu: dosah, zapojení, kliky a noví sledující po stránkách, top posty, rozpad po formátech; rez=posty format=csv = všechny posty i propadáky s textem a obrázkem (co funguje a co ne); rez=komentare = odpovědi stránky v komentářích, které diskuzi udržely nebo zabily; rez=diskuze = co lidé pod posty píšou (sentiment, témata, stížnosti, otázky bez odpovědi; AI hodnocení se pamatuje, období až 13 měsíců, porovnání = dvě volání); rez=sledujici = vývoj počtu sledujících po měsících
  • dej_utraty: útraty napříč Google Ads (API), Sklikem a Metou jedním voláním: po systémech + součet, srovnání, filtr kampaní, řada po dnech, týdnech nebo měsících, top kampaně napříč systémy
  • dej_recenze_aplikaci: recenze aplikace Telly (Google Play, App Store, Xbox): počet, průměr hvězd a jedničky po měsících a obchodech; rez=recenze texty s filtrem hvězd a hledáním, CSV
  • dej_youtube: YouTube kanál Telly (veřejná data): odběratelé, videa v období se zhlédnutími, lajky a komentáři, po měsících zveřejnění, Shorts zvlášť; rez=videa seznam a CSV

⚖️ Porovnání s konkurencí

  • dej_konkurenci: ceníky a balíčky TV operátorů včetně hodnoty a Kč za 100 bodů; rez=doplnky = VOD služby a doplňky (v ceně / příplatek / nemá)
  • dej_zmeny_konkurence: změny cen, akcí, kanálů a kampaní za poslední týdny; rez=kalendar = kalendář akcí za období od–do (kdo, kdy, co, věta z webu, zdroj)
  • dej_kanaly: skóre atraktivity kanálů a jejich rozložení v balíčcích

🏆 Sportovní kalendář

  • dej_sportovni_kalendar: nadcházející sportovní přenosy a tipy měsíce
  • dej_historii_kalendare: co se hrálo ve zvoleném minulém období (od, do)

📡 Monitoring médií

  • dej_zminky: zmínky z monitoringu s filtry (entita, sentiment, období, jen krizové)
  • hledej_zminky: fulltext ve zmínkách (titulek, AI souhrn, témata, autor)
  • dej_souhrn_monitoringu: souhrnné KPI monitoringu za období

🧪 Playground

  • dej_playground: katalog vibecodovaných appek týmu s odkazy

🏖️ Kalendář dovolených

  • dej_dovolene: kdo je mimo, firemní akce a čerpání dovolené a HO po lidech a týmech

🎯 Čtvrtletní cíle

  • dej_ctvrtletni_cile: skóre plnění OKR po kvartálech, s parametrem i konkrétní cíle lidí a týmu

🎓 Telly Academy

  • seznam_academy: seznam stránek Academy
  • dej_academy_stranku: plný obsah konkrétní stránky Academy
  • hledej_academy: fulltext napříč Telly Academy

📚 Marketingová knihovna

  • dej_brand_brain: vždy načítaný destilát značky (positioning, pilíře, segmenty, hlas, pravidla)
  • seznam_dokumentu: seznam dokumentů knihovny
  • dej_dokument: plný dokument podle slugu (strategie, tone of voice, brand manuál, zadání, skilly, design systém, výzkumy, návody)
  • hledej: fulltext napříč knihovnou
  • seznam_design_prvku: vektorové prvky design systému po skupinách (loga, tlačítka, tvary, stickery, ikony) s rozměrem a barvami
  • dej_design_prvek: SVG vybraných prvků podle cesty, k vložení do návrhu beze změny

🧭 O Marketing Hubu

  • dej_pruvodce_hubem: průvodce moduly hubu a jejich nástroji, ať tvoje AI ví, na co se ptát
  • dej_stav_zdroju: které externí zdroje hubu právě fungují a které ne (od kdy, kdo to řeší) — když nástroj vrátí chybu nebo stará data

🆕 Co je nového

  • dej_novinky: co je nového v hubu (changelog větších změn)

Analytické nástroje (výkon, trend, návštěvnost, pozice) uvidí jen ten, komu admin hubu udělil přístup k datům. Co je k dispozici a jestli to máš, ukazuje stránka Zdroje dat.

MCP obsahuje jen interní kontext Telly. Citlivá data (rozpočty, prodejní čísla) v něm nejsou. Token je vázaný na tebe a jde kdykoliv zneplatnit.