Co je Chaterimo MCP server?

Chaterimo MCP server zpřístupňuje 19 nástrojů prostřednictvím Model Context Protocol a umožňuje Claude AI číst a aktualizovat data vašeho chatbota v reálném čase — včetně konverzací, analytiky, produktů, leadů, ticketů a konfigurace chatbota.

Potřebuji vývojáře k nastavení MCP integrace?

Ne. OAuth flow v Claude Desktop vyžaduje pouze přihlášení do Chaterimo — žádné programování není potřeba. Vložíte URL endpointu do nastavení Claude Desktop, autorizujete se přes OAuth a jste připojeni.

Co může Claude číst z mého účtu Chaterimo přes MCP?

Konverzace, analytiku, produkty, leady, tickety, prodejní pravidla, statistiky dashboardu a kompletní konfiguraci chatbota včetně AI modelu, systémového promptu a vzhledu widgetu.

Může Claude měnit nastavení mého chatbota přes MCP?

Ano, při použití endpointu s plným přístupem. Claude může aktualizovat instrukce, AI model, jazyk, barvy widgetu a zprávy a spustit přetrénování. Použijte endpoint pouze pro čtení (/mcp-readonly/) k zamezení zápisů.

Je MCP připojení bezpečné?

Ano. OAuth připojení používají krátkodobé tokeny. Připojení přes API klíč používá váš klíč cha_xxx — zacházejte s ním jako s heslem a používejte klíče pouze pro čtení při sdíleném přístupu.

Chaterimo MCP Server: Propojte Claude AI s vaším chatbotem (2026)

Autor: David Langr • Aktualizováno 2026-05-04 • 10 min čtení

Použijte Claude Desktop nebo Claude Code ke čtení konverzací, kontrole analytiky, aktualizaci AI instrukcí a správě widgetu chatbota — přímo z Claude.

Cluster Developer API

Viz také: AI zákaznický servis pro Shopify · Nejlepší AI chatbot pro Shopify

Co je MCP a proč je důležitý pro e-commerce

MCP je zkratka pro Model Context Protocol — otevřený standard, který umožňuje Claude AI připojit se k externím nástrojům a číst živá data z vašich systémů v reálném čase. Namísto kopírování přepisu konverzace z Chaterimo a vkládání do Claude pro analýzu se Claude přímo zeptáte: „Jaké jsou nejčastější stížnosti v mém chatbotu tento týden?" Claude zavolá MCP nástroje Chaterimo, načte data a okamžitě odpoví.

Pro e-commerce týmy to mění způsob, jakým pracujete s daty chatbota. Nemusíte se přihlašovat do dashboardu, abyste zkontrolovali analytiku, přečetli ticket nebo aktualizovali AI instrukce. Děláte to v rámci Claude konverzace v přirozeném jazyce.

MCP server Chaterimo zpřístupňuje 19 nástrojů pokrývajících chatboty, konverzace, produkty, tickety, leady a analytiku. Dvanáct je pouze pro čtení; sedm umožňuje zápis. Vy si volíte, jakou úroveň přístupu Claude udělíte podle způsobu připojení.

      Co můžete dělat s Chaterimo + Claude přes MCP
      Požádat Claude o shrnutí nedávných zákaznických stížností z vašeho chatbota
Nechat Claude přepsat váš AI systémový prompt ve stručnějším stylu
Zkontrolovat trendy analytiky za posledních 30 dní bez otevření dashboardu
Prohledat katalog produktů a analyzovat vzory ticketů v jedné konverzaci
Přepnout AI model nebo nastavení jazyka chatbota jedinou instrukcí

    

Dva způsoby připojení: Claude Desktop (OAuth) vs Claude Code CLI

Chaterimo podporuje dva způsoby připojení. Správný závisí na tom, kdo se připojuje a jak pracuje.

OAuth / Claude Desktop — bez tokenu

OAuth endpointy používají standardní MCP autorizační flow. Vložíte URL do Claude Desktop, autorizujete se přihlášením do Chaterimo a Claude automaticky získá krátkodobý přístupový token. Žádný API klíč ke správě, žádné konfigurační soubory k úpravě.

Plný přístup (čtení + zápis): https://www.chaterimo.com/mcp/
Pouze pro čtení (bezpečné pro sdílení): https://www.chaterimo.com/mcp-readonly/

Vhodné pro: majitele firem, marketéry, manažery podpory — kohokoli, kdo používá Claude Desktop a chce dotazovat nebo spravovat chatbot bez psaní kódu.

API klíč / Claude Code CLI — stdio transport

CLI integrace používá FastMCP přes stdio. Zadáte svůj Chaterimo API klíč (cha_xxx), dostupný z dashboardu Developer API, a Claude Code se přímo připojí k procesu MCP serveru.

Vhodné pro: vývojáře používající Claude Code v terminálu, kteří chtějí programatický přístup integrovaný do svého workflow.

Starší URL s tokenem: Třetí způsob připojení — přímá URL s vloženým tokenem — je dostupný pro pokročilé integrace a automatizační pipeline. Kontaktujte podporu, pokud tento formát potřebujete.

12 věcí, které můžete číst přes Claude (nástroje pouze pro čtení)

Všechny následující nástroje jsou dostupné jak na endpointu s plným přístupem, tak na endpointu pouze pro čtení. Dávají Claude kompletní přehled o vašem účtu Chaterimo bez jakýchkoli změn.

list_chatbots read

Vypíše všechny chatboty ve vaší organizaci s jejich ID, názvy a aktuálním AI modelem.

get_chatbot read

Kompletní konfigurace chatbota: AI model, systémový prompt, teplota, barvy widgetu, popisky tlačítek a všechna nastavení vzhledu.

list_conversations read

Filtrujte konverzace podle chatbota, časového rozsahu a platformy (web, WhatsApp, Facebook Messenger).

get_conversation read

Kompletní přepis konverzace se všemi zprávami, časovými razítky a metadaty návštěvníka. Podporuje stránkování pro dlouhé relace.

search_products read

Prohledejte synchronizovaný katalog produktů podle klíčového slova — stejné hybridní vyhledávání, které váš chatbot používá k odpovídání na dotazy o produktech.

list_products read

Procházejte všechny produkty synchronizované z vaší e-commerce platformy, včetně ceny, popisu a dostupnosti.

list_tickets read

Filtrujte support tickety podle stavu: new, in_progress, resolved nebo closed. Užitečné pro odhalení vzorců otevřených problémů.

get_ticket read

Kompletní detail ticketu včetně vlákna, historie stavu, přiřazeného agenta a propojené konverzace.

list_leads read

Všechny leady návštěvníků zachycené chat widgetem — e-mail, jméno, datum zachycení a zdrojový chatbot.

get_analytics read

Výkonnostní metriky chatbota za libovolné období až 365 dní: počet relací, objem zpráv, rozložení podle platformy a míry odpovědí.

list_sales_rules read

Zobrazte všechna aktivní pravidla prodejního agenta — spouštěče a zprávy, které váš proaktivní prodejní widget používá k oslovení návštěvníků.

get_dashboard read

Přehled dashboardu: celkový počet relací, aktivní chatboty, rozložení podle platformy a souhrn nedávné aktivity.

7 akcí, které může Claude provést s vaším chatbotem (nástroje pro zápis)

Nástroje pro zápis jsou dostupné pouze na endpointu s plným přístupem (/mcp/). Umožňují Claude provádět skutečné změny konfigurace vašeho chatbota — užitečné, když chcete aktualizovat nastavení přímo z Claude konverzace bez přepínání karet.

update_chatbot_instructions write

Přepište AI systémový prompt (max. 15 000 znaků). Doporučená délka: 15–40 řádků pro nejlepší výsledky. Změny nabývají účinnosti okamžitě.

update_chatbot_model write

Přepněte AI model (GPT-4o, Claude Sonnet, Gemini Flash a další) a nastavte teplotu mezi 0,1 a 1,0.

update_chatbot_language write

Nastavte pevný jazyk odpovědí nebo zvolte „Automaticky" pro detekci jazyka každého návštěvníka a odpovídání ve stejném jazyce.

update_chatbot_settings write

Aktualizujte název chatbota, popis, povolte nebo zakažte widget a upravte přísnost chování (jak přesně se drží zdrojů znalostní báze).

update_widget_appearance write

Nastavte barvy widgetu pomocí hex kódů, změňte polohu (vlevo, na střed, vpravo) a upravte styl bubliny tak, aby odpovídal vašemu brandu.

update_widget_messages write

Upravte uvítací zprávu, zástupný text vstupního pole, popisek animace „přemýšlení" a popisek tlačítka odeslání — vše viditelné vašim návštěvníkům.

retrain_chatbot write

Spusťte úlohu úplného přetrénování znalostní báze. Chatbot znovu indexuje všechny připojené zdroje: produkty, dokumenty a vlastní obsah.

Krok za krokem: nastavení Claude Desktop (OAuth)

Toto je nejrychlejší způsob připojení pro neprogramátory. Žádné konfigurační soubory, žádné API klíče — pouze OAuth flow.

Otevřete Claude Desktop a přejděte do Nastavení → Integrace (v některých verzích aplikace označeno jako „MCP Servers").
Klikněte na „Add MCP Server" a vložte jednu z následujících URL:
- Plný přístup (čtení + zápis): https://www.chaterimo.com/mcp/
- Pouze pro čtení: https://www.chaterimo.com/mcp-readonly/
Claude Desktop otevře OAuth autorizační stránku ve vašem prohlížeči. Přihlaste se ke svému účtu Chaterimo a klikněte na Autorizovat. Claude automaticky obdrží krátkodobý token — vy ho nevidíte ani neukládáte.
Claude Desktop nyní zobrazuje „Chaterimo" ve vašem seznamu nástrojů se zeleným indikátorem připojení. K dispozici je 19 nástrojů (nebo 12 nástrojů pouze pro čtení).
Zahajte novou konverzaci a zkuste: „Vypiš moje chatboty" nebo „Jaká je moje analytika za posledních 7 dní?" Claude zavolá MCP nástroje a vrátí formátovanou odpověď.

Kdy použít endpoint pouze pro čtení

Použijte /mcp-readonly/, pokud chcete Claude přístup k vašim datům — konverzacím, analytice, ticketům — bez možnosti měnit nastavení chatbota. To je správná volba pro členy týmu nebo analytiky, kteří mají mít přístup k datům, ale nesmí upravovat konfiguraci živého chatbota.

Krok za krokem: nastavení Claude Code CLI

Pro vývojáře používající Claude Code v terminálu běží MCP server jako lokální proces přes stdio transport. Potřebujete svůj Chaterimo API klíč z dashboardu Developer API.

Získejte svůj API klíč: Přihlaste se do Chaterimo → Developer API → API klíče → Vytvořit nový klíč. Klíč začíná na cha_.

Přidejte následující do svého souboru .claude/settings.json (nebo claude_desktop_config.json pro Claude Desktop CLI režim):

// .claude/settings.json or claude_desktop_config.json
{
  "mcpServers": {
    "chaterimo": {
      "command": "python",
      "args": ["-m", "developer_api.mcp_server"],
      "env": {
        "CHATERIMO_API_KEY": "cha_your_key_here"
      }
    }
  }
}

Nebo spusťte server přímo v terminálové relaci pro rychlé testování:

# Set your key and start the MCP server process
CHATERIMO_API_KEY=cha_xxx python -m developer_api.mcp_server

Po připojení může Claude Code během relace volat libovolný z 19 nástrojů Chaterimo. Výstup volání nástrojů uvidíte přímo při načítání dat z vašeho účtu.

Udržujte svůj API klíč v soukromí

Váš klíč cha_xxx uděluje stejnou úroveň přístupu jako vaše přihlášení do Chaterimo pro API operace. Necommitujte ho do správy verzí. Pro sdílená prostředí nebo týmové kontexty, kde nechcete přístup pro zápis, vytvořte samostatný API klíč pouze pro čtení z dashboardu Developer API a použijte ten.

Příklady reálného použití

Zde je pět konkrétních Claude promptů, které ukazují, jak MCP integrace vypadá v praxi. Každý prompt automaticky spouští specifické nástroje Chaterimo.

„Vypiš všechny moje chatboty a řekni mi, který má letos v měsíci nejvíce konverzací."
Claude zavolá list_chatbots pro získání ID chatbotů, pak zavolá get_analytics pro každý z nich s rozsahem 30 dní. Porovná počty relací a vrátí seřazený souhrn s vyzdviženým nejlepším výsledkem.
„Ukaž mi posledních 10 konverzací, kde zákazník zmínil ‚vrácení'."
Claude zavolá list_conversations pro procházení nedávných relací, pak zavolá get_conversation pro kandidáty. Přepisy filtruje podle klíčového slova a prezentuje výňatky s časovými razítky a názvy chatbotů.
„Přepiš instrukce pro chatbot č. 3, aby byl stručnější a přátelštější."
Claude zavolá get_chatbot pro přečtení aktuálního systémového promptu, navrhne revidovanou verzi v konverzaci k vašemu posouzení, pak po vašem potvrzení zavolá update_chatbot_instructions pro aplikaci změny.
„Přepni můj hlavní chatbot na GPT-4o s teplotou 0,3."
Claude zavolá list_chatbots pro identifikaci primárního chatbota, pak zavolá update_chatbot_model s cílovým modelem a hodnotou teploty. Změna nabývá účinnosti okamžitě.
„Jaké jsou moje nejdůležitější support tickety právě teď a jaké vzory vidíš?"
Claude zavolá list_tickets filtrované na stav new a in_progress, pak zavolá get_ticket pro každou otevřenou položku. Seskupí tickety podle tématu, identifikuje opakující se problémy a shrne nejčastější zákaznické problémy ve strukturovaném reportu.

Pouze pro čtení vs plný přístup: co zvolit?

Správná volba závisí na vaší roli a na tom, jak moc chcete, aby Claude mohl provádět změny. V případě pochybností začněte s přístupem pouze pro čtení a přejděte na plný přístup, když ho budete potřebovat.

	Pouze pro čtení	Plný přístup
Zobrazit konverzace, analytiku, leady	Ano	Ano
Číst konfiguraci chatbota a produkty	Ano	Ano
Aktualizovat instrukce chatbota	Ne	Ano
Změnit AI model nebo jazyk	Ne	Ano
Upravit vzhled widgetu	Ne	Ano
Spustit přetrénování	Ne	Ano
Endpoint (OAuth)	`/mcp-readonly/`	`/mcp/`
Vhodné pro	Analytiky, členy týmu	Majitele, vývojáře

Limity volání podle plánu

Volání MCP nástrojů se započítávají do vaší kvóty Developer API. Každé vyvolání nástroje — ať už ho Claude zavolá automaticky během konverzace, nebo ho spustíte ručně — se počítá jako jedno API volání.

Plán	Volání za minutu	Volání za den
Free	5	5
Trial	10	100
Paid	30	1 000

Všechna volání nástrojů jsou zaznamenána ve vašem Chaterimo dashboardu pod Developer API → MCP Sessions. Můžete zkontrolovat, které nástroje byly volány, kdy a kolik volání zbývá v denní kvótě.

Vše na jednom místě

MCP server Chaterimo propojuje Claude s živými daty vašeho chatbota — konverzacemi, analytikou, produkty, tickety a konfigurací — bez kopírování nebo přepínání karet. Ať už používáte Claude Desktop s OAuth nebo Claude Code s API klíčem, stejných 19 nástrojů je k dispozici pro dotazování a správu vašeho chatbota v přirozeném jazyce.

Žádné kopírování protokolů konverzací do Claude
Pokládejte otázky v přirozeném jazyce o výkonu chatbota
Aktualizujte instrukce chatbota přímo z Claude konverzace
Funguje s Claude Desktop (OAuth) i Claude Code (API klíč)
Endpoint pouze pro čtení pro bezpečné sdílení v týmu

Začít zdarma Dokumentace Developer API