MCP Server Integration

ChatReact implementa il Model Context Protocol (MCP), permettendo di collegare il suo account ChatReact ad assistenti AI come Claude Desktop, Cursor e altri strumenti compatibili con MCP.

Cos'è MCP?

Il Model Context Protocol è uno standard aperto che consente agli assistenti AI di interagire con servizi esterni e sorgenti dati. Con l'integrazione MCP di ChatReact, Lei può:

Gestire i chatbot direttamente dal suo assistente AI
Creare e aggiornare le FAQ usando il linguaggio naturale
Visualizzare le analytics e la cronologia delle chat
Controllare l'Improvement Agent per l'ottimizzazione del chatbot
Gestire sessioni di live chat senza uscire dal suo strumento AI

Per iniziare

1. Generare una API Key

Acceda al suo Dashboard → Settings → API Keys
Clicchi su Create API Key
Dia al suo key un nome descrittivo (es. "Claude Desktop")
Copi la chiave generata (inizia con cr_)

Conservi la sua API key in modo sicuro. Non può essere recuperata dopo la creazione.

2. Configurare il suo client MCP

Claude Desktop

Aggiunga quanto segue al file di configurazione di Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Aggiunga alle sue impostazioni Cursor MCP:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Sviluppo locale (stdio)

Per lo sviluppo locale, può utilizzare il nostro pacchetto npm:

npm install -g @chatreact/mcp

Configuri nel suo client MCP:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Riavvia il tuo Assistente AI

Dopo aver salvato la configurazione, riavvii Claude Desktop o Cursor per stabilire la connessione.

Strumenti Disponibili

ChatReact MCP fornisce oltre 30 strumenti organizzati per categorie:

Company & Team Management

Tool	Description
`company_list`	Elenca tutte le aziende a cui Lei ha accesso
`company_get`	Ottiene i dettagli di una specifica azienda
`company_team_list`	Elenca i membri del team di un'azienda

Chatbot Management

Tool	Description
`chatbot_list`	Elenca tutti i chatbot in un'azienda
`chatbot_get`	Ottiene i dettagli e la configurazione di un chatbot
`chatbot_create`	Crea un nuovo chatbot
`chatbot_update`	Aggiorna le impostazioni del chatbot
`chatbot_get_instructions`	Recupera le istruzioni principali per un chatbot
`chatbot_add_instruction`	Aggiunge una nuova istruzione principale

FAQ Management

Tool	Description
`faq_list`	Elenca tutte le FAQ di un chatbot
`faq_get`	Ottiene i dettagli di una FAQ
`faq_create`	Crea una nuova FAQ
`faq_update`	Aggiorna una FAQ esistente
`faq_delete`	Elimina una FAQ
`faq_categories_list`	Elenca le categorie delle FAQ
`faq_suggest`	Genera FAQ suggerite dall'AI

Knowledge Base

Tool	Description
`knowledge_list_documents`	Elenca i documenti caricati
`knowledge_list_websites`	Elenca i siti web indicizzati
`knowledge_crawl_website`	Avvia la scansione di un sito web
`knowledge_get_crawl_status`	Controlla lo stato di avanzamento della scansione

Analytics

Tool	Description
`analytics_overview`	Ottiene metriche di rendimento complessive
`analytics_chat_volume`	Ottiene il volume di chat nel tempo
`analytics_feedback`	Ottiene feedback e valutazioni
`analytics_chat_history`	Esamina le sessioni di chat
`analytics_get_session`	Ottiene i dati dettagliati di una sessione

Improvement Agent

Tool	Description
`improvement_list_sessions`	Elenca le sessioni di miglioramento
`improvement_start_session`	Avvia una nuova sessione di analisi
`improvement_list_proposals`	Elenca le proposte di miglioramento
`improvement_get_proposal`	Ottiene i dettagli di una proposta
`improvement_create_proposal`	Crea una proposta personalizzata
`improvement_simulate_proposal`	Anteprima degli effetti di una proposta
`improvement_apply_proposal`	Applica una proposta
`improvement_reject_proposal`	Rifiuta una proposta

Live Chat

Tool	Description
`livechat_get_queue`	Ottiene le sessioni di chat in attesa
`livechat_get_active_sessions`	Elenca le sessioni attive con agenti umani
`livechat_get_session`	Ottiene i dettagli di una sessione
`livechat_assign_session`	Si assegna a una sessione
`livechat_send_message`	Invia un messaggio come agente
`livechat_close_session`	Chiude una sessione di chat
`livechat_check_availability`	Controlla la disponibilità degli agenti

Esempi di Flussi di Lavoro

Creazione di un Nuovo Chatbot

Chieda al suo assistente AI:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

L'assistente utilizzerà chatbot_create con i parametri appropriati.

Revisione dei Suggerimenti di Miglioramento

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

L'assistente:

Utilizzerà improvement_list_proposals per recuperare le proposte
Analizzerà e riassumerà ogni suggerimento
La aiuterà a decidere quali applicare

Analisi delle Prestazioni delle Chat

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

L'assistente utilizzerà analytics_overview e analytics_feedback per compilare un report completo.

Sicurezza

Le API key sono limitate al suo account utente e all'accesso aziendale
Tutte le richieste sono registrate nel registro di audit
Le chiavi possono essere revocate in qualsiasi momento dalla dashboard
Si applicano limiti di velocità: 60 richieste/minuto

Risoluzione dei Problemi

Connessione Fallita

Verifichi che la sua API key sia corretta
Controlli che la chiave non sia stata revocata
Assicuri di avere una connessione internet attiva
Riavvii il suo client MCP

Strumento Non Trovato

Alcuni strumenti richiedono autorizzazioni specifiche. Assicuri di avere il ruolo appropriato nell'azienda (Owner, Admin o Manager).

Rate Limited

Se visualizza errori di limite di velocità, attenda un minuto prima di riprovare. Consideri di raggruppare le operazioni quando possibile.

Need help? Contact our support team →