Serverul MCP Chaterimo: conectați Claude AI la chatbotul dvs. (2026)

Folosiți Claude Desktop sau Claude Code pentru a citi conversații, verifica analize, actualiza instrucțiuni AI și administra widgetul chatbotului, direct din Claude.

Ghiduri pentru API-ul pentru dezvoltatori

Consultați și: Asistență clienți AI pentru Shopify · Cel mai bun chatbot AI pentru Shopify

Ce este MCP și de ce contează pentru comerțul electronic

MCP înseamnă Model Context Protocol, un standard deschis prin care Claude AI se conectează la instrumente externe și citește date actuale din sistemele dvs. Puteți întreba direct: „Care sunt principalele reclamații primite de chatbot în această săptămână?”. Claude apelează instrumentele MCP Chaterimo, preia datele și răspunde imediat, fără să copiați manual transcrierile conversațiilor.

Pentru echipele de comerț electronic, acest lucru schimbă modul de lucru cu datele chatbotului. Puteți verifica analize, citi solicitări sau actualiza instrucțiuni AI direct într-o conversație cu Claude, folosind limbaj natural.

Serverul MCP Chaterimo pune la dispoziție 19 instrumente pentru chatboți, conversații, produse, solicitări de asistență, cereri de contact și analize. Douăsprezece sunt doar pentru citire, iar șapte permit modificări. Alegeți nivelul de acces acordat lui Claude prin metoda de conectare.

Ce puteți face cu Chaterimo și Claude prin MCP

  • Cereți lui Claude să rezume reclamațiile recente primite de chatbot
  • Cereți rescrierea instrucțiunilor de sistem AI într-un stil mai concis
  • Verificați tendințele din ultimele 30 de zile fără a deschide panoul de control
  • Căutați în catalog și analizați tiparele solicitărilor în aceeași conversație
  • Schimbați modelul AI sau limba chatbotului printr-o singură instrucțiune

Două metode de conectare: Claude Desktop prin OAuth și Claude Code CLI

Chaterimo acceptă două metode de conectare. Alegerea depinde de persoana care se conectează și de modul său de lucru.

OAuth / Claude Desktop — fără token introdus manual

Endpointurile OAuth folosesc fluxul standard de autorizare MCP. Introduceți URL-ul în Claude Desktop, vă autentificați în Chaterimo, iar Claude primește automat un token de acces cu durată scurtă. Nu trebuie să administrați o cheie API sau să editați fișiere de configurare.

  • Acces complet, citire și modificare: https://www.chaterimo.com/mcp/
  • Doar citire, pentru acces partajat: https://www.chaterimo.com/mcp-readonly/

Potrivit pentru proprietari de afaceri, specialiști în marketing și responsabili de asistență care folosesc Claude Desktop și doresc să consulte sau să administreze chatbotul fără programare.

Cheie API / Claude Code CLI — transport stdio

Integrarea CLI folosește FastMCP prin stdio. Furnizați cheia API Chaterimo (cha_xxx), disponibilă în panoul API pentru dezvoltatori, iar Claude Code se conectează direct la procesul serverului MCP.

Potrivit pentru dezvoltatorii care rulează Claude Code în terminal și doresc acces programatic integrat în fluxul lor de lucru.

URL-uri vechi cu token: O a treia metodă, URL-ul direct cu token inclus, este disponibilă pentru integrări avansate și procese de automatizare. Contactați asistența dacă aveți nevoie de acest format.

12 tipuri de informații accesibile din Claude prin instrumentele de citire

Toate instrumentele de mai jos sunt disponibile atât prin endpointul cu acces complet, cât și prin cel doar pentru citire. Îi oferă lui Claude o imagine completă a contului Chaterimo, fără modificări.

list_chatbots citire

Listează chatboții organizației, împreună cu ID-urile, numele și modelul AI curent.

get_chatbot citire

Configurația completă a chatbotului: model AI, instrucțiuni de sistem, temperatură, culori, etichetele butoanelor și toate setările de aspect.

list_conversations citire

Filtrează conversațiile după chatbot, interval de date și platformă: web, WhatsApp sau Facebook Messenger.

get_conversation citire

Transcrierea completă, cu mesaje, marcaje temporale și metadatele vizitatorului. Acceptă paginare pentru sesiunile lungi.

search_products citire

Caută după cuvinte-cheie în catalogul sincronizat, folosind aceeași căutare hibridă ca chatbotul când răspunde despre produse.

list_products citire

Afișează produsele sincronizate din platforma de comerț electronic, inclusiv preț, descriere și disponibilitate.

list_tickets citire

Filtrează solicitările după stările new, in_progress, resolved sau closed. Ajută la identificarea tiparelor problemelor deschise.

get_ticket citire

Detaliile complete ale solicitării: discuție, istoricul stărilor, operatorul alocat și conversația asociată.

list_leads citire

Cererile de contact colectate de widget: e-mail, nume, data colectării și chatbotul sursă.

get_analytics citire

Indicatorii de performanță pentru orice perioadă de până la 365 de zile: număr de sesiuni, volum de mesaje, distribuție pe platforme și rate de răspuns.

list_sales_rules citire

Afișează regulile active ale agentului de vânzări: condițiile de declanșare și mesajele folosite pentru interacțiunea proactivă cu vizitatorii.

get_dashboard citire

Prezentarea generală a panoului: total sesiuni, chatboți activi, distribuție pe platforme și rezumatul activității recente.

7 acțiuni pe care Claude le poate efectua prin instrumentele de modificare

Instrumentele de modificare sunt disponibile numai prin endpointul cu acces complet (/mcp/). Permit schimbări reale în configurația chatbotului, direct din conversația cu Claude, fără a schimba filele.

update_chatbot_instructions modificare

Rescrie instrucțiunile de sistem AI, până la 15.000 de caractere. Lungime recomandată pentru rezultate bune: 15–40 de rânduri. Modificările se aplică imediat.

update_chatbot_model modificare

Schimbă modelul dintre variantele actuale GPT, Claude, Gemini și Grok și setează temperatura între 0,1 și 1,0.

update_chatbot_language modificare

Setează o limbă fixă pentru răspunsuri sau opțiunea „Automatic” (Automat), pentru detectarea limbii fiecărui vizitator.

update_chatbot_settings modificare

Actualizează numele și descrierea chatbotului, activează sau dezactivează widgetul și ajustează strictețea respectării surselor din baza de cunoștințe.

update_widget_appearance modificare

Setează culorile widgetului prin coduri hexazecimale, poziția în stânga, centru sau dreapta și stilul bulei de chat.

update_widget_messages modificare

Editează mesajul de întâmpinare, textul orientativ al câmpului de mesaj, eticheta animației de gândire și butonul de trimitere, toate vizibile vizitatorilor.

retrain_chatbot modificare

Pornește o antrenare completă a bazei de cunoștințe. Chatbotul reindexează sursele conectate: produse, documente și conținut personalizat.

Configurarea Claude Desktop prin OAuth, pas cu pas

Aceasta este cea mai rapidă metodă pentru persoanele fără experiență de dezvoltare. Folosește un flux OAuth, fără fișiere de configurare sau chei API introduse manual.

  1. Deschideți Claude Desktop și accesați Settings → Integrations (Setări → Integrări), secțiune numită și „MCP Servers” în unele versiuni.
  2. Apăsați „Add MCP Server” (Adăugați server MCP) și introduceți unul dintre URL-urile următoare:
    • Acces complet, citire și modificare: https://www.chaterimo.com/mcp/
    • Doar citire: https://www.chaterimo.com/mcp-readonly/
  3. Claude Desktop deschide în browser pagina de autorizare OAuth. Autentificați-vă în contul Chaterimo și apăsați Authorize (Autorizați). Claude primește automat un token cu durată scurtă, pe care nu trebuie să îl vedeți sau să îl stocați.
  4. Claude Desktop afișează acum „Chaterimo” în lista instrumentelor, cu un indicator verde de conectare. Sunt disponibile cele 19 instrumente sau cele 12 instrumente doar pentru citire.
  5. Începeți o conversație și încercați: „Listează chatboții mei” sau „Care sunt statisticile din ultimele 7 zile?”. Claude apelează instrumentele MCP și returnează un răspuns formatat.

Când folosiți endpointul doar pentru citire

Folosiți /mcp-readonly/ pentru a-i permite lui Claude să citească conversații, analize și solicitări fără a schimba setările chatbotului. Este potrivit pentru colegi sau analiști care trebuie să consulte datele, fără drept de modificare a configurației active.

Configurarea Claude Code CLI, pas cu pas

Pentru dezvoltatorii care folosesc Claude Code în terminal, serverul MCP rulează ca proces local prin transport stdio. Aveți nevoie de cheia API Chaterimo din panoul pentru dezvoltatori.

Obțineți cheia API: Autentificați-vă în Chaterimo și accesați API pentru dezvoltatori → Chei API → Creați o cheie nouă. Cheia începe cu cha_.

Adăugați configurația următoare în .claude/settings.json sau în claude_desktop_config.json pentru modul CLI Claude Desktop:

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

Sau rulați serverul direct într-o sesiune de terminal pentru o verificare rapidă:

# Setați cheia și porniți procesul serverului MCP CHATERIMO_API_KEY=cha_xxx python -m developer_api.mcp_server

După conectare, Claude Code poate apela oricare dintre cele 19 instrumente Chaterimo în timpul sesiunii. Veți vedea rezultatele apelurilor pe măsură ce Claude preia datele din cont.

Păstrați cheia API privată

Cheia cha_xxx acordă pentru operațiunile API același nivel de acces ca autentificarea Chaterimo. Nu o includeți în sistemul de control al versiunilor. Pentru medii partajate sau echipe care nu trebuie să poată face modificări, creați o cheie API separată, doar pentru citire, în panoul pentru dezvoltatori.

Exemple practice de utilizare

Iată cinci instrucțiuni pentru Claude care arată cum funcționează integrarea MCP. Fiecare declanșează automat anumite instrumente Chaterimo.

  1. „Listează toți chatboții mei și spune-mi care a avut cele mai multe conversații luna aceasta.”
    Claude apelează list_chatbots pentru ID-uri, apoi get_analytics pentru fiecare chatbot, pe un interval de 30 de zile. Compară numărul sesiunilor și prezintă un clasament, evidențiind primul loc.
  2. „Arată-mi ultimele 10 conversații în care un client a menționat «retur».”
    Claude apelează list_conversations pentru sesiunile recente, apoi get_conversation pentru cele relevante. Filtrează transcrierile după cuvântul-cheie și prezintă fragmente cu data, ora și numele chatbotului.
  3. „Rescrie instrucțiunile chatbotului nr. 3 într-un stil mai concis și prietenos.”
    Claude folosește get_chatbot pentru a citi instrucțiunile actuale, propune o versiune nouă pentru revizuire și apelează update_chatbot_instructions după confirmarea dvs.
  4. „Treci chatbotul meu principal la cel mai recent model GPT disponibil, cu temperatura 0,3.”
    Claude apelează list_chatbots pentru a identifica chatbotul principal, apoi update_chatbot_model cu modelul și temperatura dorite. Modificarea se aplică imediat.
  5. „Care sunt principalele solicitări de asistență deschise și ce tipare observi?”
    Claude folosește list_tickets cu filtrele new și in_progress, apoi get_ticket pentru fiecare solicitare. Le grupează pe subiecte, identifică probleme recurente și prezintă un raport structurat.

Doar citire sau acces complet: ce alegeți?

Alegerea depinde de rolul dvs. și de modificările pe care doriți să le permită Claude. Dacă nu sunteți sigur, începeți cu acces doar pentru citire și extindeți-l când aveți nevoie.

Doar citire Acces complet
Vizualizarea conversațiilor, analizelor și cererilor de contact Da Da
Citirea configurației chatbotului și a produselor Da Da
Actualizarea instrucțiunilor chatbotului Nu Da
Schimbarea modelului AI sau a limbii Nu Da
Modificarea aspectului widgetului Nu Da
Pornirea unei noi antrenări Nu Da
Endpoint OAuth /mcp-readonly/ /mcp/
Potrivit pentru Analiști și membri ai echipei Proprietari și dezvoltatori

Limite de apeluri în funcție de abonament

Apelurile instrumentelor MCP se scad din cota API pentru dezvoltatori. Fiecare invocare, automată în conversația cu Claude sau declanșată manual, contează ca un apel API.

Plan Apeluri pe minut Apeluri pe zi
Gratuit 5 5
Perioadă de probă 10 100
Plătit 30 1.000

Apelurile sunt înregistrate în panoul Chaterimo, la API pentru dezvoltatori → Sesiuni MCP. Puteți vedea ce instrumente au fost apelate, când și câte apeluri mai sunt disponibile din cota zilnică.

Totul într-un singur loc

Serverul MCP Chaterimo conectează Claude la datele actuale ale chatbotului: conversații, analize, produse, solicitări și configurație. Fie că folosiți Claude Desktop cu OAuth sau Claude Code cu o cheie API, aceleași 19 instrumente vă permit să consultați și să administrați chatbotul în limbaj natural, fără copiere manuală sau schimbarea filelor.

  • Fără copierea manuală a conversațiilor în Claude
  • Întrebări în limbaj natural despre performanța chatbotului
  • Actualizarea instrucțiunilor direct din conversația cu Claude
  • Compatibil cu Claude Desktop prin OAuth și Claude Code prin cheie API
  • Endpoint doar pentru citire, pentru acces partajat în echipă
Începeți gratuit Detalii despre conectarea MCP

Copyright © Chaterimo

about-icon