Evalmee MCP
Collega il tuo account Evalmee a Claude, ChatGPT, Copilot, Cursor o a qualsiasi assistente compatibile con MCP, e crea, modifica e rivedi i tuoi esami insieme a lui.
Collegare il tuo assistente
L'indirizzo del server MCP di Evalmee è https://app.evalmee.com/mcp. Non c'è nessuna chiave API da creare: dai quell'indirizzo al tuo client, e la connessione avviene nel browser, con il tuo account Evalmee, al primo utilizzo.
https://app.evalmee.com/mcpChe cosa ti chiederà un client
I moduli cambiano nome da un client all'altro e da un mese all'altro, ma pongono tutti le stesse domande. Ecco le risposte, qualunque sia l'etichetta del campo.
| Che cosa ti viene chiesto | Che cosa rispondi |
|---|---|
| L'indirizzo del server | https://app.evalmee.com/mcp, così com'è: senza /sse, senza barra finale — anche se l'esempio mostrato nel campo ne suggerisce una. |
| Il tipo di trasporto | HTTP («Streamable HTTP»), non SSE. Molti client non pongono più la domanda e lo rilevano da soli. |
| La modalità di autenticazione | OAuth. |
| Un ID client, un segreto, una chiave API | Niente: non ce ne sono. Il client si registra da solo presso il server di autorizzazione. Lascia vuote le «impostazioni avanzate». |
| Gli ambiti | mcp_read e mcp_write. Il client li richiede da sé, e la schermata di autorizzazione Evalmee te li mostra prima che tu accetti. |
Se un client pretende un ID client o un segreto, vuol dire che non è riuscito a leggere i metadati del server: ricontrolla l'indirizzo, carattere per carattere.
Claude
Schermata rilevata l'8 settembre 2026.
Nell'applicazione o su claude.ai, un server MCP di terze parti si chiama connettore personalizzato.
- Impostazioni → Connettori → «Aggiungi connettore personalizzato».
- Compila i campi:
- Nome: Evalmee.
- URL del server MCP remoto:
https://app.evalmee.com/mcp. - Impostazioni avanzate (ID e segreto client): lasciale vuote.
- Aggiungi, poi «Connetti»: si apre la pagina di autorizzazione Evalmee.
ChatGPT
Schermata rilevata l'8 settembre 2026.
ChatGPT accetta i server MCP di terze parti solo in modalità sviluppatore, su un piano a pagamento. È un interruttore da attivare una volta sola, prima di cercare il modulo.
- Impostazioni → Sicurezza → attiva «Modalità sviluppatore».
- Impostazioni → Plugin → «Nuovo plugin».
- Compila i campi:
- Nome: Evalmee.
- Connessione: «URL del server», con
https://app.evalmee.com/mcp. - Autenticazione:
OAuth. - Impostazioni OAuth avanzate: non toccarle.
- Spunta l'avviso, poi crea: ChatGPT apre la pagina di accesso a Evalmee nel tuo browser.
Se ChatGPT non vede Evalmee, controlla prima che il plugin sia attivo nella conversazione.
Microsoft Copilot
Documentazione Microsoft consultata il 1º ottobre 2026.
Copilot non si collega direttamente a un server MCP di terze parti: passa da un agente, che crei in Copilot Studio. Serve quindi che il tuo istituto ti dia accesso a Copilot Studio.
- In Copilot Studio, apri il tuo agente (o creane uno), poi Strumenti → «Aggiungi uno strumento» → «Nuovo strumento» → «Model Context Protocol».
- Compila i campi:
- Nome server: Evalmee.
- Descrizione server: una frase, per esempio «Crea e modifica esami in Evalmee». È ciò che l'agente legge per capire quando chiamare il server.
- URL server:
https://app.evalmee.com/mcp. - Autenticazione:
OAuth 2.0, tipo «Individuazione dinamica». Non c'è nessun ID né segreto client da inserire.
- «Crea», poi «Avanti».
- «Crea una nuova connessione»: si apre la pagina di autorizzazione Evalmee. Concludi con «Aggiungi all'agente».
Se l'opzione «Model Context Protocol» non compare, o se la connessione viene rifiutata, di solito è una regola fissata dall'amministratore Microsoft 365 del tuo istituto: lì i server MCP passano dai connettori Power Platform, che i suoi criteri per i dati possono bloccare. Una volta pubblicato, l'agente si ritrova in Microsoft 365 Copilot.
Claude Code
Basta un comando dal terminale.
claude mcp add --transport http evalmee https://app.evalmee.com/mcpCodex
Anche qui basta un comando dal terminale. Codex apre poi la pagina di autorizzazione Evalmee; se non lo fa, `codex mcp login evalmee` la riavvia.
codex mcp add evalmee --url https://app.evalmee.com/mcpCursor e i client configurati con un file
Quelli che leggono un file di configurazione si aspettano la forma seguente. In Cursor, Cursor Settings → Tools & MCP → «New MCP Server» apre questo file.
{
"mcpServers": {
"evalmee": {
"url": "https://app.evalmee.com/mcp"
}
}
}Cosa puoi fare
Oggi il server MCP apre tre cose al tuo assistente: creare e configurare i tuoi esami, scriverne il contenuto e leggere il report di integrità di un tentativo. Agisce con il tuo account e i tuoi permessi, niente di più.
Concretamente, il tuo assistente crea un esame con le sue impostazioni — scala di valutazione, valutazione globale o per criteri, ordine casuale di sezioni, esercizi, domande e opzioni, limite di tempo e tempo aggiuntivo — e poi ne compone il contenuto: sezioni, esercizi, pool ed esercizi casuali, domande di dodici tipi (scelta multipla, scelta singola, vero/falso, aperta, testo, risposta breve, numerica, codice, foglio di calcolo, schema, abbinamento, caricamento di file), opzioni e risposte corrette, criteri di valutazione per domanda, immagini inserite in una consegna. Ogni modifica compare in diretta nell'editor web. Una volta svolta la prova, legge il report di integrità di un tentativo: durata, dispositivi, copia e incolla di testo, periodi sospetti. Quello che non fa ancora: distribuire la prova, sorvegliarla in diretta, correggere le risposte o leggere i voti. Quel ciclo è quello dell'API pubblica v2API RESTInterfaccia di programmazione con cui un sistema di terze parti legge e scrive i dati di una piattaforma tramite richieste HTTP. Permette di automatizzare ciò che l'interfaccia grafica fa a mano: creare sessioni, iscrivere candidati, riversare i risultati in un software di segreteria., documentata su developers.evalmee.com, e il perimetro del server MCP si allarga versione dopo versione.
In lettura
- «Mostrami la struttura dell'esame di gennaio»: leggere un esame di cui sei autore: sezioni, esercizi, domande, opzioni, scala di valutazione.
- «Che tipi di domanda posso aggiungere qui?»: consultare i tipi di elemento disponibili e le regole che valgono a ogni livello dell'esame.
- «Riassumi il report di integrità di questo tentativo»: leggere ciò che la piattaforma ha rilevato durante la prova: segnali, non un verdetto.
- «In quali organizzazioni posso creare un esame?»: sapere quale account è collegato e dove può creare.
In scrittura
- «Crea un esame di 45 minuti, in ventesimi, con tempo aggiuntivo»: creare un esame e fissarne le impostazioni.
- «Scrivi dieci domande a scelta multipla da questo capitolo»: aggiungere sezioni, esercizi e domande, con le loro opzioni e le risposte corrette.
- «Valuta questa domanda aperta su tre criteri»: definire i criteri di valutazione di una domanda; il coefficiente ne deriva.
- «Sposta l'esercizio 3 in cima e duplica la sezione 2»: riordinare, spostare, duplicare, eliminare un elemento e tutto ciò che contiene.
- «Inserisci questo schema nella consegna»: caricare un'immagine e collocarla in una domanda.
- «Elimina la bozza di ieri»: eliminare un esame di cui sei proprietario.
Il perimetro del server MCP si amplia a ogni versione, fino a coprire tutto ciò che consentono l'applicazione e l'API pubblica, e seguirà uno strumento a riga di comando. È incluso in tutti i piani Evalmee, dal piano Mini al piano Organizzazione, senza costi aggiuntivi; il dettaglio si legge nella pagina prezzi.
Gli strumenti disponibili
Dodici strumenti, rilevati il 3 novembre 2026 sulla versione 1.0.1 del server. Gli strumenti di lettura richiedono solo l'ambito mcp_read; quelli che scrivono o eliminano richiedono mcp_write.
| Strumento | Cosa fa | Accesso |
|---|---|---|
| list_organizations | Elenca le organizzazioni in cui l'account collegato può creare un esame e indica quale account è collegato. | Lettura |
| create_exam | Crea un esame in una delle tue organizzazioni, con le sue impostazioni, e restituisce il link al suo editor. | Scrittura |
| get_exam_snapshot | Legge la struttura completa di un esame: sezioni, esercizi, domande, opzioni, scala di valutazione e criteri. | Lettura |
| delete_exam | Elimina un esame di cui sei proprietario. L'eliminazione non si annulla tramite MCP. | Eliminazione |
| get_node_catalog | Elenca i tipi di elemento che si possono aggiungere a un esame e le regole di ogni livello. | Lettura |
| create_node | Aggiunge una sezione, un esercizio, un pool, una domanda o un'opzione. | Scrittura |
| update_node | Modifica un elemento: consegna, risposta corretta, punti, criteri di valutazione. | Scrittura |
| move_node | Sposta un elemento in un'altra posizione o sotto un altro elemento padre. | Scrittura |
| duplicate_node | Duplica un elemento con tutto ciò che contiene. | Scrittura |
| delete_node | Elimina un elemento e tutto ciò che contiene. | Eliminazione |
| upload_inline_image | Carica un'immagine e restituisce il codice da inserire in una consegna. | Scrittura |
| get_integrity_report | Legge il report di integrità di un tentativo: durata, dispositivi, copia e incolla di testo, periodi sospetti. | Lettura |
Il tuo client mostra l'elenco in diretta nel momento in cui si collega: se differisce da questa tabella, fa fede il suo. Ogni versione porta nuovi strumenti.
Sicurezza e permessi
Un token MCP viene rilasciato a una persona, all'interno della sua organizzazione, tramite OAuth 2.0 con flusso a codice di autorizzazione e PKCE (metodo S256). Dà accesso soltanto a ciò che quella persona vede già in Evalmee, e si revoca in qualsiasi momento.
I due ambiti
| Ambito | Che cosa consente |
|---|---|
| mcp_read | Leggere. L'assistente consulta gli oggetti a cui il tuo account ha già accesso, e non modifica nulla. |
| mcp_write | Scrivere. L'assistente può creare e modificare oggetti a tuo nome, entro i limiti dei tuoi stessi diritti. |
- La separazione tra lettura e scrittura è retta dagli ambiti stessi: un client che ha ottenuto solo
mcp_readnon può modificare nulla, qualunque cosa gli si chieda. - Un token si revoca al punto di revoca del server di autorizzazione, https://app.evalmee.com/oauth/revoke, senza toccare gli altri client collegati allo stesso account. Rimuovere il server dal tuo client basta a interrompere l'accesso da quella macchina.
- Il contenuto di un esame e quello di un elaborato sono scritti da persone. Un assistente deve trattarli come dati, mai come istruzioni da seguire.
- Eliminare un esame dall'assistente non si può annullare tramite MCP, e solo il proprietario dell'esame può farlo: chiedi al tuo assistente di confermare prima di qualsiasi eliminazione.
I metadati OAuth
I due documenti che un client scopre da solo, e che puoi aprire: sono entrambi pubblici. La scoperta parte dal 401 restituito dal server: la sua intestazione WWW-Authenticate nomina l'URL dei metadati di risorsa, che a loro volta nominano il server di autorizzazione — nessun indirizzo da indovinare.
Metadati della risorsa protetta (RFC 9728)
https://app.evalmee.com/.well-known/oauth-protected-resourceMetadati del server di autorizzazione (RFC 8414)
https://app.evalmee.com/.well-known/oauth-authorization-server
Un token di accesso MCP scade dopo un'ora — il client lo rinnova con un refresh token, senza chiederti di accedere di nuovo — e una sessione MCP senza attività si chiude dopo ventiquattro ore. I limiti di frequenza e ciò che viene registrato lato server oggi non sono pubblicati. L'hosting, la cifratura, i tempi di conservazione e la minimizzazione dei datiMinimizzazione dei datiPrincipio del GDPR secondo cui, nella formulazione della CNIL, i dati personali devono essere adeguati, pertinenti e limitati a quanto è necessario rispetto alle finalità per cui sono trattati. Applicato al teleproctoring, impone di raccogliere solo ciò che la posta in gioco della prova giustifica. sono documentati nella pagina sicurezza.
Domande frequenti
Il Model Context Protocol è uno standard aperto che consente a un assistente IA di collegarsi a un servizio e di agire al suo interno. Il server MCP di Evalmee è il punto di accesso che espone in questo modo un account Evalmee: risponde in Streamable HTTP all'indirizzo https://app.evalmee.com/mcp, e un client compatibile vi si collega con l'account Evalmee del proprio utente.
Qualsiasi client compatibile con MCP. In Claude Code basta un comando: claude mcp add --transport http evalmee https://app.evalmee.com/mcp. In Claude, Cursor e negli altri basta aggiungere un server di tipo HTTP e indicare lo stesso indirizzo. In ChatGPT bisogna prima attivare la modalità sviluppatore nelle impostazioni, poi creare un plugin con quell'indirizzo e l'autenticazione OAuth. In Microsoft Copilot, il server si aggiunge come strumento di un agente in Copilot Studio, con OAuth 2.0 e individuazione dinamica. Non c'è nessuna chiave API né alcun ID client da inserire: la connessione avviene tramite OAuth, nel browser, al primo utilizzo.
Agli esami di cui la persona collegata è autrice, nella sua organizzazione: la loro struttura e il loro contenuto — sezioni, esercizi, domande, opzioni, scala di valutazione e criteri di valutazione. E al report di integrità di un tentativo che può consultare. Non alle risposte dei partecipanti né ai loro voti: il server MCP non copre ancora la somministrazione, la sorveglianza in diretta né la correzione. Pubblica due ambiti: mcp_read, che permette solo la lettura, e mcp_write, che autorizza creazione e modifica. Un assistente non vede e non fa mai più dell'utente per conto del quale agisce.
In due modi. Rimuovere il server MCP dalla configurazione del tuo client interrompe l'accesso da quella macchina. Per invalidare il token stesso, qualunque sia il client che lo detiene, usa il punto di revoca del server di autorizzazione, https://app.evalmee.com/oauth/revoke: gli altri client collegati allo stesso account non ne risentono.
Sì, su tutti i piani, dal piano Mini al piano Organizzazione, senza costi aggiuntivi.
Il riferimento interattivo dell'API pubblica v2 è su developers.evalmee.com, e il documento OpenAPI è servito in JSON all'indirizzo https://evalmee.com/openapi.json. È la superficie da usare per un'integrazione da server a server: ha la sua autenticazione, distinta da quella del server MCP.
Le altre superfici per sviluppatori
Il server MCP è la superficie di un assistente che agisce con una persona connessa, nei limiti dei suoi diritti. Per un'integrazione da server a server, un trattamento massivo o un lavoro senza nessuno davanti allo schermo, l'API REST pubblica v2 è la superficie giusta, con la sua autenticazione. Le pagine pubbliche di evalmee.com, dal canto loro, non contengono alcun dato di account.
Riferimento dell'API pubblica v2
La documentazione interattiva dell'API REST: ogni risorsa, ogni parametro, ogni risposta.
developers.evalmee.comDocumento OpenAPI
Lo stesso contratto, in JSON grezzo, servito sul dominio principale: la forma che un generatore di client legge direttamente.
evalmee.com/openapi.jsonCentro assistenza
Gli articoli per chi usa Evalmee ogni giorno, compresi quelli dedicati all'API.
help.evalmee.com