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

Refsite je AI ready. Přes MCP server můžete svého AI asistenta napojit přímo na databázi ověřených dodavatelů úsporných technologií. Jako partner do ní přes AI můžete rovnou zapisovat reference svých realizací. Bez exportů, bez kopírování, běžnou češtinou.

Videonávody

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

Přehrát na YouTube

Refsite Partner MCP – reference na profil přes AI

Přehrát na YouTube

📊 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

---

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 ověřené firmy na tepelná čerpadla 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:

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 sloupci klikněte na Connectors. Pokud se zobrazí hláška, že se konektory přesunuly do Customize, klikněte na odkaz v ní.
3. Klikněte na Add custom connector (případně Add → Custom connector).
4. Do pole Name napište Refsite Public.
5. Do pole Remote MCP server URL vložte https://mcp.refsite.info/public.
6. Klikněte na Add. Hotovo, nic dalšího se nevyplňuje.

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 → Connectors → Add custom connector.
3. Do pole Name napište Refsite Partner.
4. Do pole Remote MCP server URL vložte https://mcp.refsite.info/partner.
5. Rozklikněte Advanced settings (Pokročilá nastavení).
6. Do pole OAuth Client ID vložte své Client ID (x-client-id, 32 znaků).
7. Do pole OAuth Client Secret vložte svůj Client Secret (x-client-secret, 64 znaků).
8. Klikněte na Add a následně u konektoru na Connect. Pokud se otevře okno s potvrzením přístupu, potvrďte ho.

💡 Firemní účet Claude (Team / Enterprise): vlastní konektory přidává vlastník organizace v Organization settings → Connectors. Konektor s jednou adresou může v organizaci existovat jen jednou. Pokud už ho někdo přidal, nepřidávejte druhý a jen se k němu připojte (Connect) se svými klíči.

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 a přílohy k referencím). U Refsite Public tento krok není potřeba.

1. Otevřete Settings → Capabilities.
2. V sekci Code execution and file creation zapněte Run code in the cloud a Allow network egress.
3. U Domain allowlist můžete nechat Package managers only.
4. Do pole Additional allowed domains napište api.refsite.info a klikněte na Add.
5. Doména se objeví v seznamu pod polem. 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).
• Refsite Partner: placený plán ChatGPT.
• V obou případech zapnutý Režim vývojáře. Bez něj vlastní MCP servery přidat nejdou.

1. V ChatGPT otevřete Nastavení → Zabezpečení a přihlášení a úplně dole zapněte Režim vývojáře.
2. V levém menu klikněte na Pluginy a vpravo nahoře na + (Nový plugin).
3. Vyplňte název (Refsite Public nebo Refsite Partner) a do URL serveru vložte příslušnou adresu.
4. Public: u Ověření zvolte Bez ověření.
   Partner: nechte OAuth, rozbalte Pokročilá nastavení OAuth a vyplňte Klientské ID OAuth (Client ID) a Tajný klíč klienta OAuth (Client Secret).
5. Zaškrtněte „Rozumím a chci pokračovat“, klikněte na Vytvořit a poté na Připojit.

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.

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 ověřené firmy na tepelná čerpadla 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.“

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.“

✅ 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.

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 → Connectors v Claude, Pluginy v ChatGPT).
• AI se může splést. Údaje, které jdou ven (nabídka klientovi, reference), si vždy zkontrolujte.

10. Když to nefunguje

---

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.