> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AhaSlides MCP: guida introduttiva
> Il server MCP di AhaSlides permette ad assistenti AI come Claude e ChatGPT di usare AhaSlides per creare presentazioni, quiz e analizzare le risposte.
Una volta collegato AhaSlides, il tuo assistente AI può creare e modificare slide, impostare limiti di tempo e punti, applicare un tema alla presentazione e persino creare un file PowerPoint con slide AhaSlides dal vivo al suo interno. Il Model Context Protocol è uno standard aperto che collega gli assistenti AI a strumenti e servizi esterni. Invece di passare da un'app all'altra, descrivi ciò che ti serve e l'AI lavora al posto tuo dentro AhaSlides. Pensalo come dare a Claude un posto nel tuo account AhaSlides.
## Prima di iniziare
Ti servono:
* Un account AhaSlides (gratuito o a pagamento)
* Un assistente AI che supporti i connettori MCP personalizzati: Claude, ChatGPT o Claude Code
Non serve nessuna chiave API: accederai con il tuo account AhaSlides quando ti colleghi per la prima volta. L'URL del server è lo stesso ovunque:
```
https://mcp.ahaslides.com/mcp
```
## Configurazione: aggiungere AhaSlides a Claude (senza codice)
È il modo più semplice per la maggior parte delle persone: pochi clic, nessun terminale.
Fai clic sul tuo profilo, poi vai su **Settings → Connectors**.
Fai clic su **Add custom connector**, incolla `https://mcp.ahaslides.com/mcp` nel campo **Remote server URL**, poi fai clic su **Add**.
La prima volta che usi uno strumento di AhaSlides, Claude apre una finestra del browser in cui accedere con il tuo account AhaSlides (e-mail e password, Google o Microsoft). Dopo l'accesso, è tutto pronto.
Per aggiungere connettori in Claude serve un piano Claude a pagamento.
## Configurazione: aggiungere AhaSlides a ChatGPT (senza codice)
Anche ChatGPT può usare AhaSlides, e per farlo non serve un account ChatGPT a pagamento.
Fai clic sul tuo profilo, poi vai su **Settings → Security and login** e attiva **Developer mode**: ti permette di aggiungere connessioni personalizzate.
Apri la scheda **Plugins** e scegli **Browse plugin**.
Fai clic sull'icona più (**+**), incolla `https://mcp.ahaslides.com/mcp` nel campo **Connection**, poi fai clic su **Create**.
La prima volta che usi uno strumento di AhaSlides, ti verrà chiesto di accedere con il tuo account AhaSlides. Dopo l'accesso, è tutto pronto.
## Configurazione: aggiungere AhaSlides a Claude Code (per sviluppatori)
Se usi Claude Code (CLI, app desktop o estensione per VS Code / JetBrains), puoi aggiungere direttamente il server.
### Opzione 1: aggiunta rapida tramite CLI
Esegui questo comando nel terminale:
```bash theme={null}
claude mcp add ahaslides --transport http https://mcp.ahaslides.com/mcp
```
### Opzione 2: configurazione manuale
Aggiungi quanto segue alle impostazioni MCP di Claude Code (settings.json o .mcp.json):
```json theme={null}
{
"mcpServers": {
"ahaslides": {
"type": "url",
"url": "https://mcp.ahaslides.com/mcp"
}
}
}
```
### Accedere a Claude Code
La prima volta che usi uno strumento di AhaSlides, Claude Code apre una finestra del browser in cui accedere con il tuo account AhaSlides (e-mail e password, Google o Microsoft). Dopo l'accesso, è tutto pronto.
## Cosa puoi fare con AhaSlides MCP
Una volta collegato, ti basta descrivere ciò che ti serve. Ecco tutto ciò che il server MCP supporta:
**Presentazioni** (Presentations)
* Creare una nuova presentazione
* Vedere tutti i dettagli di una presentazione (slide, tema, struttura)
**Slide**
* Creare slide di oltre 17 tipi: quiz, sondaggi, nuvole di parole, brainstorming, slide di contenuto e altro
* Modificare il contenuto delle slide (titoli, opzioni, risposte, paragrafi, immagini)
* Configurare le proprietà delle slide (timer, punteggio, impostazioni di visualizzazione, tipi di grafico)
* Riordinare le slide all'interno di una presentazione
* Eliminare le slide
* Saltare le slide durante una presentazione dal vivo (nasconderle al pubblico senza rimuoverle)
**Temi** (Themes)
* Sfogliare tutti i temi disponibili (ufficiali, personalizzati e condivisi dal team)
* Applicare un tema a qualsiasi presentazione
**Analisi** (Analytics)
* Interrogare i dati delle risposte del pubblico in tutte le tue presentazioni
* Analizzare i dati di sessione di una presentazione specifica (partecipazione, punteggi dei quiz, risultati dei sondaggi)
* Creare un report salvato che puoi fissare, impostare come home dei Report o condividere tramite link: consulta [Creare report con l'AI](/it/integrations/create-reports-with-ai)
**Ricette**
* Usare le ricette integrate e salvare le tue: consulta [Ricette integrate e le tue](#ricette-integrate-e-le-tue)
**File PowerPoint**
* Creare una presentazione PowerPoint (.pptx) con quiz, sondaggi e altre slide interattive di AhaSlides dal vivo incorporati: consulta [Creare una presentazione PowerPoint con slide AhaSlides dal vivo](#creare-una-presentazione-powerpoint-con-slide-ahaslides-dal-vivo)
## Creare una presentazione PowerPoint con slide AhaSlides dal vivo
Chiedi al tuo assistente AI una presentazione PowerPoint con slide interattive e ti consegnerà un unico file .pptx con quiz, sondaggi, nuvole di parole e altre slide interattive di AhaSlides dal vivo incorporati. Quando la presenti in PowerPoint, quelle slide funzionano dal vivo: il pubblico si unisce dai telefoni e risponde, proprio come in AhaSlides.
Dietro le quinte, l'assistente crea le slide interattive in una nuova presentazione nel tuo account AhaSlides, costruisce la presentazione PowerPoint e inserisce ogni slide interattiva tramite il [componente aggiuntivo AhaSlides per PowerPoint](/it/integrations/using-powerpoint-s-ahaslides-add-in).
### Cosa ti serve
* AhaSlides MCP collegato al tuo assistente AI. Consulta i passaggi di configurazione per Claude, ChatGPT o Claude Code in questa pagina.
* Un assistente AI in grado di creare file ed eseguire codice, come Claude o Claude Code. La creazione del file .pptx avviene sul lato dell'assistente.
* L'app desktop di PowerPoint per Windows o Mac con il componente aggiuntivo AhaSlides installato. Consulta [Configurare il componente aggiuntivo](/it/integrations/using-powerpoint-s-ahaslides-add-in#configurare-il-componente-aggiuntivo).
### Esempi di prompt
* *"Crea una presentazione PowerPoint con quiz interattivi sulla nostra nuova gamma di prodotti."*
* *"Preparami una presentazione .pptx per la riunione di team di lunedì con un sondaggio dal vivo e una nuvola di parole."*
* *"Crea un PowerPoint per il mio workshop con alcune domande di partecipazione del pubblico tra un argomento e l'altro."*
### Dove le slide funzionano dal vivo
Le slide interattive funzionano dal vivo solo nell'app desktop di PowerPoint con il componente aggiuntivo AhaSlides. Ovunque altrove (PowerPoint per il web, un'esportazione in PDF o una stampa, oppure un computer senza il componente aggiuntivo) ciascuna mostra un'immagine segnaposto al posto di una slide vuota.
Se invii il file a qualcun altro perché lo presenti, deve avere il componente aggiuntivo AhaSlides installato nella propria copia di PowerPoint affinché le slide funzionino dal vivo.
Poiché le slide interattive sono salvate come presentazione nel tuo account AhaSlides, puoi modificarle lì come al solito. Per portare le tue modifiche in PowerPoint, usa **Ricarica** (Reload) nel componente aggiuntivo. Consulta [Ricaricare le slide](/it/integrations/using-powerpoint-s-ahaslides-add-in#ricaricare-le-slide).
## Ricette integrate e le tue
Una ricetta è un insieme salvato di istruzioni che dice al tuo assistente AI come creare un certo tipo di presentazione, survey o corso. AhaSlides include ricette integrate e puoi salvare le tue.
Per vederle, chiedi al tuo assistente: *"Quali ricette AhaSlides hai?"* Poi indica quella che vuoi nella tua richiesta, ad esempio *"Usando la ricetta Classroom lesson, crea una lezione su..."*
| Ricetta | Quando usarla |
| - | - |
| **Classroom lesson** | Una lezione scolastica con attività iniziale, spiegazione diretta, verifiche della comprensione e un biglietto di uscita |
| **Quiz game** | Un quiz competitivo dal vivo con punteggi e classifica |
| **Secondary school course** | Un corso per studenti dagli 11 ai 18 anni circa, con lezioni brevi e frequenti verifiche a basso impatto |
| **Bloom's taxonomy course** | Un corso le cui lezioni salgono dal ricordare i fatti ad applicarli e valutarli |
L'elenco include anche ricette per rompighiaccio, workshop di formazione, sessioni di domande e risposte aziendali, retrospettive, survey e corsi aziendali. Per i prompt per la classe che puoi copiare, consulta [AhaSlides MCP per gli insegnanti](/it/integrations/ahaslides-mcp-for-teachers).
### Salvare una tua ricetta
Descrivi come vuoi che vengano create le tue presentazioni, poi chiedi al tuo assistente di salvarla:
*"Salva questo come ricetta AhaSlides chiamata 'My quiz style': quattro opzioni di risposta, risposte sbagliate basate su errori comuni, 20 secondi per domanda e una classifica ogni cinque domande."*
La volta successiva, chiedila per nome. Tieni presente che:
* Puoi salvare fino a 50 ricette tue.
* Il titolo di una ricetta può arrivare a 80 caratteri e le istruzioni a 4.000.
* Le ricette integrate non si possono modificare. Per cambiarne una, chiedi al tuo assistente di salvarne una copia come tua ricetta e modifica quella.
* Puoi chiedere al tuo assistente di aggiornare o eliminare una ricetta che hai salvato.
## Creare report con l'AI
Fai domande al tuo assistente AI sui risultati del pubblico e salverà un report personalizzato in **I miei report** (My reports) nella pagina **Report** (Reports). Consulta [Creare report con l'AI](/it/integrations/create-reports-with-ai) per sapere come creare, fissare, condividere e gestire i report.
## Tipi di slide supportati
| Categoria | Tipi di slide |
| - | - |
| **Quiz** | Pick Answer, Short Answer, Match Pairs, Correct Order, Categorise |
| **Interattivo** (Interactive) | Poll, Word Cloud, Brainstorm, Open Ended, Scale, Q\&A, Spinner Wheel |
| **Contenuto** (Content) | Presentation Title, Content, Listing, Content with Image (a sinistra o a destra) |
| **Utility** | QR Code, Leaderboard |
## Esempi di prompt MCP
Ecco alcuni prompt di esempio per iniziare:
| Attività | Prompt |
| - | - |
| Creare una presentazione | *"Crea una nuova presentazione AhaSlides chiamata 'Q2 Team Update' con una slide di benvenuto e un'agenda."* |
| Aggiungere un sondaggio o un quiz | *"Aggiungi alla mia presentazione una domanda a scelta multipla che chieda 'Qual è la tua sfida più grande al lavoro?' con quattro opzioni."* |
| Creare un quiz | *"Crea un quiz di 5 domande sulle funzioni del nostro prodotto per una sessione di formazione del team."* |
| Aggiungere una nuvola di parole | *"Aggiungi una slide Word Cloud che chieda ai partecipanti 'Come ti immagini una grande collaborazione?'"* |
| Modificare le slide esistenti | *"Cambia il titolo della slide 3 della mia presentazione in 'Quarterly Highlights'."* |
| Riordinare le slide | *"Sposta la slide della classifica subito dopo l'ultima domanda del quiz."* |
| Cambiare l'aspetto | *"Mostrami tutti i temi disponibili, poi applica un tema scuro alla mia presentazione."* |
| Analizzare le risposte del pubblico | *"Quante persone hanno partecipato alla mia presentazione 'Sales Kickoff 2025'? Mostrami il dettaglio dei punteggi del quiz."* |
| Creare un report | *"Quali domande del quiz hanno messo in difficoltà la mia classe questo mese? Salvalo come report."* |
| Saltare una slide | *"Salta la slide Brainstorm durante la sessione dal vivo: voglio tenerla ma non mostrarla oggi."* |
| Pianificare una lezione | *"Crea una lezione di 45 minuti per la seconda media sul ciclo dell'acqua con un quiz dopo ogni parte e un biglietto di uscita di tre domande."* |
| Creare una presentazione PowerPoint | *"Crea una presentazione PowerPoint con quiz interattivi e un sondaggio dal vivo per la mia formazione sulle vendite."* |
## Consigli per ottenere i migliori risultati con MCP
**Sii specifico su ciò che vuoi:**
* Invece di "Fai un quiz", prova "Fai un quiz a scelta multipla di 10 domande sulla sicurezza sul lavoro per i nuovi assunti, con 4 opzioni di risposta ciascuna"
**Indica le presentazioni per nome:**
* "Aggiungi un sondaggio alla mia presentazione chiamata 'Sales Kickoff 2025'"
**Chiedi prima la struttura, poi perfezionala:**
* "Crea una scaletta per una sessione di formazione sul prodotto di 15 minuti, poi realizzala in AhaSlides"
**Combinalo con altri strumenti:**
* "Leggi l'agenda della mia riunione da Google Docs, poi crea con quella una presentazione AhaSlides"
**Usa le analisi per migliorare:**
* "Mostrami quali domande del quiz hanno avuto la percentuale più bassa di risposte corrette nella mia ultima sessione di formazione"
## Risoluzione dei problemi di AhaSlides MCP
| Problema | Soluzione |
| - | - |
| **Il popup di accesso non compare** | Riavvia Claude Code e riprova |
| **Errore "Not authenticated"** | La sessione potrebbe essere scaduta: Claude Code ti chiederà di accedere di nuovo |
| **Una pagina "Connect your app" mi chiede di collegarmi** | Un'app che stai usando ha chiesto di collegarsi al tuo account AhaSlides. Controlla che il codice corrisponda a quello mostrato in quell'app, poi seleziona **Collega** (Connect). I codici scadono: se la pagina dice che il codice non è valido o è scaduto, riavvia l'accesso dall'app. Se non hai appena avviato un accesso, chiudi la scheda. |
| **Gli strumenti non compaiono** | Riavvia Claude Code dopo aver aggiunto il server |
| **Errore "Presentation not found"** | Assicurati di indicare il nome o l'ID corretto della presentazione |
| **Risposte lente** | È normale con presentazioni grandi e con molte slide: attendi un momento |
## Sicurezza e privacy di MCP
* Nessuna chiave API da gestire: l'autenticazione usa il sicuro OAuth 2.0 (lo stesso standard usato da Google, GitHub e altri)
* Accedi con il tuo account AhaSlides esistente: nessuna credenziale aggiuntiva da creare o conservare
* L'AI può accedere solo alle presentazioni del tuo account
* Il server MCP esegue solo le azioni che richiedi esplicitamente
* Puoi revocare l'accesso in qualsiasi momento dalle impostazioni dell'account AhaSlides
* La tua sessione di accesso scade automaticamente: ti verrà chiesto di autenticarti di nuovo quando necessario
## Domande frequenti
AhaSlides non ha un'API REST pubblica, quindi non c'è nessuna chiave API da cercare. Se vuoi che un assistente AI come Claude lavori con il tuo account AhaSlides, usa invece AhaSlides MCP: si collega con il tuo accesso esistente ad AhaSlides, senza bisogno di una chiave API. Consulta la sezione **Configurazione** qui sopra per aggiungerlo a Claude Code.
**Hai una domanda?**
Contatta il nostro team di assistenza: se hai effettuato l'accesso, usa l'icona della chat in basso a destra nella dashboard; altrimenti [contattaci qui](https://ahaslides.com/contact-us/) o scrivi a [hi@ahaslides.com](mailto:hi@ahaslides.com).
Vuoi entrare in contatto con altri utenti? Unisciti alla [community di AhaSlides](https://community.ahaslides.com/) per condividere consigli, richiedere nuove funzionalità e scoprire come gli altri coinvolgono il loro pubblico.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.