Cos'è il server MCP di Chaterimo?

Il server MCP di Chaterimo espone 19 strumenti tramite il Model Context Protocol, permettendo a Claude AI di leggere e aggiornare i dati del tuo chatbot in tempo reale — incluse conversazioni, analisi, prodotti, lead, ticket e configurazione del chatbot.

Ho bisogno di uno sviluppatore per configurare l'integrazione MCP?

No. Il flusso OAuth di Claude Desktop richiede solo un accesso Chaterimo — nessuna competenza di programmazione necessaria. Incolla l'URL dell'endpoint nelle impostazioni di Claude Desktop, autorizza tramite OAuth e sei connesso.

Cosa può leggere Claude dal mio account Chaterimo tramite MCP?

Conversazioni, analisi, prodotti, lead, ticket, regole di vendita, statistiche della dashboard e la configurazione completa del chatbot incluso il modello AI, il prompt di sistema e l'aspetto del widget.

Claude può modificare le impostazioni del mio chatbot tramite MCP?

Sì, usando l'endpoint ad accesso completo. Claude può aggiornare le istruzioni, il modello AI, la lingua, i colori del widget e i messaggi, e avviare il retraining. Usa l'endpoint di sola lettura (/mcp-readonly/) per impedire le modifiche.

La connessione MCP è sicura?

Sì. Le connessioni OAuth usano token di breve durata. Le connessioni tramite chiave API usano la tua chiave cha_xxx — trattala come una password e usa chiavi di sola lettura per l'accesso condiviso.

Chaterimo MCP Server: Collega Claude AI al Tuo Chatbot (2026)

Di David Langr • Aggiornato il 2026-05-04 • 10 min di lettura

Usa Claude Desktop o Claude Code per leggere le conversazioni, controllare le analisi, aggiornare le istruzioni AI e gestire il widget del tuo chatbot — direttamente da Claude.

Cluster API Sviluppatori

Vedi anche: Assistenza clienti AI per Shopify · Miglior chatbot AI per Shopify

Cos'è MCP e perché è importante per l'e-commerce

MCP sta per Model Context Protocol — uno standard aperto che permette a Claude AI di connettersi a strumenti esterni e leggere dati in tempo reale dai tuoi sistemi. Invece di copiare una trascrizione di conversazione da Chaterimo e incollarla in Claude per l'analisi, chiedi direttamente a Claude: "Quali sono i principali reclami nel mio chatbot questa settimana?" Claude chiama gli strumenti MCP di Chaterimo, recupera i dati e risponde immediatamente.

Per i team e-commerce, questo cambia il modo in cui interagisci con i dati del tuo chatbot. Non devi più accedere a una dashboard per controllare le analisi, leggere un ticket o aggiornare le tue istruzioni AI. Lo fai all'interno di una conversazione con Claude usando il linguaggio naturale.

Il server MCP di Chaterimo espone 19 strumenti che coprono chatbot, conversazioni, prodotti, ticket, lead e analisi. Dodici sono di sola lettura; sette consentono la scrittura. Scegli quale livello di accesso concedere a Claude in base al metodo di connessione.

      Cosa puoi fare con Chaterimo + Claude tramite MCP
      Chiedere a Claude di riassumere i reclami recenti dei clienti dal tuo chatbot
Fare riscrivere a Claude il prompt di sistema AI in uno stile più conciso
Controllare le tendenze delle analisi degli ultimi 30 giorni senza aprire una dashboard
Cercare nel catalogo prodotti ed esaminare i pattern dei ticket in un'unica conversazione
Cambiare il modello AI del chatbot o l'impostazione della lingua con una singola istruzione

    

Due metodi di connessione: Claude Desktop (OAuth) vs Claude Code CLI

Chaterimo supporta due metodi di connessione. Quello giusto dipende da chi si connette e da come lavora.

OAuth / Claude Desktop — nessun token richiesto

Gli endpoint OAuth utilizzano il flusso di autorizzazione MCP standard. Incolla un URL in Claude Desktop, autorizza con il tuo login Chaterimo e Claude ottiene automaticamente un token di accesso di breve durata. Nessuna chiave API da gestire, nessun file di configurazione da modificare.

Accesso completo (lettura + scrittura): https://www.chaterimo.com/mcp/
Sola lettura (sicuro da condividere): https://www.chaterimo.com/mcp-readonly/

Ideale per: titolari di aziende, marketer, responsabili del supporto — chiunque utilizzi Claude Desktop e voglia interrogare o gestire il proprio chatbot senza scrivere codice.

Chiave API / Claude Code CLI — trasporto stdio

L'integrazione CLI usa FastMCP tramite stdio. Fornisci la tua chiave API Chaterimo (cha_xxx), disponibile dalla dashboard API Sviluppatori, e Claude Code si connette direttamente al processo del server MCP.

Ideale per: sviluppatori che usano Claude Code nel terminale e vogliono un accesso programmatico integrato nel loro flusso di lavoro.

URL con token legacy: Un terzo metodo di connessione — URL diretto con token incorporato — è disponibile per integrazioni avanzate e pipeline di automazione. Contatta il supporto se hai bisogno di questo formato.

12 cose che puoi leggere da Claude (strumenti di sola lettura)

Tutti i seguenti strumenti sono disponibili sia sull'endpoint ad accesso completo che su quello di sola lettura. Danno a Claude una visione completa del tuo account Chaterimo senza modificare nulla.

list_chatbots read

Elenca tutti i chatbot nella tua organizzazione con i loro ID, nomi e modello AI attuale.

get_chatbot read

Configurazione completa del chatbot: modello AI, prompt di sistema, temperatura, colori del widget, etichette dei pulsanti e tutte le impostazioni di aspetto.

list_conversations read

Filtra le conversazioni per chatbot, intervallo di date e piattaforma (web, WhatsApp, Facebook Messenger).

get_conversation read

Trascrizione completa della conversazione con tutti i messaggi, i timestamp e i metadati del visitatore. Supporta la paginazione per sessioni lunghe.

search_products read

Cerca nel catalogo prodotti sincronizzato per parola chiave — la stessa ricerca ibrida che il tuo chatbot usa per rispondere alle domande sui prodotti.

list_products read

Sfoglia tutti i prodotti sincronizzati dalla tua piattaforma e-commerce, inclusi prezzo, descrizione e disponibilità.

list_tickets read

Filtra i ticket di supporto per stato: new, in_progress, resolved o closed. Utile per individuare i pattern dei problemi aperti.

get_ticket read

Dettagli completi del ticket inclusi il thread, la cronologia degli stati, l'agente assegnato e la conversazione collegata.

list_leads read

Tutti i lead dei visitatori acquisiti dal widget chat — email, nome, data di acquisizione e chatbot di origine.

get_analytics read

Metriche di performance del chatbot per qualsiasi periodo fino a 365 giorni: numero di sessioni, volume di messaggi, suddivisione per piattaforma e tassi di risposta.

list_sales_rules read

Visualizza tutte le regole attive dell'agente di vendita — i trigger e i messaggi che il tuo widget di vendita proattivo usa per coinvolgere i visitatori.

get_dashboard read

Panoramica della dashboard: sessioni totali, chatbot attivi, suddivisione per piattaforma e riepilogo delle attività recenti.

7 azioni che Claude può compiere sul tuo chatbot (strumenti di scrittura)

Gli strumenti di scrittura sono disponibili solo sull'endpoint ad accesso completo (/mcp/). Permettono a Claude di apportare modifiche reali alla configurazione del tuo chatbot — utile quando vuoi aggiornare la tua configurazione dall'interno di una conversazione Claude senza cambiare scheda.

update_chatbot_instructions write

Riscrivi il prompt di sistema AI (max 15.000 caratteri). Lunghezza consigliata: 15–40 righe per i migliori risultati. Le modifiche entrano in vigore immediatamente.

update_chatbot_model write

Cambia il modello AI (GPT-4o, Claude Sonnet, Gemini Flash e altri) e imposta la temperatura tra 0,1 e 1,0.

update_chatbot_language write

Imposta una lingua di risposta fissa o scegli "Automatica" per rilevare la lingua di ogni visitatore e rispondere di conseguenza.

update_chatbot_settings write

Aggiorna il nome e la descrizione del chatbot, abilita o disabilita il widget e regola il livello di rigore del comportamento (quanto strettamente segue le fonti della knowledge base).

update_widget_appearance write

Imposta i colori del widget usando codici esadecimali, cambia la posizione (sinistra, centro, destra) e regola lo stile della bolla per abbinarla al tuo brand.

update_widget_messages write

Modifica il messaggio di benvenuto, il testo segnaposto dell'input, l'etichetta dell'animazione "in elaborazione" e l'etichetta del pulsante di invio — tutto visibile ai tuoi visitatori.

retrain_chatbot write

Avvia un processo completo di retraining della knowledge base. Il chatbot reindicizza tutte le fonti collegate: prodotti, documenti e contenuti personalizzati.

Guida passo passo: configurazione Claude Desktop (OAuth)

Questo è il metodo più rapido per connettersi per chi non è sviluppatore. Nessun file di configurazione, nessuna chiave API — solo un flusso OAuth.

Apri Claude Desktop e vai su Impostazioni → Integrazioni (indicato anche come "MCP Servers" in alcune versioni dell'app).
Clicca su "Aggiungi server MCP" e incolla uno dei seguenti URL:
- Accesso completo (lettura + scrittura): https://www.chaterimo.com/mcp/
- Sola lettura: https://www.chaterimo.com/mcp-readonly/
Claude Desktop apre una pagina di autorizzazione OAuth nel tuo browser. Accedi al tuo account Chaterimo e clicca su Autorizza. Claude riceve automaticamente un token di breve durata — non lo vedi né lo memorizzi.
Claude Desktop ora mostra "Chaterimo" nell'elenco degli strumenti con un indicatore verde di connessione. I 19 strumenti (o i 12 strumenti di sola lettura) sono ora disponibili.
Avvia una nuova conversazione e prova: "Elenca i miei chatbot" o "Quali sono le mie analisi degli ultimi 7 giorni?" Claude chiamerà gli strumenti MCP e restituirà una risposta formattata.

Quando usare l'endpoint di sola lettura

Usa /mcp-readonly/ se vuoi dare a Claude accesso ai tuoi dati — conversazioni, analisi, ticket — senza permettergli di modificare le impostazioni del chatbot. Questa è la scelta giusta per i membri del team o gli analisti che devono poter interrogare i dati ma non modificare la configurazione del chatbot in produzione.

Guida passo passo: configurazione Claude Code CLI

Per gli sviluppatori che usano Claude Code nel terminale, il server MCP viene eseguito come processo locale tramite trasporto stdio. Hai bisogno della tua chiave API Chaterimo dalla dashboard API Sviluppatori.

Ottieni la tua chiave API: Accedi a Chaterimo → API Sviluppatori → Chiavi API → Crea nuova chiave. La chiave inizia con cha_.

Aggiungi quanto segue al tuo .claude/settings.json (o claude_desktop_config.json per la modalità CLI di Claude Desktop):

// .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"
      }
    }
  }
}

Oppure avvia il server direttamente in una sessione di terminale per un test rapido:

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

Una volta connesso, Claude Code può chiamare qualsiasi dei 19 strumenti Chaterimo durante una sessione. Vedrai l'output delle chiamate agli strumenti direttamente in linea mentre Claude recupera i dati dal tuo account.

Mantieni la tua chiave API privata

La tua chiave cha_xxx garantisce lo stesso livello di accesso del tuo login Chaterimo per le operazioni API. Non inserirla nel controllo versione. Per ambienti condivisi o contesti di team in cui non vuoi l'accesso in scrittura, crea una chiave API di sola lettura separata dalla dashboard API Sviluppatori e usala al suo posto.

Esempi di utilizzo concreti

Ecco cinque prompt concreti per Claude che mostrano come appare l'integrazione MCP nella pratica. Ogni prompt attiva automaticamente specifici strumenti Chaterimo.

"Elenca tutti i miei chatbot e dimmi quale ha il maggior numero di conversazioni questo mese."
Claude chiama list_chatbots per ottenere gli ID dei tuoi chatbot, poi chiama get_analytics per ciascuno con un intervallo di 30 giorni. Confronta il numero di sessioni e restituisce un riepilogo classificato con il top performer evidenziato.
"Mostrami le ultime 10 conversazioni in cui un cliente ha menzionato 'reso'."
Claude chiama list_conversations per scorrere le sessioni recenti, poi chiama get_conversation sui candidati. Filtra le trascrizioni per la parola chiave e presenta estratti con timestamp e nomi dei chatbot.
"Riscrivi le istruzioni per il chatbot n. 3 in modo più conciso e amichevole."
Claude chiama get_chatbot per leggere il prompt di sistema attuale, propone una versione rivista nella conversazione per la tua revisione, poi chiama update_chatbot_instructions per applicarla dopo la tua conferma.
"Passa il mio chatbot principale a GPT-4o con temperatura 0,3."
Claude chiama list_chatbots per identificare quale chatbot è contrassegnato come principale, poi chiama update_chatbot_model con il modello di destinazione e il valore di temperatura. La modifica entra in vigore immediatamente.
"Quali sono i miei principali ticket di supporto al momento e quali pattern vedi?"
Claude chiama list_tickets filtrato per stato new e in_progress, poi chiama get_ticket per ogni elemento aperto. Raggruppa i ticket per argomento, identifica i problemi ricorrenti e riassume i problemi più comuni dei clienti in un report strutturato.

Sola lettura vs accesso completo: quale scegliere?

La scelta giusta dipende dal tuo ruolo e da quanto vuoi che Claude possa modificare. In caso di dubbio, inizia con la sola lettura e passa all'accesso completo quando ne hai bisogno.

	Sola lettura	Accesso completo
Visualizza conversazioni, analisi, lead	Sì	Sì
Leggi la configurazione del chatbot e i prodotti	Sì	Sì
Aggiorna le istruzioni del chatbot	No	Sì
Cambia modello AI o lingua	No	Sì
Modifica l'aspetto del widget	No	Sì
Avvia il retraining	No	Sì
Endpoint (OAuth)	`/mcp-readonly/`	`/mcp/`
Ideale per	Analisti, membri del team	Titolari, sviluppatori

Limiti di velocità per piano

Le chiamate agli strumenti MCP vengono conteggiate nel tuo quota API Sviluppatori. Ogni invocazione di uno strumento — sia che Claude la chiami automaticamente durante una conversazione sia che tu la attivi manualmente — conta come una chiamata API.

Piano	Chiamate al minuto	Chiamate al giorno
Gratuito	5	5
Trial	10	100
A pagamento	30	1.000

Tutte le chiamate agli strumenti vengono registrate nella tua dashboard Chaterimo sotto API Sviluppatori → Sessioni MCP. Puoi verificare quali strumenti sono stati chiamati, quando e quante chiamate rimangono nel tuo quota giornaliero.

Tutto in un unico posto

Il server MCP di Chaterimo collega Claude ai dati live del tuo chatbot — conversazioni, analisi, prodotti, ticket e configurazione — senza copiare e incollare o passare da una scheda all'altra. Che tu usi Claude Desktop con OAuth o Claude Code con una chiave API, gli stessi 19 strumenti sono disponibili per interrogare e gestire il tuo chatbot in linguaggio naturale.

Nessun copia-incolla dei log delle conversazioni in Claude
Fai domande in linguaggio naturale sulle performance del tuo chatbot
Aggiorna le istruzioni del chatbot dall'interno di una conversazione Claude
Funziona con Claude Desktop (OAuth) e Claude Code (chiave API)
Endpoint di sola lettura per la condivisione sicura con il team

Inizia Gratuitamente Documentazione API Sviluppatori