Integrazione del Server MCP

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

Che cos'è MCP?

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

• Gestire chatbot — aggiornare istruzioni, personalità e impostazioni del widget
• Creare e aggiornare FAQ usando il linguaggio naturale
• Visualizzare analitiche, cronologia delle chat e lead
• Revisionare le proposte dell'Improvement Agent e approvarle o rifiutarle
• Monitorare sessioni di chat in tempo reale e la coda di attesa

Iniziare

1. Generare una API Key

1. Andate al vostro Dashboard → Company → scheda API
2. Cliccate su Create API Key
3. Date alla chiave un nome descrittivo (es. "Claude Desktop") e selezionate almeno un permesso
4. Copiate la chiave generata (inizia con cr_)

2. Configurare il vostro client MCP

Il server MCP di ChatReact è ospitato su https://www.chatreact.ai/api/mcp e comunica tramite HTTP (JSON-RPC). Autenticatevi con un header Authorization: Bearer — è accettato anche un header X-API-Key con la stessa chiave.

Cursor IDE

Cursor supporta server MCP remoti direttamente. Aggiungete alle impostazioni MCP di Cursor:

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

Claude Desktop

Il file di configurazione di Claude Desktop supporta server basati su comandi, quindi usate il bridge standard mcp-remote per connettervi all'endpoint ospitato:

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

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

3. Riavviare il vostro Assistente AI

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

Strumenti Disponibili

ChatReact MCP fornisce un set completo di strumenti organizzati in categorie:

Il vostro Account

Gestione Company & Team

Gestione Chatbot

Gestione FAQ

Knowledge Base

Gestione Lead

Cronologia Chat

Analytics

Improvement Agent

Live Chat

Esempi di Flussi di Lavoro

Aggiungere un'Istruzione Principale

Chiedete al vostro assistente AI:

"Aggiungi un'istruzione principale al mio chatbot 'Support Bot': offriamo spedizione gratuita per ordini superiori a €50"

L'assistente utilizzerà chatbot_add_instruction con i parametri appropriati.

Revisionare Suggerimenti di Miglioramento

"Mostrami tutte le proposte di miglioramento in sospeso per il mio chatbot e spiegami quali cambiamenti suggeriscono"

L'assistente:

1. Userà improvement_proposals_pending per recuperare le proposte
2. Analizzerà e riassumerà ciascun suggerimento
3. Le approverà o le rifiuterà per vostro conto con improvement_proposal_approve o improvement_proposal_reject

Analizzare le Prestazioni delle Chat

"Forniscimi un rapporto settimanale sul volume di chat e sulla soddisfazione dei clienti per il mio chatbot"

L'assistente userà analytics_overview e analytics_chat_volume per compilare un rapporto completo.

Sicurezza

• Le API key sono limitate alla vostra company
• Le chiavi possono essere revocate in qualsiasi momento dal dashboard
• L'accesso API è disponibile nei piani a pagamento — vedere la nostra Pricing page

Risoluzione dei Problemi

Connessione Fallita

1. Verificate che la vostra API key sia corretta
2. Controllate che la chiave non sia stata revocata
3. Assicuratevi che il vostro piano includa l'accesso API
4. Riavviate il vostro client MCP

Strumento Non Trovato

Riavviate il vostro client MCP dopo aver modificato la configurazione in modo che ricarichi gli strumenti disponibili. I nomi degli strumenti sono minuscoli con underscore (es. faq_list).

Serve aiuto? Contact our support team →