MCP Servers
Collega strumenti e servizi esterni ad AI SmartTalk utilizzando il Model Context Protocol (MCP). MCP è uno standard aperto che consente al tuo assistente AI di interagire con sistemi esterni tramite un'interfaccia unificata.
Panoramica
L'integrazione del server MCP ti consente di:
- Collegare più server MCP simultaneamente
- Esporre strumenti esterni che il tuo AI può chiamare durante le conversazioni
- Autenticarti con intestazioni HTTP personalizzate (chiavi API, token, ecc.)
- Testare le connessioni prima di andare in produzione
- Estendere le funzionalità senza sviluppo personalizzato
Cos'è MCP? Il Model Context Protocol è uno standard aperto (sviluppato da Anthropic) che consente ai sistemi AI di connettersi in modo sicuro a fonti di dati e strumenti esterni. Scopri di più su modelcontextprotocol.io.
Requisiti
Prima di iniziare, assicurati di avere:
- Un account attivo di AI SmartTalk
- Accesso a uno o più server compatibili con MCP
- L'URL del server per ciascun server MCP
- Qualsiasi credenziale di autenticazione richiesta (chiavi API, token)
Come Funziona MCP
- L'utente pone una domanda che richiede dati esterni
- AI SmartTalk riconosce che ha bisogno di uno strumento MCP
- Il server MCP appropriato viene chiamato con lo strumento corretto
- La risposta viene restituita e l'AI formula una risposta in linguaggio naturale
AI SmartTalk supporta più server MCP contemporaneamente. Gli strumenti provenienti da server diversi sono automaticamente namespaced per prevenire conflitti.
Configurazione Passo-Passo
Passo 1: Accedi all'Integrazione MCP
- Accedi al tuo account AI SmartTalk
- Naviga su Amministrazione → I Miei Assistenti → [Nome del Tuo Assistente]
- Clicca su Connettori nella barra laterale sinistra
- Trova MCP Servers e cliccaci sopra
Passo 2: Aggiungi un Server MCP
Clicca su Aggiungi Server per aprire il modulo di configurazione del server. Compila i seguenti campi:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Nome del Server | Sì | Un nome amichevole per identificare questo server (es. "CRM Aziendale", "Wiki Interno") |
| URL del Server | Sì | L'URL dell'endpoint del server MCP (es. https://mcp.example.com) |
| Intestazioni HTTP | No | Intestazioni personalizzate per autenticazione o altri requisiti |
AI SmartTalk aggiunge automaticamente /mcp al tuo URL se non termina già con esso. Ad esempio, https://example.com diventa https://example.com/mcp. Se il tuo server utilizza un percorso di endpoint diverso, includilo nell'URL (es. https://example.com/api/mcp).
Passo 3: Aggiungi Intestazioni di Autenticazione (Opzionale)
Se il tuo server MCP richiede autenticazione, clicca su Aggiungi Intestazioni per configurare intestazioni HTTP personalizzate:
| Intestazione Comune | Caso d'Uso |
|---|---|
Authorization | Token Bearer (es. Bearer sk-xxx...) |
X-API-Key | Autenticazione con chiave API |
X-Auth-Token | Autenticazione con token personalizzato |
Per ogni intestazione, fornisci:
- Chiave: Il nome dell'intestazione (seleziona tra le intestazioni comuni o digita una personalizzata)
- Valore: Il valore dell'intestazione (i valori sensibili sono automaticamente mascherati nell'interfaccia)
Puoi aggiungere più intestazioni per server. Le intestazioni contenenti "secret", "password", "token" o "auth" nel nome della chiave sono automaticamente nascoste per motivi di sicurezza.
Passo 4: Testa la Connessione
Prima di salvare, clicca su Testa Connessione per verificare che il tuo server sia raggiungibile:
- AI SmartTalk invia una richiesta di inizializzazione JSON-RPC al tuo server
- Il test controlla più endpoint in ordine:
/mcp,/health, poi l'URL di base - I risultati mostrano lo stato della connessione, il tempo di risposta e le informazioni sul server
| Risultato del Test | Significato |
|---|---|
| Connesso | Il server ha risposto con successo con il protocollo MCP |
| Autenticazione fallita | Controlla la tua chiave API o token nelle intestazioni |
| Server non trovato | Verifica che l'URL sia corretto |
| Connessione rifiutata | Il server potrebbe essere inattivo o il firewall blocca l'accesso |
| Timeout | Il server ha impiegato troppo tempo a rispondere (limite di 10s) |
| Errore SSL | Controlla che il server abbia un certificato SSL valido |
Passo 5: Salva la Configurazione
- Clicca su Aggiungi per aggiungere il server alla tua lista
- Ripeti i Passi 2-4 per aggiungere altri server MCP se necessario
- Clicca su Salva Integrazione per attivare tutti i server configurati
Supporto Multi-Server
AI SmartTalk supporta la connessione a più server MCP simultaneamente. Questo ti consente di combinare strumenti provenienti da diverse fonti:
Namespacing degli Strumenti
Gli strumenti di ciascun server sono automaticamente prefissati con il nome del server per prevenire conflitti di denominazione. Ad esempio:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Questo significa che puoi connettere in sicurezza server che espongono strumenti con lo stesso nome.
Gestione di Più Server
Il cruscotto di integrazione mostra tutti i server configurati con:
- Nome del server e URL per una facile identificazione
- Badge conteggio intestazioni se sono state configurate intestazioni personalizzate
- Indicatore di stato (Configurato / Incompleto)
- Pulsanti di azione: Testa connessione, Modifica o Elimina server singoli
Scoperta degli Strumenti
Una volta che i tuoi server MCP sono connessi, AI SmartTalk scopre automaticamente tutti gli strumenti disponibili esposti da ciascun server. Questi strumenti diventano immediatamente disponibili per il tuo assistente AI.
L'assistente AI:
- Vede l'elenco di tutti gli strumenti disponibili da tutti i server connessi
- Seleziona automaticamente lo strumento giusto in base alle query degli utenti
- Chiama lo strumento con i parametri appropriati
- Elabora la risposta e fornisce una risposta in linguaggio naturale
Non è necessario configurare o abilitare manualmente strumenti individuali. Tutti gli strumenti esposti da un server MCP connesso sono automaticamente disponibili per il tuo assistente AI.
Casi d'Uso
Gestione delle Relazioni con i Clienti
Collega il tuo CRM tramite MCP:
- "Cerca il cliente John Smith"
- "Qual è lo stato dell'account #12345?"
- "Quanti ticket di supporto aperti abbiamo?"
Strumenti Interni
Accedi ai sistemi aziendali:
- "Controlla l'inventario per il prodotto SKU-123"
- "Cosa c'è in programma per domani?"
- "Cerca nel nostro wiki interno i documenti di onboarding"
Fonti di Dati Esterni
Recupera dati in tempo reale:
- "Qual è il meteo attuale a Parigi?"
- "Ottieni l'ultimo prezzo delle azioni per AAPL"
- "Controlla lo stato del volo per UA123"
Strumenti di Sviluppo
Per i team tecnici:
- "Qual è lo stato dell'ultimo build?"
- "Cerca i nostri problemi su GitHub per bug di autenticazione"
- "Controlla la salute dei server di produzione"
Esempi di Server MCP
Server MCP Popolari
| Server | Scopo | Link |
|---|---|---|
| Filesystem | Leggere/scrivere file locali | Server di riferimento integrato |
| PostgreSQL | Interrogare database | Server della comunità |
| GitHub | Gestione dei repository | Server della comunità |
| Slack | Integrazione della messaggistica | Server della comunità |
| Google Drive | Gestione dei file | Server della comunità |
| Brave Search | Ricerca web | Server della comunità |
Trova di più: Visita il Registro dei Server MCP per un elenco in crescita di server MCP della comunità.
Server MCP Self-Hosting
Puoi creare server MCP personalizzati per:
- Sistemi interni proprietari
- Logica aziendale personalizzata
- Accesso a dati sicuri o privati
Utilizza qualsiasi SDK MCP (TypeScript, Python) per costruire il tuo server.
Considerazioni sulla Sicurezza
Autenticazione
Configura l'autenticazione tramite HTTP Headers nella configurazione del server:
| Metodo | Esempio di Header |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Privacy dei Dati
- Le richieste MCP possono contenere dati di conversazione degli utenti
- Assicurati che il tuo server MCP gestisca i dati secondo le tue politiche sulla privacy
- Considera i requisiti di residenza dei dati
- AI SmartTalk maschera i valori sensibili degli header nell'interfaccia utente
Sicurezza della Rete
- Utilizza HTTPS per tutte le connessioni MCP
- Limita l'accesso al server MCP a IP fidati
- Implementa il rate limiting sul tuo server MCP
- Assicurati che siano presenti certificati SSL validi
Risoluzione dei Problemi
Problemi di Connessione
| Problema | Soluzione |
|---|---|
| "Connessione rifiutata" | Controlla l'URL e la porta del server. Assicurati che il server sia in esecuzione |
| "Autenticazione fallita" (401) | Verifica la tua API key o token nella configurazione degli header |
| "Vietato" (403) | Controlla che le tue credenziali abbiano i permessi richiesti |
| "Server non trovato" (404) | Verifica l'URL. AI SmartTalk aggiunge automaticamente /mcp |
| "Timeout" | Controlla la connettività di rete e le regole del firewall. Il test ha un timeout di 10 secondi |
| "Errore SSL" | Assicurati che il tuo server MCP abbia un certificato SSL valido |
| "Limitato nel numero di richieste" (429) | Troppe richieste. Aspetta e riprova, oppure aumenta i limiti del server |
Problemi con gli Strumenti
| Problema | Soluzione |
|---|---|
| Strumenti non visibili | Verifica che il server MCP esponga correttamente gli strumenti. Prova a ricaricare |
| Strumenti errati chiamati | Controlla che i nomi dei server siano descrittivi per aiutare l'AI a scegliere correttamente |
| Chiamata allo strumento fallita | Controlla i log del server per errori. Assicurati che lo strumento restituisca il formato previsto |
Errori Comuni
- Dimenticare
/mcp: AI SmartTalk lo aggiunge automaticamente, ma se il tuo endpoint è diverso, includi il percorso completo - Formato header errato: Assicurati che gli header di autenticazione corrispondano a ciò che il tuo server si aspetta
- Nomi di server duplicati: Ogni server deve avere un nome unico
Gestione dei Server MCP
| Azione | Come |
|---|---|
| Aggiungi server | Clicca su "Aggiungi Server", compila i dettagli, testa e salva |
| Modifica server | Clicca sull'icona di modifica sulla scheda del server |
| Testa connessione | Clicca sull'icona di test sulla scheda del server |
| Elimina server | Clicca sull'icona di eliminazione sulla scheda del server |
| Salva modifiche | Clicca su "Salva Integrazione" per mantenere tutte le modifiche |
Migliori Pratiche
- Usa nomi di server descrittivi: Aiuta l'AI a capire quale server interrogare (ad esempio, "CRM Aziendale" piuttosto che "Server 1")
- Testa prima di salvare: Testa sempre le connessioni per rilevare problemi di configurazione in anticipo
- Inizia con un server: Familiarizza con un'integrazione prima di aggiungerne altre
- Proteggi le tue credenziali: Usa API key dedicate per AI SmartTalk, non token personali
- Monitora i tuoi server: Tieni traccia di quali strumenti vengono chiamati e delle loro prestazioni
- Mantieni i server aggiornati: Assicurati che i tuoi server MCP seguano l'ultima specifica del protocollo