Chaterimo MCP Server: Prepojte Claude AI s vaším chatbotom (2026)

Použite Claude Desktop alebo Claude Code na čítanie konverzácií, sledovanie analytiky, aktualizáciu AI inštrukcií a správu widgetu chatbota — priamo z Claude.

Čo je MCP a prečo je dôležité pre e-commerce

MCP je skratka pre Model Context Protocol — otvorený štandard, ktorý umožňuje Claude AI pripojiť sa k externým nástrojom a čítať živé dáta z vašich systémov v reálnom čase. Namiesto toho, aby ste kopírovali prepis konverzácie z Chaterimo a vkladali ho do Claude na analýzu, sa jednoducho opýtate Claude priamo: „Aké sú hlavné sťažnosti v mojom chatbote tento týždeň?" Claude zavolá nástroje Chaterimo MCP, načíta údaje a okamžite odpovie.

Pre e-commerce tímy to mení spôsob práce s dátami chatbota. Už sa nemusíte prihlasovať do dashboardu, aby ste skontrolovali analytiku, prečítali ticket alebo aktualizovali AI inštrukcie. Všetko zvládnete priamo v konverzácii s Claude v bežnej slovenčine.

Chaterimo MCP server sprístupňuje 19 nástrojov pokrývajúcich chatboty, konverzácie, produkty, tickety, leady a analytiku. Dvanásť z nich je len na čítanie, sedem umožňuje zápis. Sami si zvolíte úroveň prístupu, ktorú Claude udelíte, podľa spôsobu pripojenia.

Čo môžete robiť s Chaterimo + Claude cez MCP

  • Požiadajte Claude, aby zhrnil nedávne sťažnosti zákazníkov z vášho chatbota
  • Nechajte Claude prepísať váš AI systémový prompt stručnejším štýlom
  • Skontrolujte trendy v analytike za posledných 30 dní bez otvárania dashboardu
  • Prehľadajte katalóg produktov a analyzujte vzory ticketov v jednej konverzácii
  • Prepnite AI model alebo nastavenie jazyka chatbota jedinou inštrukciou

Dva spôsoby pripojenia: Claude Desktop (OAuth) vs Claude Code CLI

Chaterimo podporuje dva spôsoby pripojenia. Správna voľba závisí od toho, kto sa pripája a ako pracuje.

OAuth / Claude Desktop — bez tokenu

OAuth endpointy využívajú štandardný postup autorizácie MCP. Vložíte URL do Claude Desktop, autorizujete sa prihlásením do Chaterimo a Claude automaticky získa krátkodobý prístupový token. Žiadny API kľúč na správu, žiadne konfiguračné súbory na úpravu.

  • Plný prístup (čítanie + zápis): https://www.chaterimo.com/mcp/
  • Len na čítanie (bezpečné pre zdieľanie): https://www.chaterimo.com/mcp-readonly/

Vhodné pre: majiteľov firiem, marketérov, manažérov podpory — každého, kto používa Claude Desktop a chce sa pýtať na údaje chatbota alebo ho spravovať bez písania kódu.

API kľúč / Claude Code CLI — stdio transport

CLI integrácia používa FastMCP cez stdio. Zadáte svoj Chaterimo API kľúč (cha_xxx), dostupný z dashboardu Developer API, a Claude Code sa priamo pripojí k procesu MCP servera.

Vhodné pre: vývojárov používajúcich Claude Code v termináli, ktorí chcú programatický prístup integrovaný do ich pracovného postupu.

Staršie URL s tokenom: Tretí spôsob pripojenia — priama URL s vloženým tokenom — je dostupný pre pokročilé integrácie a automatizačné pipeline. Kontaktujte podporu, ak potrebujete tento formát.

12 vecí, ktoré môžete čítať cez Claude (nástroje len na čítanie)

Všetky nasledujúce nástroje sú dostupné na endpointoch s plným prístupom aj len na čítanie. Poskytujú Claude úplný prehľad o vašom Chaterimo účte bez akýchkoľvek zmien.

list_chatbots read

Zoznam všetkých chatbotov vo vašej organizácii s ich ID, názvami a aktuálnym AI modelom.

get_chatbot read

Kompletná konfigurácia chatbota: AI model, systémový prompt, teplota, farby widgetu, popisky tlačidiel a všetky nastavenia vzhľadu.

list_conversations read

Filtrovanie konverzácií podľa chatbota, časového rozsahu a platformy (web, WhatsApp, Facebook Messenger).

get_conversation read

Kompletný prepis konverzácie so všetkými správami, časovými značkami a metadátami návštevníka. Podporuje stránkovanie pre dlhé relácie.

search_products read

Vyhľadávanie v synchornizovanom katalógu produktov podľa kľúčového slova — rovnaké hybridné vyhľadávanie, ktoré váš chatbot používa na odpovedanie na otázky o produktoch.

list_products read

Prehľad všetkých produktov synchronizovaných z vašej e-commerce platformy vrátane ceny, popisu a dostupnosti.

list_tickets read

Filtrovanie supportových ticketov podľa stavu: new, in_progress, resolved alebo closed. Užitočné na identifikáciu vzorcov otvorených problémov.

get_ticket read

Kompletné detaily ticketu vrátane vlákna, histórie stavov, priradeného agenta a prepojenej konverzácie.

list_leads read

Všetky leady návštevníkov zachytené widgetom chatu — e-mail, meno, dátum zachytenia a zdrojový chatbot.

get_analytics read

Výkonnostné metriky chatbota za akékoľvek obdobie až 365 dní: počet relácií, objem správ, rozdelenie podľa platformy a miery odpovedí.

list_sales_rules read

Zobrazenie všetkých aktívnych pravidiel predajného agenta — spúšťačov a správ, ktoré váš proaktívny predajný widget používa na oslovenie návštevníkov.

get_dashboard read

Prehľad dashboardu: celkový počet relácií, aktívne chatboty, rozdelenie podľa platformy a súhrn nedávnej aktivity.

7 akcií, ktoré môže Claude vykonať na vašom chatbote (nástroje na zápis)

Nástroje na zápis sú dostupné iba na endpointe s plným prístupom (/mcp/). Umožňujú Claude vykonávať skutočné zmeny v konfigurácii chatbota — užitočné, keď chcete aktualizovať nastavenie priamo z konverzácie Claude bez prepínania kariet.

update_chatbot_instructions write

Prepísanie AI systémového promptu (max. 15 000 znakov). Odporúčaná dĺžka: 15–40 riadkov pre najlepšie výsledky. Zmeny nadobúdajú účinnosť okamžite.

update_chatbot_model write

Prepnutie AI modelu (GPT-4o, Claude Sonnet, Gemini Flash a ďalšie) a nastavenie teploty v rozsahu 0,1 až 1,0.

update_chatbot_language write

Nastavenie pevného jazyka odpovedí alebo voľba „Automaticky" na rozpoznávanie jazyka každého návštevníka a odpovedanie v jeho jazyku.

update_chatbot_settings write

Aktualizácia názvu a popisu chatbota, zapnutie alebo vypnutie widgetu a úprava prísnosti správania (ako tesne sa drží zdrojov znalostnej bázy).

update_widget_appearance write

Nastavenie farieb widgetu pomocou hex kódov, zmena pozície (vľavo, v strede, vpravo) a úprava štýlu bubliny podľa vašej značky.

update_widget_messages write

Úprava uvítacej správy, zástupného textu v poli pre vstup, popisku animácie „myslím" a popisku tlačidla na odoslanie — všetko viditeľné pre vašich návštevníkov.

retrain_chatbot write

Spustenie úlohy úplného preškolenia znalostnej bázy. Chatbot znovu indexuje všetky pripojené zdroje: produkty, dokumenty a vlastný obsah.

Krok za krokom: nastavenie Claude Desktop (OAuth)

Toto je najrýchlejší spôsob pripojenia pre používateľov bez technického zázemia. Žiadne konfiguračné súbory, žiadne API kľúče — iba OAuth postup.

  1. Otvorte Claude Desktop a prejdite do Nastavenia → Integrácie (v niektorých verziách aplikácie označené ako „MCP Servers").
  2. Kliknite na „Pridať MCP server" a vložte jednu z nasledujúcich URL:
    • Plný prístup (čítanie + zápis): https://www.chaterimo.com/mcp/
    • Len na čítanie: https://www.chaterimo.com/mcp-readonly/
  3. Claude Desktop otvorí autorizačnú stránku OAuth vo vašom prehliadači. Prihláste sa do svojho Chaterimo účtu a kliknite na Autorizovať. Claude automaticky získa krátkodobý token — vy ho nevidíte ani neukladáte.
  4. Claude Desktop teraz zobrazuje „Chaterimo" v zozname nástrojov so zeleným indikátorom pripojenia. K dispozícii je 19 nástrojov (alebo 12 nástrojov len na čítanie).
  5. Začnite novú konverzáciu a vyskúšajte: „Zoznam mojich chatbotov" alebo „Aká je moja analytika za posledných 7 dní?" Claude zavolá MCP nástroje a vráti formátovanú odpoveď.

Kedy použiť endpoint len na čítanie

Použite /mcp-readonly/, ak chcete Claude poskytnúť prístup k vašim dátam — konverzáciám, analytike, ticketom — bez toho, aby mohol meniť nastavenia chatbota. Toto je správna voľba pre členov tímu alebo analytikov, ktorí môžu dopytovať dáta, ale nemali by upravovať živú konfiguráciu chatbota.

Krok za krokom: nastavenie Claude Code CLI

Pre vývojárov používajúcich Claude Code v termináli beží MCP server ako lokálny proces cez stdio transport. Potrebujete svoj Chaterimo API kľúč z dashboardu Developer API.

Získajte API kľúč: Prihláste sa do Chaterimo → Developer API → API kľúče → Vytvoriť nový kľúč. Kľúč začína cha_.

Pridajte nasledujúce do súboru .claude/settings.json (alebo claude_desktop_config.json pre 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" } } } }

Alebo spustite server priamo v termináli na rýchle testovanie:

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

Po pripojení môže Claude Code volať ktorýkoľvek z 19 nástrojov Chaterimo počas relácie. Výstup volania nástrojov uvidíte priamo, keď Claude načítava dáta z vášho účtu.

Chráňte svoj API kľúč

Váš kľúč cha_xxx poskytuje rovnakú úroveň prístupu ako vaše prihlásenie do Chaterimo pre API operácie. Necommitujte ho do verzionovania kódu. Pre zdieľané prostredia alebo tímové kontexty, kde nechcete prístup na zápis, vytvorte samostatný API kľúč len na čítanie z dashboardu Developer API a použite ho.

Príklady reálnych scenárov použitia

Tu je päť konkrétnych promptov pre Claude, ktoré ukazujú, ako MCP integrácia vyzerá v praxi. Každý prompt automaticky spustí špecifické nástroje Chaterimo.

  1. „Zoznam všetkých mojich chatbotov a povedz mi, ktorý má tento mesiac najviac konverzácií."
    Claude zavolá list_chatbots na získanie ID vašich chatbotov, potom zavolá get_analytics pre každý z nich s rozsahom 30 dní. Porovná počty relácií a vráti zoradený súhrn s vyzdvihnutým najlepším výsledkom.
  2. „Ukáž mi posledných 10 konverzácií, kde zákazník spomenul slovo ‚vrátenie'."
    Claude zavolá list_conversations na prehľadanie nedávnych relácií, potom zavolá get_conversation na kandidátov. Filtruje prepisy podľa kľúčového slova a prezentuje výňatky s časovými značkami a názvami chatbotov.
  3. „Prepíš inštrukcie pre chatbot č. 3 tak, aby boli stručnejšie a priateľskejšie."
    Claude zavolá get_chatbot na prečítanie aktuálneho systémového promptu, navrhne revidovanú verziu v konverzácii na vaše posúdenie, potom zavolá update_chatbot_instructions na jej uplatnenie po vašom potvrdení.
  4. „Prepni môj hlavný chatbot na GPT-4o s teplotou 0,3."
    Claude zavolá list_chatbots na identifikáciu, ktorý chatbot je označený ako primárny, potom zavolá update_chatbot_model s cieľovým modelom a hodnotou teploty. Zmena nadobúda účinnosť okamžite.
  5. „Aké sú moje hlavné supportové tickety teraz a aké vzory v nich vidíš?"
    Claude zavolá list_tickets filtrované podľa stavu new a in_progress, potom zavolá get_ticket pre každú otvorenú položku. Zoskupí tickety podľa témy, identifikuje opakujúce sa problémy a zhrnie najčastejšie problémy zákazníkov v štruktúrovanej správe.

Len na čítanie vs. plný prístup: čo by ste mali použiť?

Správna voľba závisí od vašej roly a od toho, koľko chcete, aby Claude mohol meniť. V prípade pochybností začnite s prístupom len na čítanie a upgradujte, keď to budete potrebovať.

Len na čítanie Plný prístup
Zobrazenie konverzácií, analytiky, leadov Áno Áno
Čítanie konfigurácie chatbota a produktov Áno Áno
Aktualizácia inštrukcií chatbota Nie Áno
Zmena AI modelu alebo jazyka Nie Áno
Úprava vzhľadu widgetu Nie Áno
Spustenie preškolenia Nie Áno
Endpoint (OAuth) /mcp-readonly/ /mcp/
Vhodné pre Analytici, členovia tímu Majitelia, vývojári

Limity volaní podľa plánu

Volania nástrojov MCP sa započítavajú do vašej kvóty Developer API. Každé vyvolanie nástroja — či už ho Claude zavolá automaticky počas konverzácie alebo ho spustíte ručne — sa počíta ako jedno volanie API.

Plán Volania za minútu Volania za deň
Free 5 5
Trial 10 100
Paid 30 1 000

Všetky volania nástrojov sú zaznamenané vo vašom Chaterimo dashboarde pod Developer API → MCP Sessions. Môžete skontrolovať, ktoré nástroje boli volané, kedy a koľko volaní zostáva vo vašej dennej kvóte.

Všetko na jednom mieste

Chaterimo MCP server prepája Claude s vašimi živými dátami chatbota — konverzáciami, analytikou, produktmi, ticketmi a konfiguráciou — bez kopírovania alebo prepínania kariet. Či už používate Claude Desktop s OAuth alebo Claude Code s API kľúčom, rovnakých 19 nástrojov je k dispozícii na dopytovanie a správu chatbota v bežnom jazyku.

  • Žiadne kopírovanie záznamov konverzácií do Claude
  • Pýtajte sa na výkon chatbota prirodzeným jazykom
  • Aktualizujte inštrukcie chatbota priamo z konverzácie Claude
  • Funguje s Claude Desktop (OAuth) aj Claude Code (API kľúč)
  • Endpoint len na čítanie pre bezpečné zdieľanie v tíme
Začať zadarmo Dokumentácia Developer API

Copyright © Chaterimo

about-icon