Collegare AI SmartTalk a qualsiasi client MCP
AI SmartTalk espone un server MCP ospitato, in modo da poter gestire i tuoi assistenti da qualsiasi strumento AI che parla il Model Context Protocol (MCP) — non solo Claude. Claude Desktop, Claude sul web, Claude Code, ChatGPT, Cursor, VS Code (GitHub Copilot), Cline, Windsurf e qualsiasi client MCP personalizzato funzionano tutti allo stesso modo.
Rimani all'interno dello strumento AI che già utilizzi e chiedi, in linguaggio semplice, di elencare gli assistenti, leggere o riscrivere le loro istruzioni, cercare e ampliare la loro base di conoscenza e diagnosticare la configurazione di un cliente. Non c'è nulla da installare e nessuna chiave API da copiare — accedi una volta con il tuo solito account AI SmartTalk tramite un flusso OAuth sicuro.
Questa è la direzione opposta del connettore MCP Servers. Lì, il tuo assistente chiama strumenti esterni. Qui, uno strumento AI esterno chiama i tuoi assistenti AI SmartTalk.
Come funziona
Il client MCP si connette a un singolo endpoint sicuro, approvi l'accesso con il tuo login AI SmartTalk e lo strumento AI può quindi chiamare gli strumenti AI SmartTalk per tuo conto. Ogni azione è limitata al tuo account — puoi vedere e agire solo sugli assistenti che sei già autorizzato a gestire nel tuo dashboard.
L'endpoint unico
Ogni client MCP si connette allo stesso indirizzo:
https://aismarttalk.tech/api/mcp
- Trasporto: HTTP streamabile (JSON-RPC 2.0)
- Autenticazione: OAuth 2.0 — accedi con il tuo account AI SmartTalk; nessuna chiave API da gestire
- Sicurezza: Solo HTTPS; accesso limitato agli assistenti gestiti dal tuo account; revocabile in qualsiasi momento
Cosa puoi fare
Una volta connesso, il tuo strumento AI può utilizzare automaticamente queste capacità di AI SmartTalk, scegliendo quella giusta in base a ciò che chiedi:
| Azione | Cosa fa |
|---|---|
| Elenca assistenti | Elenca ogni assistente che il tuo account può gestire |
| Trova assistenti | Localizza un assistente per nome, per email di un utente o per organizzazione |
| Leggi istruzioni | Leggi la biografia di un assistente — la sua personalità e le regole decisionali |
| Aggiorna istruzioni | Riscrivi le istruzioni e la logica di instradamento di un assistente |
| Cerca conoscenza | Esegui una ricerca in linguaggio naturale nella base di conoscenza di un assistente |
| Esplora conoscenza | Esplora la base di conoscenza in modo interattivo in un visualizzatore integrato |
| Aggiungi un documento | Inserisci un nuovo documento di conoscenza, indicizzato automaticamente |
| Aggiungi voci FAQ | Aggiungi una o più coppie domanda/risposta contemporaneamente |
| Esegui diagnosi | Ispeziona il piano di un assistente, modello AI, dimensione della conoscenza e canali connessi |
| Elenca canali e integrazioni | Vedi a quali canali e connettori è collegato un assistente |
| Rinomina un assistente | Cambia il nome visualizzato di un assistente |
Include anche prompt pronti all'uso che il tuo client può visualizzare direttamente — ad esempio "migliora la biografia di questo assistente" e "audita la copertura della conoscenza per un argomento".
Puoi sempre riferirti a un assistente per il suo nome — non è necessario cercare un ID.
Casi d'uso
Team di supporto — risolvi l'assistente di un cliente senza lasciare il tuo strumento AI
"Un cliente con l'email [email protected] ha segnalato che il suo bot fornisce risposte errate sui rimborsi. Trova il suo assistente, controlla come è configurato e cerca nella sua base di conoscenza la politica di rimborso."
Lo strumento AI trova l'assistente per email, esegue diagnosi (piano, modello, canali, dimensione della conoscenza) e visualizza la conoscenza pertinente — così puoi gestire un ticket in pochi secondi.
Agenzie — gestisci molti assistenti di clienti da un unico posto
"Elenca tutti gli assistenti nell'organizzazione Acme e dimmi quali hanno meno di 10 documenti di conoscenza."
Perfetto quando gestisci dozzine di assistenti tra i clienti: enumerali, individua quelli che necessitano attenzione e agisci — tutto da Claude o Cursor.
Operazioni di contenuto e conoscenza — mantieni la base di conoscenza aggiornata
"Aggiungi una FAQ al mio assistente di Supporto: 'Quanto tempo ci vogliono per i rimborsi?' — 'I rimborsi arrivano entro 5 giorni lavorativi.'" "Audita la copertura della conoscenza del mio assistente di Vendite per 'prezzi aziendali' e dimmi cosa manca."
Espandi e audita la base di conoscenza in modo conversazionale, e lascia che lo strumento AI rediga i documenti o le voci FAQ per te prima di indicizzarli.
Ingegneria dei prompt — affina le istruzioni in un ciclo
"Leggi le istruzioni del mio assistente di Supporto, poi riscrivile per rispondere in un tono amichevole e conciso e sempre inoltrare le domande di fatturazione a un umano."
Itera sulla personalità e le regole di instradamento di un assistente con lo strumento AI che svolge il lavoro pesante, e vedi le modifiche apparire nel tuo dashboard AI SmartTalk istantaneamente.
Sviluppatori — gestisci gli assistenti dal tuo IDE
Da Cursor o VS Code: "Avvia un nuovo set di FAQ per l'assistente di Onboarding da questo README."
Gestisci gli assistenti accanto al tuo codice, senza dover passare al dashboard o collegarti all'API REST.
Prima di iniziare
- Un account AI SmartTalk attivo
- Uno strumento AI che supporta i connettori MCP (vedi l'elenco qui sotto)
Nessuna chiave API, nessuna configurazione tecnica — accedi con il tuo solito account AI SmartTalk.
Collega il tuo strumento AI
Claude (Desktop o web)
-
Apri le Impostazioni di Claude → Connettori.
-
Scegli Aggiungi connettore personalizzato.
-
Inserisci l'indirizzo AI SmartTalk MCP:
https://aismarttalk.tech/api/mcp -
Conferma. Claude apre una pagina di accesso di AI SmartTalk.
-
Accedi e approva l'accesso. Claude è ora connesso ai tuoi assistenti.
Claude Code
Nel tuo terminale:
claude mcp add --transport http aismarttalk https://aismarttalk.tech/api/mcp
Poi avvia Claude Code, esegui /mcp e segui il link di accesso nel tuo browser per approvare l'accesso.
Cursor
-
Apri Impostazioni Cursor → MCP → Aggiungi nuovo server MCP.
-
Aggiungi il server AI SmartTalk:
{
"mcpServers": {
"aismarttalk": {
"url": "https://aismarttalk.tech/api/mcp"
}
}
} -
Cursor apre la pagina di accesso di AI SmartTalk — approva l'accesso.
VS Code (GitHub Copilot)
-
Esegui MCP: Aggiungi Server dal Command Palette, oppure aggiungi il server al tuo
.vscode/mcp.json:{
"servers": {
"aismarttalk": {
"type": "http",
"url": "https://aismarttalk.tech/api/mcp"
}
}
} -
Avvia il server dalla vista MCP e completa l'accesso nel tuo browser.
Cline, Windsurf e altri client
Qualsiasi client che supporta un server MCP remoto (HTTP) con OAuth funziona allo stesso modo. Aggiungi un server con:
- Nome:
aismarttalk - Trasporto / tipo:
http(Streamable HTTP) - URL:
https://aismarttalk.tech/api/mcp
Quando il client chiama per la prima volta il server, aprirà la pagina di accesso di AI SmartTalk in modo da poter approvare l'accesso.
Client MCP personalizzato / proprio
Il server implementa il trasporto standard MCP Streamable HTTP e funge da server di risorse OAuth 2.0. Punta il tuo client a https://aismarttalk.tech/api/mcp; una richiesta non autenticata restituisce 401 con un'intestazione WWW-Authenticate che punta ai nostri metadati di risorsa protetta, in modo che un client MCP conforme possa eseguire automaticamente il flusso OAuth.
Provalo
Chiedi al tuo strumento AI cose come:
- "Elenca i miei assistenti AI SmartTalk."
- "Mostrami le istruzioni per il mio assistente di supporto."
- "Aggiorna il mio assistente in modo che risponda sempre in un tono amichevole e conciso."
- "Cerca nella base di conoscenza del mio assistente di supporto la politica di rimborso."
- "Aggiungi un FAQ al mio assistente di supporto: 'Quanto tempo ci vuole per i rimborsi?' — 'I rimborsi arrivano entro 5 giorni lavorativi.'"
- "Un cliente con l'email [email protected] ha un problema — trova il suo assistente e dimmi come è configurato."
Sicurezza
- L'accesso è concesso tramite il tuo sicuro accesso OAuth di AI SmartTalk — non ci sono chiavi da copiare o memorizzare.
- La connessione raggiunge solo gli assistenti che il tuo account gestisce già.
- L'endpoint funziona solo su HTTPS.
- Puoi revocare l'accesso in qualsiasi momento dalle impostazioni del connettore del tuo strumento AI.
FAQ
Funziona solo con Claude? No. Qualsiasi strumento AI con un client MCP funziona — Claude, ChatGPT, Cursor, VS Code (Copilot), Cline, Windsurf e client personalizzati. Claude è solo l'esempio più comune.
Ho bisogno di una chiave API? No. Ti autentichi con il tuo normale account AI SmartTalk tramite OAuth. Non ci sono chiavi da gestire.
Quali assistenti può vedere lo strumento AI? Solo quelli che il tuo account è già autorizzato a gestire — esattamente come nel tuo dashboard di AI SmartTalk.
Le modifiche sono in tempo reale? Sì. Le modifiche che apporti tramite il tuo strumento AI — come aggiornare istruzioni o aggiungere conoscenze — appaiono immediatamente nel tuo dashboard di AI SmartTalk, e le modifiche nel dashboard sono visibili anche allo strumento AI.
Qual è la differenza con il connettore MCP Servers? Il connettore MCP Servers consente al tuo assistente di chiamare strumenti esterni. Questa pagina è l'opposto: uno strumento AI esterno chiama i tuoi assistenti AI SmartTalk.
Buono a sapersi
- La connessione funziona solo su un indirizzo sicuro (HTTPS).
- Le modifiche che apporti tramite il tuo strumento AI appaiono immediatamente nel tuo dashboard di AI SmartTalk, e viceversa.
- Puoi connettere lo stesso account AI SmartTalk da più strumenti AI contemporaneamente.