Guida · Server MCP per Claude

Server MCP di Chaterimo: collega Claude al tuo chatbot IA

Aggiungi Chaterimo a Claude come connettore personalizzato: leggi conversazioni, ticket e analisi o modifica il chatbot. Un URL e un accesso OAuth.

· Fondatore di Chaterimo Pubblicato Aggiornato 9 min di lettura Čeština, Deutsch, English, Español, Português, Română, Slovenčina
MCP · OAuth · /mcp-readonly · /mcp

In breve

  1. 01Il server MCP di Chaterimo permette a Claude di leggere i tuoi dati Chaterimo (conversazioni, analisi, prodotti, ticket, lead, regole di vendita e voci di testo della base di conoscenza) e, con l'accesso completo, di modificare le impostazioni del chatbot.
  2. 02Lo aggiungi in Claude come connettore personalizzato con un URL e accedi con il tuo account Chaterimo (OAuth); non servono codice né chiavi API.
  3. 03L'URL di sola lettura (https://www.chaterimo.com/mcp-readonly) dà a Claude 14 strumenti che leggono soltanto; l'URL con accesso completo (https://www.chaterimo.com/mcp) aggiunge 10 strumenti che modificano il chatbot attivo.
  4. 04Le chiamate sono limitate per organizzazione: 5 al giorno senza piano, 100 al giorno nella prova e 1.000 al giorno con un piano a pagamento.
  5. 05Claude Code può usare gli stessi URL come server MCP remoto; i client senza OAuth usano un URL con token dalla pagina API sviluppatore.

Cosa ti serve

  • Un account Chaterimo. Ogni piano e la prova gratuita possono usare il server MCP; il limite giornaliero dipende dal piano.
  • Un account Claude. I connettori personalizzati funzionano con i piani Free, Pro, Max, Team ed Enterprise; Free consente un solo connettore personalizzato.
  • Con Claude Team o Enterprise: prima un proprietario dell'organizzazione Claude aggiunge il connettore.
Indice 8
  1. Cosa può leggere e modificare Claude
  2. Passaggi
  3. Claude Code e altri client MCP
  4. Limiti
  5. Come verificare che funzioni
  6. Risoluzione dei problemi
  7. Passo successivo
  8. Domande frequenti

Il server MCP di Chaterimo collega Claude al tuo account Chaterimo. Claude può poi leggere le conversazioni, le analisi, i prodotti, i ticket e i lead del tuo chatbot e, con l'accesso completo, modificare le impostazioni del chatbot, tutto da una chat di Claude. Lo aggiungi in Claude come connettore personalizzato con un URL e accedi con il tuo account Chaterimo; non serve scrivere codice. MCP (Model Context Protocol) è uno standard open source che permette ad applicazioni di IA come Claude di collegarsi a strumenti e dati di altri sistemi.1

Cosa può leggere e modificare Claude

Chaterimo offre due URL per il connettore. Entrambi mostrano a Claude solo i dati dell'organizzazione che scegli quando accedi.

Accesso URL Strumenti Cosa può fare Claude
Sola lettura https://www.chaterimo.com/mcp-readonly 14 Legge i dati; non modifica nulla
Accesso completo https://www.chaterimo.com/mcp 24 Legge i dati e modifica il chatbot

Gli strumenti per area (uno strumento è un'azione che Claude può richiamare):

Area Strumenti di lettura (entrambi gli URL) Strumenti di scrittura (solo accesso completo)
Chatbot list_chatbots, get_chatbot update_chatbot_instructions, update_chatbot_model, update_chatbot_language, update_chatbot_settings
Finestra della chat in get_chatbot update_widget_appearance, update_widget_messages
Conversazioni list_conversations, get_conversation nessuno
Prodotti search_products, list_products nessuno
Ticket list_tickets, get_ticket nessuno
Lead list_leads nessuno
Analisi get_analytics, get_dashboard nessuno
Regole di vendita list_sales_rules nessuno
Base di conoscenza (voci di testo) list_knowledge_base_entries, get_knowledge_base_entry create_knowledge_base_entry, update_knowledge_base_entry, delete_knowledge_base_entry, retrain_chatbot

Gli strumenti di scrittura modificano direttamente il chatbot attivo; non esiste una bozza. Una voce di testo nuova o modificata arriva al chatbot dopo retrain_chatbot o dopo l'addestramento notturno. Gli strumenti della base di conoscenza vedono solo le voci inserite come testo (Base di conoscenza → Importa dati → Inserimento testo). Le pagine importate con lo scraping, i file caricati e i feed prodotti restano fuori dalla loro portata. Le conversazioni di prova di Testa chatbot sono escluse dagli strumenti delle conversazioni.

Passaggi

1Scegli sola lettura o accesso completo

Inizia con l'URL di sola lettura. Basta per riepiloghi delle conversazioni recenti, ticket aperti, nuovi lead e analisi. Usa l'URL con accesso completo solo quando vuoi che Claude riscriva le istruzioni del chatbot, cambi il suo modello di IA, modifichi la finestra della chat o le voci di testo della base di conoscenza. Con un piano Claude a pagamento puoi aggiungere entrambi, come due connettori con nomi diversi.

2Copia l'URL del connettore da Chaterimo

In Chaterimo, apri API sviluppatore nel menu (sotto Account). Espandi Connettore MCP per Claude Desktop / Cowork. Sotto Copia questo URL:, copia l'URL di sola lettura. Per l'accesso completo, apri Serve l'accesso in scrittura? Usa l'URL con accesso completo e copia quell'URL.

3Aggiungi un connettore personalizzato in Claude

In Claude sul web o nell'app desktop di Claude, apri Customize → Connectors, seleziona + Add e poi Add custom connector.2 Inserisci Chaterimo come nome, incolla l'URL e seleziona Continue. Claude rileva che Chaterimo richiede l'accesso; mantieni le impostazioni rilevate, seleziona Continue e poi Add.

Con Claude Team ed Enterprise, un proprietario aggiunge il connettore per tutta l'organizzazione in Organization settings → Connectors (Add → Custom → Web). Ogni membro seleziona poi Connect accanto al connettore in Customize → Connectors.2

4Accedi e autorizza l'accesso

Claude apre Chaterimo nel tuo browser. Accedi con il tuo account Chaterimo. La pagina Autorizza connettore mostra il tipo di connettore (MCP in sola lettura o MCP con accesso completo) e l'Accesso richiesto. Se sei proprietario di più organizzazioni, scegline una in Organizzazione; il connettore vede solo quell'organizzazione. Seleziona Autorizza connettore.

Claude riceve poi un token di accesso. Non lo vedi e non lo copi mai. Il token vale un'ora, e Claude lo rinnova in background per un massimo di 30 giorni; dopo devi accedere di nuovo.

5Attiva il connettore in una chat e fai le tue domande

In una chat di Claude, seleziona + in basso a sinistra, poi Connectors, e attiva Chaterimo per la conversazione.2 Poi chiedi con parole semplici, per esempio:

  • «Mostrami le ultime 5 conversazioni di Chaterimo.»
  • «Come sta andando il mio chatbot questa settimana?»
  • «Ci sono ticket di assistenza aperti?»
  • «Elenca i lead raccolti questa settimana.»
  • «Riassumi le domande sulla consegna degli ultimi 7 giorni e dimmi cosa manca nella mia base di conoscenza.»

Claude sceglie da solo gli strumenti. Una domanda può richiedere più chiamate agli strumenti, per esempio un elenco di conversazioni e poi ogni singola conversazione.

Claude Code e altri client MCP

Claude Code aggiunge un server MCP remoto con un solo comando e accede con il comando /mcp.3

bash claude mcp add --transport http chaterimo https://www.chaterimo.com/mcp-readonly

Poi esegui /mcp in Claude Code, scegli Chaterimo e completa l'accesso nel browser come nel passaggio 4. Chaterimo registra automaticamente Claude Code come client OAuth, quindi non ti servono un client ID né un secret.3

I client MCP senza OAuth usano invece un URL con token. Crea una chiave in API sviluppatore → Crea chiave API, spunta gli Ambiti che il client può usare e seleziona Crea chiave. La sezione URL legacy con token — per client senza supporto OAuth mostra poi un URL di sola lettura e un URL con accesso completo per la chiave. Gli strumenti di un URL con token seguono gli ambiti della sua chiave.

Attenzione

Un URL con token funziona senza login, quindi chiunque lo abbia può leggere i tuoi dati. Trattalo come una password: non condividerlo mai e non salvarlo mai in un repository (in Claude Code, non aggiungerlo con --scope project, che lo scrive nel file condiviso .mcp.json). Se un URL finisce in mani sbagliate, seleziona Revoca accanto alla sua chiave nella pagina API sviluppatore.

Limiti

Ogni chiamata a uno strumento conta come una chiamata. I limiti valgono per organizzazione e sono condivisi da tutti i suoi connettori e chiavi API (pagina MCP di Chaterimo, ottobre 2026):

Piano Chiamate al minuto Chiamate al giorno
Nessun piano attivo 5 5
Prova gratuita 10 100
Piano a pagamento 30 1.000

Il conteggio giornaliero riparte a mezzanotte, ora di Praga. Il tuo utilizzo attuale è in API sviluppatore → Utilizzo MCP & Limiti (Utilizzato oggi).

Come verificare che funzioni

  1. In una nuova chat di Claude con il connettore attivo, chiedi «Elenca i miei chatbot.» Claude richiama list_chatbots e risponde con i nomi dei tuoi chatbot.
  2. In Chaterimo, apri API sviluppatore. Utilizzato oggi in Utilizzo MCP & Limiti è cresciuto del numero di chiamate.
  3. Con un connettore di sola lettura, chiedi a Claude di cambiare il messaggio di benvenuto. Non può farlo: il connettore di sola lettura non offre strumenti di scrittura.

Risoluzione dei problemi

Claude mostra «Couldn't connect»
Rimuovi il connettore in Claude e aggiungilo di nuovo. Se non funziona ancora, aggiungilo un'altra volta e, in OAuth client, scegli Use your own OAuth client. Scrivi un testo qualsiasi come client ID, per esempio chaterimo, lascia vuoto il secret e accedi come al solito. Se la tua finestra di dialogo mostra invece Advanced settings, inserisci lì il client ID.4
«Limite MCP giornaliero raggiunto per questa organizzazione.»
L'organizzazione ha usato le chiamate di oggi. Aspetta la mezzanotte, ora di Praga, oppure scegli un piano nella pagina dei prezzi per un limite più alto.
«Limite MCP al minuto raggiunto per questa organizzazione.»
Troppe chiamate in un minuto. Aspetta un minuto e chiedi di nuovo.
«Questo connettore è di sola lettura e non espone strumenti di scrittura.»
Hai collegato l'URL di sola lettura. Aggiungi un secondo connettore con l'URL con accesso completo se Claude deve modificare il chatbot.
Claude non vede gli strumenti della base di conoscenza
Il connettore è stato aggiunto prima che esistessero gli strumenti della base di conoscenza. Rimuovilo, aggiungilo di nuovo e approva l'accesso alla base di conoscenza nella pagina Autorizza connettore.
Claude mostra i dati di un'altra organizzazione
Il connettore appartiene all'organizzazione che hai scelto quando hai effettuato l'accesso. Rimuovilo, aggiungilo di nuovo e scegli l'organizzazione giusta.
«Invalid or revoked MCP token»
La chiave dell'URL con token è stata revocata. Crea una nuova chiave e usa il suo URL.

Passo successivo

Chiedi a Claude di leggere le conversazioni della settimana scorsa ed elencare le domande a cui il tuo chatbot non ha saputo rispondere bene. Aggiungi i fatti mancanti alla base di conoscenza, poi confronta i modelli sulle stesse domande con la nostra guida alla scelta di un LLM per l'assistenza clienti. La nostra ricerca sull'assistenza clienti con IA nell'e-commerce mostra cosa chiedono gli acquirenti e quando.

  1. Model Context Protocol, «What is the Model Context Protocol (MCP)?», consultato il 19 ottobre 2026, https://modelcontextprotocol.io/docs/getting-started/intro ↑

  2. Anthropic, «Get started with custom connectors using remote MCP», consultato il 19 ottobre 2026, https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp ↑↑↑

  3. Anthropic, «Connect Claude Code to tools via MCP», consultato il 19 ottobre 2026, https://code.claude.com/docs/en/mcp ↑↑

  4. Anthropic, «Add a connector that isn't in the directory», consultato il 20 ottobre 2026, https://claude.com/docs/connectors/custom/add-unlisted ↑

ArgomentiIntegrazioni e APIAssistenza clienti con IA

Domande frequenti

Quali piani Chaterimo possono usare il server MCP?

Tutti i piani, anche la prova gratuita. Il piano stabilisce il limite, che è di 100 chiamate al giorno nella prova e di 1.000 al giorno con un piano a pagamento.

Claude può modificare il mio chatbot tramite MCP?

Solo tramite l'URL con accesso completo. Allora può riscrivere le istruzioni, cambiare il modello di IA e la lingua, modificare la finestra della chat e i suoi testi, modificare le voci di testo della base di conoscenza e avviare un nuovo addestramento. L'URL di sola lettura non può modificare nulla.

Claude vede gli indirizzi e-mail dei miei clienti?

Sì, dove Chaterimo li conserva. Lead e ticket includono i dati di contatto, e le conversazioni contengono ciò che i clienti hanno scritto. Claude tratta questi dati secondo le condizioni del tuo account Claude, quindi collega un account Claude che la tua azienda approva per i dati dei clienti.

Cosa registra Chaterimo delle chiamate?

Per ogni chiamata, il nome dello strumento, l'ora, la durata, se non è andata a buon fine, i nomi e le dimensioni dei suoi argomenti e la dimensione della risposta; per ogni giorno, l'indirizzo IP e il client della connessione. Chaterimo non conserva i contenuti che Claude legge o invia.

Mi serve una chiave API di Chaterimo per Claude?

No. Claude accede con il tuo account Chaterimo (OAuth). Le chiavi API e gli URL con token servono solo ai client senza supporto OAuth.

Vedi tutti

Guida · Primo chatbot IA

Per iniziare: il tuo primo chatbot IA in 4 passaggi

Registrati, collega il negozio o aggiungi i contenuti, scegli il modello di IA e metti la finestra della chat sul sito. Guida per negozi online.

Aggiornato 9 min di lettura

Guida · Chiave API Anthropic

Anthropic Console: chiave API Claude per Chaterimo

Registrati nell'Anthropic Console (ora Claude Console), acquista crediti, crea una chiave API Claude e collegala a Chaterimo come chiave propria (BYOK).

Aggiornato 10 min di lettura

Modifiche

  1. Riscritta per le attuali impostazioni dei connettori di Claude e i 24 strumenti del server, e spostata nel nuovo blog.
  2. Pubblicata.
chaterimo logo

Copyright © Chaterimo

about-icon