I componenti aggiuntivi di Google Classroom sono ora in disponibilità generale per gli sviluppatori. Per ulteriori informazioni, consulta la documentazione relativa ai componenti aggiuntivi.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configura il server MCP di Classroom

Google Classroom offre un server Model Context Protocol (MCP) remoto che consente agli agenti AI di interagire in modo sicuro con i dati di Google Classroom. Configurando il server MCP di Google Classroom, consenti alle applicazioni di AI come Google Antigravity e Claude di eseguire azioni in Google Classroom.

Il server MCP di Google Classroom fornisce un modo standardizzato per gli agenti AI di:

Lettura dei dati: elenca i corsi, recupera i contenuti e i metadati dei corsi e visualizza i compiti e i voti.
Passa all'azione: crea e aggiorna i materiali del corso e gli annunci.
Rispetta la sicurezza: eredita le stesse autorizzazioni e gli stessi controlli di governance dei dati dell'utente.

Per scoprire i concetti chiave e i vantaggi dei server MCP remoti di Google, consulta la panoramica dei server MCP di Google Cloud.

Riferimento dello strumento

I seguenti strumenti sono disponibili per il server MCP di Google Classroom:

list_courses
list_course_work_submissions
get_course_work
create_course_work
update_course_work
list_course_work_submissions
list_topics
create_topic
list_announcement_summaries
get_announcements
create_announcement
get_course_work_rubric
create_course_work_rubric
get_course_roster
get_guardian_info
search_course_standards

Prerequisiti

Iscrizione al programma Anteprima per gli sviluppatori di Google Workspace.
Un progetto Google Cloud. Per creare un progetto, consulta Crea un progetto.
Un host MCP, come Google Antigravity.
Un corso di prova di Google Classroom con almeno un account studente di prova. Se non hai un corso Google Classroom che puoi utilizzare per i test, creane uno nella UI e aggiungi uno studente di test.

Configura il server MCP di Google Classroom

Per utilizzare il server MCP di Google Classroom, devi attivare i servizi API e MCP nel tuo progetto Google Cloud, quindi configurare la connessione del client MCP.

Abilita i servizi API e MCP di Google Classroom

Abilita l'API Google Classroom nel tuo progetto cloud Google:

Abilita le API
Abilita il servizio Google Classroom MCP nel tuo progetto Google Cloud:

Attiva il servizio MCP

Il server MCP di Google Classroom utilizza OAuth 2.0 per l'autenticazione e l'autorizzazione. Devi configurare la schermata per il consenso OAuth prima di poter creare un ID client OAuth.

Nella console Google Cloud, vai a Google Auth Platform > Branding.

Vai a Branding
Se hai già configurato la Google Auth Platform, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se viene visualizzato il messaggio Google Auth Platform non ancora configurata, fai clic su Inizia:
1. In Informazioni sull'app, digita Classroom MCP Server in Nome app.
2. In Email assistenza utenti, seleziona il tuo indirizzo email o un gruppo Google appropriato.
3. Fai clic su Avanti.
4. In Pubblico, seleziona Interno. Se non riesci a selezionare Interno, seleziona Esterno.
5. Fai clic su Avanti.
6. In Dati di contatto, inserisci un indirizzo email a cui puoi ricevere notifiche su eventuali modifiche al progetto.
7. Fai clic su Avanti.
8. In Fine, leggi le Norme relative ai dati utente dei servizi API di Google e, se accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
9. Fai clic su Continua.
10. Fai clic su Crea.
11. Se hai selezionato Esterno come tipo di utente, aggiungi gli utenti di test:
  1. Fai clic su Pubblico.
  2. Nella sezione Utenti di test, fai clic su Aggiungi utenti.
  3. Inserisci il tuo indirizzo email e quello di altri utenti di test autorizzati, quindi fai clic su Salva.
Fai clic su Accesso ai dati > Aggiungi o rimuovi ambiti. Viene visualizzato un riquadro con un elenco di ambiti per ogni API che hai abilitato nel tuo progetto Google Cloud.
1. In Aggiungi ambiti manualmente, incolla gli ambiti per il server MCP di Google Classroom. Gli ambiti necessari per i prompt di esempio sono:
  - https://www.googleapis.com/auth/classroom.announcements
  - https://www.googleapis.com/auth/classroom.courses.readonly
2. Fai clic su Aggiungi alla tabella.
3. Fai clic su Aggiorna.
4. Dopo aver selezionato gli ambiti richiesti dalla tua app, nella pagina Accesso ai dati, fai clic su Salva.

Configura il client MCP

Per aggiungere il server MCP remoto di Google Classroom al tuo client MCP, segui le istruzioni per il tuo client. Le istruzioni per due client comuni sono fornite qui. Per informazioni dettagliate sulla connessione di diversi tipi di client, consulta Configura MCP in un'applicazione di AI.

Gli ID client OAuth 2.0 delegati dall'utente che chiamano il server MCP di Classroom devono avere l'opzione Utilizza questo client per un agente basato sull'AI selezionata in Google Auth Platform > Client. Per aggiornare un ID client OAuth 2.0 esistente, seleziona questa impostazione in Google Auth Platform > Client, come descritto in Gestisci i client OAuth. Se non riesci a modificare questa impostazione su un client esistente o se il client supporta anche funzionalità non relative agli agenti, crea un nuovo ID client OAuth 2.0 per l'agente AI. Per le richieste rifiutate, i service account con delega a livello di dominio o Google Apps Script, consulta la sezione Risoluzione dei problemi.

Antigravity

Per aggiungere il server MCP remoto di Google Classroom ad Antigravity, aggiungi la configurazione del server al file mcp_config.json. Queste istruzioni supportano Antigravity 2.0, Antigravity IDE e Antigravity CLI.

Crea un ID client e un secret OAuth 2.0:
1. Nella console Google Cloud, vai a Google Auth Platform > Client > Crea client.
  
  Vai a Crea client
2. Seleziona Applicazione web come tipo di applicazione.
3. Inserisci un Nome.
4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi aggiungi https://antigravity.google/oauth-callback nel campo URI.
5. Seleziona Utilizza questo client per un agente basato sull'AI.
6. Fai clic su Crea e copia l'ID client e il client secret.
Apri o crea il file di configurazione ~/.gemini/config/mcp_config.json.

Aggiungi la configurazione mcpServers a mcp_config.json:

{
  "mcpServers": {
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Sostituisci quanto segue:

OAUTH_CLIENT_ID: l'ID client che hai creato.
OAUTH_CLIENT_SECRET: il client secret che hai creato.

Risparmia mcp_config.json.
Autentica il server MCP. Puoi eseguire l'autenticazione utilizzando le impostazioni della GUI o l'interfaccia a riga di comando:
- Per Antigravity IDE o GUI (Antigravity 2.0):
  1. Apri la schermata delle impostazioni (ad esempio, fai clic su Impostazioni in basso a sinistra o apri Impostazioni utente Antigravity).
  2. Vai a Personalizzazioni.
  3. Nella sezione Server MCP installati, fai clic su Aggiorna.
  4. Trova classroom nell'elenco, fai clic su Autentica, accedi al tuo Account Google, copia il codice di autorizzazione, incollalo nella finestra di dialogo di input e fai clic su Invia.
- Per Antigravity CLI:
  1. Avvia Antigravity CLI:
```
agy
```
  2. Apri il riquadro di gestione interattivo di MCP eseguendo:
```
/mcp
```
  3. Utilizza i tasti freccia per selezionare classroom, vai all'azione Autentica e premi Invio. Completa il flusso di accesso nel browser, copia il codice di autorizzazione, incollalo nel prompt del terminale e premi Invio.
Verifica che il server sia configurato correttamente e in esecuzione:
- Per Antigravity IDE o GUI: viene visualizzato un pulsante Esci accanto al server in Personalizzazioni > Server MCP installati.
- Per Antigravity CLI: apri il riquadro /mcp per visualizzare i server MCP configurati. I server verificati e autenticati mostrano Authed accanto ai loro nomi all'interno del riquadro TUI interattivo. Puoi selezionare il server nella visualizzazione della dashboard per controllarne lo stato ed elencare tutti gli strumenti disponibili.

Il server MCP remoto è pronto per l'uso in Antigravity.

Claude

Per utilizzare il server MCP remoto di Google Classroom con Claude.ai o Claude Desktop, devi disporre del piano Claude Enterprise, Pro, Max o Team.

Per aggiungere il server MCP remoto di Google Classroom a Claude, configura un connettore personalizzato con un ID client OAuth e un secret.

Crea un ID client e un secret OAuth 2.0:
1. Nella console Google Cloud, vai a Google Auth Platform > Client > Crea client.
  
  Vai a Crea client
2. Seleziona Applicazione web come tipo di applicazione.
3. Inserisci un Nome.
4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI, quindi aggiungi https://claude.ai/api/mcp/auth_callback nel campo URI.
5. Seleziona Utilizza questo client per un agente basato sull'AI.
6. Fai clic su Crea e copia l'ID client e il client secret.
Configura il server MCP in Claude:
1. In Claude.ai o Claude Desktop, vai a Impostazioni > Connettori o Impostazioni amministratore > Connettori.
2. Fai clic su Aggiungi connettore personalizzato.
3. Inserisci i dettagli della connessione per il prodotto Google Classroom:
  - Nome server: Google Classroom.
  - URL del server MCP remoto: https://classroommcp.googleapis.com/mcp/v1
4. In Autenticazione, seleziona Accedi ora. In Client OAuth, seleziona Utilizza il tuo client OAuth e inserisci il tuo ID client OAuth e il tuo client secret OAuth.
5. Fai clic su Aggiungi e poi su Connetti.

Altri

Molte applicazioni di AI hanno modi per connettersi a un server MCP remoto. In genere, devi inserire i dettagli del server, come nome, endpoint, protocollo di trasporto e metodo di autenticazione. Per il server MCP remoto di Google Classroom, inserisci quanto segue:

Nome server: classroom
URL del server: https://classroommcp.googleapis.com/mcp/v1
Trasporto: HTTP trasmissibile in streaming
Autenticazione: il server MCP remoto di Google Classroom utilizza OAuth 2.0. Quando crei il client OAuth 2.0, seleziona Utilizza questo client per un agente basato sull'AI. Per maggiori dettagli, consulta Scopri di più su autenticazione e autorizzazione.

Testa il server MCP di Google Classroom

Dopo aver configurato il client MCP, puoi verificare la connessione eseguendo alcuni prompt di test.

Prova a porre al tuo cliente MCP le seguenti domande:

"Quali corsi sto insegnando attualmente?"

Il client controlla la tua pianificazione utilizzando classroom.list_courses e ti riassume i corsi attivi in cui hai il ruolo di insegnante.
"Per il mio corso di geologia, scrivi una bozza di annuncio sulla prossima gita."

Il cliente utilizza classroom.create_announcement per creare la bozza dell'annuncio, che puoi rivedere e pubblicare nell'app Google Classroom.

Se gli strumenti vengono eseguiti correttamente e ricevi risposte pertinenti, il tuo server MCP di Google Classroom è configurato correttamente.

Estendi la funzionalità con server aggiuntivi

Altri servizi Google Workspace offrono server MCP remoti. Per estendere le funzionalità del tuo client MCP, valuta la possibilità di attivare e configurare altri server MCP remoti.

Per Google Classroom in particolare, la configurazione del server MCP di Google Drive può essere particolarmente utile per lavorare con gli allegati.

Risoluzione dei problemi

Utilizza le sezioni seguenti per risolvere i problemi comuni di autenticazione e connessione con il server MCP di Classroom.

Controlla gli eventi dei log OAuth

Se riscontri problemi di connessione al server MCP, controlla se sono presenti errori nei log OAuth. Chiedi all'amministratore di Google Workspace di esaminare gli eventi dei log OAuth nello strumento di indagine sulla sicurezza.

Richieste rifiutate dai client OAuth delegati dagli utenti

Se le tue richieste al server MCP vengono rifiutate, verifica che l'ID client OAuth 2.0 delegato dall'utente per il tuo flusso OAuth a tre vie abbia l'opzione Utilizza questo client per un agente basato sull'AI selezionata in Google Auth Platform > Client:

Il client esistente supporta l'impostazione: seleziona Utilizza questo client per un agente basato sull'AI nel client OAuth esistente.
Impossibile aggiornare il client esistente: crea un nuovo client OAuth con l'opzione Utilizza questo client per un agente basato sull'AI selezionata e aggiorna la tua app per utilizzarlo.
Il client esistente supporta anche funzionalità non relative agli agenti: crea un client OAuth separato per l'agente AI e mantieni il client esistente per le funzionalità non relative agli agenti.

Per istruzioni, consulta Configura il client MCP e Gestisci i client OAuth.

Service account con delega a livello di dominio

Se la tua app utilizza un service account con delega a livello di dominio per OAuth a 2 vie, non puoi selezionare Utilizza questo client per un agente basato sull'AI perché i service account non sono gestiti in Google Auth Platform > Client:

Controllo dell'accesso: le richieste al server MCP da questi service account non vengono rifiutate se manca l'impostazione dell'agente. L'accesso è invece regolato dalle impostazioni di delega a livello di dominio gestite dall'amministratore di Google Workspace. Per maggiori dettagli sulle impostazioni dell'amministratore, consulta Controlla l'accesso all'API con la delega a livello di dominio.
Azioni sensibili: i server MCP di Google Workspace continuano a restituire prompt di compilazione di moduli per la conferma human-in-the-loop delle chiamate allo strumento sensibili effettuate tramite l'impersonificazione di un utente con delega a livello di dominio.

Richieste da Apps Script

Se chiami il server MCP da Apps Script, non puoi selezionare Utilizza questo client per un agente basato sull'AI nel client OAuth predefinito che Apps Script crea e gestisce per il tuo script. Questo vale anche se lo script utilizza un progetto Google Cloud standard.

Per chiamare il server MCP da Apps Script, segui questi passaggi:

Nella console Google Cloud, vai a Google Auth Platform > Client, crea un client OAuth e seleziona Utilizza questo client per un agente basato sull'AI.
Nello script, utilizza la libreria OAuth2 per Apps Script per autorizzare gli utenti con quel client OAuth.
Quando chiami il server MCP, invia il token di accesso restituito dalla libreria anziché il token di ScriptApp.getOAuthToken.

I progetti Apps Script che non chiamano i server MCP di Google Workspace non sono interessati.

Se ti viene chiesto di accedere di nuovo ogni ora circa, il tuo client MCP non riceve un token di aggiornamento. Il server OAuth 2.0 di Google emette un token di aggiornamento solo quando la richiesta di autorizzazione include access_type=offline. La richiesta del solo ambito OpenID Connect (OIDC) offline_access non restituisce un token ID.

Verifica se il tuo client MCP supporta i parametri di autorizzazione personalizzati:

Il client supporta i parametri di autorizzazione personalizzati: aggiungi access_type=offline alla richiesta di autorizzazione. Per ottenere un nuovo token di aggiornamento per un utente che ha già concesso l'accesso, aggiungi anche prompt=consent.
Il client non supporta i parametri di autorizzazione personalizzati: accedi di nuovo ogni volta che il token di accesso scade.

Per maggiori dettagli, vedi Aggiorna un token di accesso.

Considerazione importante sulla sicurezza: prompt injection indiretto

Quando esponi un modello linguistico a dati non attendibili, esiste il rischio di un attacco di prompt injection indiretto. Poiché gli host MCP come Google Antigravity hanno accesso a strumenti e API potenti tramite il server MCP di Google Classroom, possono leggere, modificare ed eliminare i dati nel tuo Account Google.

Per mitigare questi rischi, devi esaminare i prompt e le risposte per individuare contenuti dannosi o attacchi di prompt injection. Puoi utilizzare Model Armor fornito da Google o la tua soluzione, se la documenti in modo che gli utenti accettino il rischio. Per saperne di più, consulta Configura la sicurezza per i server MCP di Google Workspace.

Segui queste best practice:

Utilizza solo strumenti attendibili. Non connettere mai il server MCP di Google Classroom ad applicazioni non attendibili o non verificate.
Fai attenzione agli input non attendibili. Evita di chiedere al tuo client MCP di elaborare eventi o altre risorse provenienti da fonti non verificate. Questi input potrebbero contenere istruzioni nascoste che possono compromettere la sessione, consentendo a un malintenzionato di modificare, rubare o eliminare i tuoi dati.
Esamina tutte le azioni. Esamina sempre attentamente le azioni intraprese dal tuo client AI per tuo conto per assicurarti che siano corrette e in linea con le tue intenzioni.
Utilizza Model Armor. Attiva Model Armor per proteggerti dagli attacchi di prompt injection.

Feedback

Condividi il tuo feedback sul server MCP di Google Classroom nel nostro Issue Tracker pubblico.