MCP klienti: propojení Refsite s Claude, ChatGPT a dalšími AI asistenty

Refsite Public MCP – zdarma, bez API klíčů

Refsite Partner MCP – reference na profil přes AI

Refsite je AI ready. Přes MCP server můžete svého AI asistenta napojit přímo na databázi dodavatelů úsporných technologií s ověřenými recenzemi. Refsite Public MCP slouží každému, kdo hledá dodavatele – zákazníkům, poradcům, projektantům i novinářům. Refsite Partner MCP je pro firmy s profilem na Refsite: přes AI do něj můžete rovnou zapisovat reference svých realizací. Bez exportů, bez kopírování, běžnou češtinou.

📊 Prezentace k webináři: Stáhnout prezentaci (Google Drive)

Obsah

1. Co je MCP a k čemu je dobré
2. Public vs. Partner – který konektor potřebujete
3. Kde najdete API klíče
4. Napojení na Claude
5. Napojení na ChatGPT
6. Claude Code, Cursor a další klienti
7. Zapnutí konektoru v chatu
8. Ukázkové dotazy
9. Bezpečnost
10. Když to nefunguje
11. FAQ

---

1. Co je MCP a k čemu je dobré

MCP (Model Context Protocol) je otevřený standard, přes který si AI asistenti (Claude, ChatGPT, Gemini, Copilot…) sahají pro data do jiných aplikací. Jakmile AI propojíte s Refsite, nemusí si nic „vymýšlet“. Pracuje s aktuálními daty portálu: firmami, kategoriemi, recenzemi a referencemi.

Místo procházení webu napíšete například: „Najdi mi Spolehlivé dodavatele tepelných čerpadel v Libereckém kraji a seřaď je podle hodnocení.“ AI si data stáhne z Refsite, porovná je a odpoví i s odkazy na profily firem.

2. Public vs. Partner – který konektor potřebujete

Refsite nabízí dva MCP servery:

Aktuální tarify a ceník najdete na pricing.refsite.info.

Přehled nástrojů

Refsite Public MCP – 15 nástrojů (jen čtení)

Refsite Partner MCP – 19 nástrojů (15 z Public + 4 navíc: 2 pro zápis, 2 pro polohu)

ℹ️ Reference a edukativní příspěvky může firma zveřejňovat jen s příslušným oprávněním. Partner MCP nahrává pouze fotky – PDF, SVG ani zvuk nepodporuje.

3. Kde najdete API klíče (jen Partner)

Klíče pro Partner MCP má každý uživatel ve své administraci na refsite.info/my. Najdete tam dva údaje:

⚠️ Client Secret je jako heslo. Neposílejte ho e-mailem ani do chatu a nevkládejte ho do sdílených dokumentů. Uložte si ho do správce hesel a do AI nástroje ho vkládejte jen do pole, které je k tomu určené.

4. Napojení na Claude

Co potřebujete:

• Refsite Public: stačí jakýkoli účet Claude, i bezplatný (Free).
• Refsite Partner: placený účet Claude (Pro, Max, Team nebo Enterprise).

Postup funguje na claude.ai i v desktopové aplikaci. Konektor se pak automaticky objeví i v mobilní aplikaci.

A) Refsite Public MCP – bez klíčů

1. Vlevo dole klikněte na své jméno a zvolte „Settings“ (Nastavení).
2. V levém menu v části „Customize“ klikněte na „Connectors“ a vpravo nahoře na „+ Add“ → „Add custom connector“.
3. Do pole „Name“ napište Refsite Public.
4. Do pole „MCP server URL“ vložte https://mcp.refsite.info/public a klikněte na „Continue“.
5. U „Authentication“ nechte „No sign-in“ (Claude ho sám označí jako Detected), nic dalšího nevyplňujte a klikněte na „Add“.
6. Otevře se stránka konektoru s hláškou „You're not connected… yet“. Klikněte na „Connect“. Hotovo.

B) Refsite Partner MCP – s klíči

1. Přihlaste se na refsite.info/my a zkopírujte si Client ID a Client Secret.

2. V Claude otevřete „Settings“ a v levém menu v části „Customize“ klikněte na „Connectors“. Vpravo nahoře klikněte na „+ Add“ → „Add custom connector“.

3. Krok 1: do pole „Name“ napište Refsite Partner, do pole „MCP server URL“ vložte https://mcp.refsite.info/partner a klikněte na „Continue“.

4. Krok 2: teprve teď se zobrazí „Authentication“, „Request headers“ a „Advanced“.

5. U „Authentication“ zvolte „No sign-in“ (Claude ho obvykle sám označí jako Detected).

6. V sekci „Request headers“ klikněte na „Add header“ a přidejte dvě hlavičky:

   • název x-client-id → hodnota: vaše Client ID (32 znaků),
   • název x-client-secret → hodnota: váš Client Secret (64 znaků).

   U obou nechte zaškrtnuté „Required“. Hodnoty se uloží zabezpečeně a už se znovu nezobrazí.

7. Sekci „Advanced“ neměňte a klikněte na „Add“.

8. Otevře se stránka konektoru s hláškou „You're not connected to Refsite Partner MCP yet“. Klikněte na „Connect“.

9. Po připojení uvidíte „Tool permissions“ s 19 nástroji: „Read-only tools“ (17 – např. Get company profile, Search companies, Search reviews, Search places) a „Write/delete tools“ (2 – Publish company post, Request image upload slot). Výchozí „Needs approval“ znamená, že Claude se před každým použitím nástroje zeptá – pro začátek to doporučujeme nechat.

ℹ️ Claude u volby „No sign-in“ upozorní, že konektor může použít kdokoli s adresou serveru. U Refsite Partner se nemusíte obávat: bez platných klíčů v hlavičkách server nic nevrátí ani nezapíše.

💡 Firemní účet Claude (Team / Enterprise): vlastní konektory přidává vlastník organizace v „Organization settings“ → „Connectors“. Klíče v hlavičkách zadává ten, kdo konektor přidává, a platí pro celou organizaci – všichni členové pak zapisují na profil firmy, ke které klíče patří. Konektor s jednou adresou může v organizaci existovat jen jednou.

C) Povolení domény api.refsite.info (jen Refsite Partner)

Pro Refsite Partner musíte Claudu povolit přístup na doménu api.refsite.info, aby mohl s API Refsite opravdu pracovat (např. nahrávat fotky k referencím). U Refsite Public tento krok není potřeba. Týká se jen Claude – v ChatGPT doménu api.refsite.info nastavovat nemusíte.

1. Otevřete „Settings“ → „Capabilities“.
2. V sekci „Create and edit files“ zapněte „Use the internet while making files“.
3. U „Allowed websites“ klikněte na „Manage“ → „Add a website“.
4. Napište api.refsite.info a potvrďte.
5. Doména se objeví v seznamu povolených webů. Hotovo.

💡 Firemní účet Claude (Team / Enterprise): síťový přístup a povolené domény nastavuje vlastník organizace v „Admin settings“ → „Capabilities“. Pokud pole nevidíte nebo je zašedlé, požádejte o přidání api.refsite.info správce účtu.

5. Napojení na ChatGPT

Co potřebujete:

• Refsite Public: stačí jakýkoli účet ChatGPT, i bezplatný (Free). Režim vývojáře není potřeba.
• Refsite Partner: placený plán ChatGPT a desktopová aplikace ChatGPT. Webová verze ChatGPT neumí nastavit vlastní hlavičky (x-client-id, x-client-secret), takže Partner v prohlížeči připojit nejde. Aplikaci stáhněte z chatgpt.com/download a nainstalujte.

A) Refsite Public MCP – bez klíčů

1. V ChatGPT otevřete „Nastavení“ a v levém menu v části „Integrace“ klikněte na „Pluginy“.
2. Vpravo nahoře klikněte na „Přidat“ → „Přidat server MCP“ (otevře se Připojení k vlastnímu MCP).
3. Do pole „Název“ napište Refsite Public.
4. U „Typ“ nechte „Streamovatelné HTTP“.
5. Do pole „URL“ vložte https://mcp.refsite.info/public.
6. Pole „Proměnná prostředí tokenu nositele“, „Záhlaví“ a „Záhlaví z proměnných prostředí“ nechte prázdná a klikněte na „Uložit“. Hotovo.

ℹ️ Starší návody uvádějí zapnutí „Režimu vývojáře“ v Zabezpečení. V aktuální verzi ChatGPT to pro Refsite Public potřeba není.

B) Refsite Partner MCP – jen desktopová aplikace

1. Stáhněte si ChatGPT z chatgpt.com/download, nainstalujte ho a přihlaste se.
2. Na refsite.info/my si zkopírujte Client ID a Client Secret.
3. V aplikaci otevřete „Nastavení“ → „Pluginy“ (anglicky Plugins) a vpravo nahoře klikněte na „Přidat“ → „Přidat server MCP“ (Add → Add MCP server).
4. Do pole „Název“ (Name) napište Refsite Partner.
5. U „Typ“ (Type) nechte „Streamovatelné HTTP“ (Streamable HTTP).
6. Do pole „URL“ vložte https://mcp.refsite.info/partner.
7. Pole „Proměnná prostředí tokenu nositele“ (Bearer token env var) nechte prázdné.
8. V sekci „Záhlaví“ (Headers) klikněte na „Přidat záhlaví“ a přidejte dvě hlavičky (Klíč → Hodnota):
   • x-client-id → vaše Client ID (32 znaků),
   • x-client-secret → váš Client Secret (64 znaků).
9. Sekci „Záhlaví z proměnných prostředí“ (Headers from environment variables) nechte prázdnou a klikněte na „Uložit“ (Save).

💡 Konektor přidaný v desktopové aplikaci používáte v chatech v této aplikaci. Na webu chatgpt.com se Refsite Partner nezobrazí.

6. Claude Code, Cursor a další klienti

Klienti, kteří umí posílat vlastní HTTP hlavičky, předávají klíče přímo jako x-client-id a x-client-secret – stejně jako Claude na webu a v desktopové aplikaci nebo desktopová aplikace ChatGPT.

Claude Code (terminál):

claude mcp add --transport http refsite-public https://mcp.refsite.info/public

claude mcp add --transport http refsite-partner https://mcp.refsite.info/partner \
  --header "x-client-id: VAŠE_CLIENT_ID" \
  --header "x-client-secret: VÁŠ_CLIENT_SECRET"

Cursor, VS Code a další (konfigurační JSON):

{
  "mcpServers": {
    "refsite-public": {
      "url": "https://mcp.refsite.info/public"
    },
    "refsite-partner": {
      "url": "https://mcp.refsite.info/partner",
      "headers": {
        "x-client-id": "VAŠE_CLIENT_ID",
        "x-client-secret": "VÁŠ_CLIENT_SECRET"
      }
    }
  }
}

7. Zapnutí konektoru v chatu

Propojení neznamená, že AI vidí Refsite v každé konverzaci. Konektor si zapínáte pro konkrétní chat:

• Claude: v okně chatu klikněte na „+“ vlevo dole pod textovým polem → „Connectors“ a přepínačem zapněte Refsite Public nebo Refsite Partner.
• ChatGPT: klikněte na „+“ v textovém poli a vyberte svůj plugin Refsite.

Tip: konektor se nejspolehlivěji načte v novém chatu, protože seznam nástrojů se načítá na začátku konverzace.

8. Ukázkové dotazy

Refsite Public

• „Najdi Spolehlivé dodavatele tepelných čerpadel v okolí Liberce a seřaď je podle hodnocení.“
• „Porovnej tři nejlépe hodnocené dodavatele fotovoltaiky ve Středočeském kraji – reference, recenze, certifikát Spolehlivý dodavatel.“
• „Jaké kategorie úsporných technologií Refsite pokrývá?“
• „Ukaž mi detail firmy XY a shrň, co o ní píšou zákazníci.“
• „Kdo je v TOP 5 instalatérů tepelných čerpadel v Libereckém kraji za rok 2025?“
• „Najdi energetického specialistu nebo poradce EKIS, který zpracuje PENB, a ukaž jeho kvalifikace.“
• „Ukaž ověřené recenze s fotkou na montáž fotovoltaiky od firmy XY.“
• „Jaká tepelná čerpadla výrobce XY jsou na Refsite a jak je hodnotí zákazníci?“
• „Které firmy jsou členy asociace XY a nabízejí energetický audit?“

Refsite Partner

• „Přidej na náš profil referenci: FVE 9,8 kWp s baterií 10 kWh, rodinný dům, Kostelec nad Labem, realizace 09/2026. Fotky přikládám. Uveď maximum technických parametrů, označ výrobce technologií a přidej lokalitu na mapu.“
• „Přidej na náš profil všechny reference z naší webové stránky a naplánuj příspěvky tak, aby se publikovala každý týden jedna reference.“
• „Z této tabulky zakázek mi připrav reference a před uložením mi je ukaž ke kontrole.“
• „Zkontroluj, jak vypadá náš profil na Refsite, a navrhni, co doplnit.“
• „Připrav příspěvek typu akce – den otevřených dveří 14. 11. v našem showroomu – a ulož ho jako koncept.“
• „Zveřejni nabídku podzimní servisní prohlídky tepelných čerpadel a naplánuj ji na pondělí 8:00.“
• „V referenci zmiň výrobce tepelného čerpadla jako @výrobce, ať se na profil odkazuje.“

✅ Doporučení pro Partner MCP: požádejte AI, aby vám každou referenci před uložením ukázala ke kontrole. Reference se zveřejňují na vašem veřejném profilu.

Automatické příspěvky: zadání pro agenta nebo naplánovanou úlohu

Partner MCP umí příspěvek typu Reference nebo Edukativní příspěvek zveřejnit hned, uložit jako koncept ke kontrole, nebo naplánovat na konkrétní datum a čas. Díky tomu můžete pravidelné příspěvky nastavit jednou a dál už se zveřejňují samy.

Než zadání použijete:

• Vyplňte všechno v [hranatých závorkách] – adresu webu, slug firmy (část adresy vašeho profilu na Refsite), barvy a logo. U automatického běhu nikdo neodpovídá na doplňující otázky, takže zadání musí být úplné.
• Aby AI mohla stáhnout fotky z vašeho webu nebo úložiště, přidejte v Claude do „Allowed websites“ (Settings → Capabilities) kromě api.refsite.info i doménu vašeho webu (např. dodavatel-A.cz).
• Poprvé zvolte zveřejnění jako koncept (draft). Až budete s výsledkem spokojeni, přepněte na naplánované zveřejnění (schedule).

Příklad 1: Reference z vašeho webu – každý týden jedna

Jsi správce firemního profilu [NÁZEV FIRMY] na portálu Refsite. Pracuj s konektorem Refsite Partner, company slug: [SLUG FIRMY].

CÍL
Zveřejni na našem profilu všechny reference realizací z našich zdrojů – každý týden jednu.

ZDROJE
- Web: [https://www.dodavatel-A.cz/reference]
- Další úložiště, pokud k nim máš přístup: [Google Disk / NAS / jiná složka]
- Náš profil na Refsite (kvůli duplicitám): [ODKAZ NA PROFIL]

POSTUP
1. Projdi zdroje a sestav seznam všech realizací. Vynech ty, které už na našem profilu jsou.
2. Seřaď je od nejnovější po nejstarší. První naplánuj na [DEN, např. nejbližší úterý] v [ČAS, např. 9:00], každou další o týden později.
3. Každou referenci ulož jako příspěvek typu REFERENCE (publish_mode = [schedule / draft]):
   - Text: nadpis (technologie + výkon + typ objektu + obec), stručný popis zakázky a co nejvíce technických parametrů – výkony, kapacity, počty a typy komponent (panely, střídač, baterie, tepelné čerpadlo, zásobník, rekuperace…), rozsah prací a termín realizace.
   - Značky a modely: uveď ty, které jsou ve zdroji. Pokud chybí, rozpoznej je z fotek (logo, typový štítek, typická barva a tvar). Značku uveď jen tehdy, když si jsi jistý – jinak ji vynech.
   - Kategorie: vyber odpovídající kategorii přes list_categories podle textu a fotek.
   - Lokalita: najdi místo realizace přes search_places a resolve_place_location co nejpřesněji, alespoň obec. Přesnou adresu soukromého domu uveď jen tehdy, když ji uvádí i zdroj.
   - Fotky: nahraj všechny dostupné fotky realizace (JPG, PNG, WebP nebo GIF, max. 20 MB na soubor), od celkového pohledu po detaily.
   - Poslední obrázek: vytvoř kreativu 1080 × 1080 px v našich barvách [BARVY] s naším logem [LOGO] a textem: „Líbí se vám naše realizace? Podívejte se na další reference, ověřené recenze a na náš web [WWW].“
   - Hashtagy: na konec textu přidej co nejvíce relevantních hashtagů, alespoň 10 – technologie, značky, obec, kraj, typ objektu, dotace.
   - Výzva: úplně na konec přidej výzvu k využití našich služeb s odkazem na [WWW].
4. Nic si nevymýšlej. Údaje, které ve zdrojích nejsou a nejdou spolehlivě poznat z fotek, vynech.

VÝSTUP
Vypiš tabulku: datum zveřejnění, název reference, kategorie, lokalita, počet fotek. Pod ni seznam přeskočených realizací a důvod.

Příklad 2: Edukativní příspěvek – každý týden jeden

Jsi odborný redaktor firmy [NÁZEV FIRMY] (obor: [např. fotovoltaika a tepelná čerpadla]) na portálu Refsite. Pracuj s konektorem Refsite Partner, company slug: [SLUG FIRMY].

CÍL
Připrav a zveřejni jeden edukativní příspěvek (typ EDU_POST) z našeho oboru a ze služeb, které nabízíme: [SEZNAM SLUŽEB].

TÉMA
- Preferuj novinky: technické novinky, změny legislativy a norem, státní podpory a dotace (např. Nová zelená úsporám), ceny energií.
- Téma se nesmí opakovat – zkontroluj příspěvky, které už jsou na našem profilu: [ODKAZ NA PROFIL].
- Fakta ověř v oficiálních zdrojích (SFŽP, MPO, ERÚ, výrobci) a na konec příspěvku je uveď.

PRAVIDLA
- Dodržuj pravidla Refsite pro edukativní příspěvky: https://sluzby.refsite.info/articles/article/edukativni-prispevek – příspěvek má vzdělávat, nesmí to být reklama ani nabídka.
- Piš česky, srozumitelně pro majitele domu, věcně a bez superlativů. Rozsah [300–600] slov, krátké odstavce a mezititulky.
- Vyber odpovídající kategorii přes list_categories.

KREATIVA
Vytvoř jeden úvodní obrázek 1080 × 1080 px podle našeho grafického a brand manuálu [ODKAZ NA MANUÁL, nebo: barvy, písmo, logo] s krátkým titulkem tématu.

ZVEŘEJNĚNÍ
publish_mode = [now – hned / draft – koncept ke kontrole / schedule – na DEN a ČAS]

VÝSTUP
Vypiš téma, kategorii, použité zdroje a stav příspěvku (zveřejněno / koncept / naplánováno na…).

Jak zařídit, aby se to dělo samo:

• Reference z webu: Příklad 1 stačí spustit jednou. AI naplánuje všechny reference dopředu po týdnech a Refsite je zveřejní sám v nastavený den. Až na webu přibudou nové realizace, spusťte zadání znovu – už zveřejněné reference přeskočí.
• Edukativní příspěvky: Příklad 2 uložte jako naplánovanou úlohu s opakováním každý týden (v Claude jako scheduled task se zapnutým konektorem Refsite Partner). Každé spuštění připraví jeden nový příspěvek.

💡 Tip: i u automatických příspěvků se na profil občas podívejte. Reference i edukativní příspěvky se zveřejňují pod jménem vaší firmy a odpovídáte za jejich obsah.

9. Bezpečnost

• Public MCP jen čte veřejná data portálu a nic nemění.
• Partner MCP zapisuje pouze na váš vlastní profil firmy, ke kterému patří klíče.
• Client Secret chraňte jako heslo. Při podezření na únik si v administraci refsite.info/my vygenerujte nové klíče (případně kontaktujte podporu) a vložte je znovu do AI nástroje.
• Když konektor přestanete používat, odeberte ho i v AI nástroji („Settings“ → „Customize“ → „Connectors“ v Claude, „Nastavení“ → „Pluginy“ → záložka „MCP“ v ChatGPT).
• AI se může splést. Údaje, které jdou ven (nabídka klientovi, reference), si vždy zkontrolujte.

10. Když to nefunguje

11. FAQ

Potřebuji pro Refsite Public placený účet?
Ne. Refsite Public MCP je zdarma, bez API klíčů a funguje i s bezplatným účtem Claude nebo ChatGPT.

Který tarif Refsite potřebuji pro Partner MCP?
Partner MCP je dostupný pro firmy s tarifem Basic, Standard nebo Premium. Přehled tarifů najdete na pricing.refsite.info.

Proč Claude u Partner MCP nenabízí pole OAuth Client ID a Client Secret?
Refsite Partner se v Claude nepřipojuje přes OAuth. Zvolte „No sign-in“ a klíče vložte jako dvě hlavičky v „Request headers“: x-client-id a x-client-secret.

Funguje Refsite Partner MCP v ChatGPT na webu?
Ne. Webová verze ChatGPT neumí nastavit vlastní hlavičky s klíči. Refsite Partner připojte v desktopové aplikaci ChatGPT (chatgpt.com/download) přes „Nastavení“ → „Pluginy“ → „Přidat“ → „Přidat server MCP“.

Jaké příspěvky umí Partner MCP zveřejnit?
Pět typů: novinku, akci, nabídku, referenci a edukativní příspěvek. Každý může jít ven hned, uložit se jako koncept ke kontrole, nebo se naplánovat na konkrétní datum a čas. Reference a edukativní příspěvky vyžadují oprávnění firmy.

Kolik nástrojů konektory mají?
Public MCP má 15 nástrojů jen pro čtení. Partner MCP má 19 – všech 15 z Public, 2 pro vyhledání místa a jeho přesné polohy a 2 pro zápis (zveřejnění příspěvku a nahrání fotky).

Přidá AI přes Partner MCP i recenzi?
Ne. Přes Partner MCP přidáváte reference – příspěvky firmy o vlastních realizacích, bez hodnocení. Recenze píší zákazníci a ověřuje je Refsite.

Uloží AI referenci hned, nebo ji můžu nejdřív zkontrolovat?
Záleží na zadání. Napište do něj „před uložením mi ji ukaž ke kontrole“ – AI vám referenci nejdřív ukáže a uloží ji až po vašem potvrzení.

---

Chcete vidět, jak to funguje v praxi? Pusťte si videonávod pro Refsite Public MCP nebo Refsite Partner MCP a projděte si prezentaci.

Související návody

• Rozdíl reference vs recenze – co přes Partner MCP přidáváte a co píší zákazníci
• Jak napsat příspěvěk? – jak má vypadat dobrá reference, kterou může připravit i AI
• Naplánování příspěvku – jak funguje postupné zveřejňování referencí
• Co je a není edukativní příspěvek – pravidla, která musí dodržet i příspěvky připravené přes AI
• Propojení s účtem firmy – bez propojení s firmou nemůžete zapisovat na její profil
• Tarify portálu Refsite – Partner MCP je součástí tarifů Basic, Standard a Premium

Všechny návody najdete v sekci Návody.