🤖 MCP a AI asistent#

Bidding Fox podporuje Model Context Protocol (MCP). Díky němu se k datům vašeho projektu dostane AI asistent, například Claude, ChatGPT, Cursor nebo Claude Code, a vy se ho můžete běžnou řečí ptát místo toho, abyste čísla ručně hledali v rozhraní.

Návod k propojení máte přímo v aplikaci: na stránce Nastavení v sekci AI / MCP klikněte na Jak na to?. Otevře se panel s adresou MCP serveru, postupem pro vytvoření přístupového tokenu a ukázkami konfigurace pro jednotlivé AI klienty.

K čemu se MCP hodí#

AI asistent přes MCP pracuje s daty konkrétního projektu, takže se hodí hlavně na rychlé dotazy a kontroly, u kterých byste jinak proklikávali filtry a exporty:

  • „Kolik produktů mi teď spadá do strategie na TOP produkty?"

  • „Vypiš produkty, které mají CPC vyšší než polovinu ceny."

  • „Shrň mi, jak se za poslední měsíc vyvíjelo PNO."

  • „Které nastavení projektu se naposledy měnilo a kým?"

  • „Najdi produkty, u kterých je konkrétní konkurent levnější."

Rozsah toho, co asistent zvládne, se odvíjí od nástrojů, které Bidding Fox přes MCP nabízí, a od oprávnění použitého tokenu.

Adresa serveru a autorizace#

Údaj Hodnota
MCP server https://app.bdfx.cz/mcp
Autorizace Mergado PAT v hlavičce Authorization: Bearer <váš-token>, u webových klientů OAuth
Rozsah práv podle oprávnění tokenu a vašich práv v Bidding Foxu

Jak získat přístupový token (PAT)#

  1. Přihlaste se do svého účtu v Mergadu.

  2. V nastavení profilu otevřete sekci API a přístupy.

  3. V části Osobní přístupové tokeny klikněte na Přidat a vyplňte požadované položky. Doporučujeme nastavit maximální platnost a oprávnění podle toho, co má asistent dělat.

  4. Klikněte na Vytvořit token a vygenerovaný token si zkopírujte.

⚠️ Token se po zavření stránky už znovu nezobrazí. Pokud ho ztratíte, musíte vytvořit nový. Zacházejte s ním jako s heslem: nesdílejte ho v chatu, e-mailu ani ve veřejných repozitářích.

Podrobnosti k tokenům najdete v článku Osobní přístupový token (PAT).

Připojení k AI klientům#

ChatGPT a Claude ve webovém rozhraní#

Použijte možnost vlastní konektor (v ChatGPT plugin), jako adresu zadejte https://app.bdfx.cz/mcp a jako autorizaci zvolte OAUTH. Po připojení vás aplikace přesměruje na formulář, kam vložíte svůj Mergado PAT.

VSCode#

Do konfigurace vložte následující nastavení a mergado_pat_token nahraďte svým tokenem:

{
  "servers": {
    "bidding-fox": {
      "url": "https://app.bdfx.cz/mcp",
      "type": "http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "Authorization": "Bearer mergado_pat_token"
      }
    }
  },
  "inputs": []
}

Claude Code#

Do konzole vložte příkaz a mergado_pat_token nahraďte svým tokenem:

claude mcp add --transport http bidding-fox https://app.bdfx.cz/mcp \
  --header "Authorization: Bearer mergado_pat_token"

S čím vám AI asistent pomůže#

Oblast Co asistent zvládne
Produkty Vyhledávat produkty a číst jejich detail (cena, CPC, pozice, statistiky), pracovat s uloženými filtry a štítky.
Strategie a nastavení Vypsat strategie i nastavení projektu, vysvětlit, podle čeho se biddování řídí, zkontrolovat platnost nastavení a projít jeho historii.
Diagnostika a reporty Číst přehled projektu, reporty a metriky, včetně jejich vývoje v čase.
Konkurence Vypsat konkurenty a porovnat, kde jste dražší nebo levnější.
Exporty a události Vypsat vytvořené exporty a projít události v projektu.

Změny asistent provádí jen tam, kde to dostupné nástroje a oprávnění tokenu umožňují, a vždy na základě vašeho zadání.

💡 Než necháte asistenta cokoli měnit, nechte si nejdřív vypsat, co se chystá udělat. U nastavení strategií se změna projeví při nejbližším biddingu.

FAQ#

  1. Kde najdu adresu serveru a návod? Na stránce Nastavení v sekci AI / MCP pod tlačítkem Jak na to?. Adresa serveru je https://app.bdfx.cz/mcp.

  2. Co k propojení potřebuji? Mergado PAT s odpovídajícími oprávněními a AI klienta, který podporuje MCP přes HTTP.

  3. AI klient hlásí chybu autorizace. Zkontrolujte, jestli je token vložený celý, jestli nevypršel a jestli je v hlavičce ve formátu Authorization: Bearer <token>.

  4. Může AI asistent měnit nastavení biddingu? Ano, pokud to umožňují dostupné nástroje a oprávnění tokenu. Když chcete jen kontrolovat a číst data, vytvořte si token pouze se čtecími oprávněními.

  5. Musím asistentovi říkat, o který projekt jde? Ano. Nástroje Bidding Foxu pracují nad konkrétním projektem, takže mu v zadání vždy uveďte, se kterým projektem má pracovat.