Server MCP
Collega PupilBot una volta e la tua IA può leggere i tuoi studi, le tue risposte e i tuoi errori, cosa c’è da ripassare e come cambiano i tuoi progressi nel tempo. Può anche trasformare gli appunti che incolli in un nuovo studio.
Continui a esercitarti nell’app web, nell’app per iPhone o nel bot Telegram. La tua IA legge il tuo storico e te lo spiega; non risponde mai alle domande al posto tuo.
Chiedi con parole tue. La tua IA sceglie gli strumenti che le servono e risponde con i tuoi dati reali di esercizio.
https://www.pupilbot.com/mcpIncollalo in qualsiasi client MCP. La prima connessione apre una pagina di accesso PupilBot dove approvi il client — nessuna chiave API da generare, niente da configurare. Non hai ancora un account? Creane uno, è gratis.
PupilBot e incolla https://www.pupilbot.com/mcphttps://www.pupilbot.com/mcp come URL del server e scegli OAuth per l’autenticazioneLa guida al collegamento di OpenAI riporta i passaggi attuali. Il tuo piano ChatGPT e le impostazioni del tuo workspace decidono se i server MCP personalizzati sono disponibili.
Esegui questo nel terminale:
claude mcp add --transport http pupilbot https://www.pupilbot.com/mcpLa prima chiamata apre l’accesso a PupilBot nel browser. Approvalo una volta e la connessione resta.
Aggiungi il server, poi accedi — aggiungere un server protetto da OAuth non avvia l’accesso da solo:
codex mcp add pupilbot --url https://www.pupilbot.com/mcpcodex mcp login pupilbotIl plugin di PupilBot aggiunge questo server e 3 skill: un resoconto di studio che dice cosa esercitare dopo, i ripassi in scadenza oggi e un nuovo studio da un file o da un testo incollato.
Claude Code:
claude plugin marketplace add gabrielpolyy/pupilbot-pluginsclaude plugin install pupilbot@pupilbotCodex:
codex plugin marketplace add gabrielpolyy/pupilbot-pluginscodex plugin add pupilbot@pupilbotIn Claude Code le skill si avviano con /pupilbot:study-report, /pupilbot:due-today e /pupilbot:make-study. Entrambi gli agenti le usano anche quando la tua richiesta corrisponde.
http (streamable HTTP) e URL https://www.pupilbot.com/mcp7 strumenti, tutti limitati al tuo account. Tutti si limitano a leggere, tranne create_study, che crea un nuovo studio dal testo che invii. Nessuno può cancellare nulla né vedere i dati di un altro studente.
| Strumento | Cosa fa |
|---|---|
create_study |
Trasforma il testo che dai alla tua IA (appunti, un articolo, un capitolo) in un nuovo studio con argomenti e domande di esercizio. Ci vuole circa un minuto. |
list_studies |
I tuoi studi, dal più recente, con l’avanzamento per argomento, i ripassi in scadenza e quando ti sei esercitato l’ultima volta. |
get_study |
Uno studio nel dettaglio: lo stato, il numero di domande e ogni argomento con fase, padronanza, stima del ricordo e prossimo ripasso. |
get_answers |
Lo storico delle tue risposte, dalla più recente: la domanda, la tua risposta, la risposta corretta, il commento e la frase della fonte. Filtra per studio, argomento, data o solo errori. |
get_weak_spots |
I tuoi argomenti più deboli, i concetti che continui a sbagliare e quanti errori hai fatto di recente. |
get_due |
Cosa c’è da ripassare ora, cosa scade nelle prossime 24 ore e quando è il prossimo ripasso, per studio. |
get_progress |
Risposte e percentuale di risposte giuste al giorno, la tua serie attuale e come è cambiata la tua padronanza di ogni argomento esercitato, su un massimo di 180 giorni. |
S256). I token di accesso scadono dopo 1 ora e i refresh token cambiano a ogni uso. I client si registrano da soli (RFC 7591), quindi la maggior parte completa tutto il flusso in autonomia.Sì. In ChatGPT apri Plugins, seleziona + e aggiungi PupilBot come server MCP personalizzato, poi accedi e approva. ChatGPT potrà leggere i tuoi studi, le risposte, gli errori, i ripassi in scadenza e i progressi giorno per giorno.
Sì. In Claude aggiungilo come connettore personalizzato. In Claude Code e Codex basta un comando nel terminale. Funziona anche qualsiasi altra app che supporta server MCP remoti con accesso OAuth.
No. Gli strumenti leggono il tuo storico e possono creare uno studio da un testo, ma non possono rispondere alle domande né cambiare i tuoi punteggi. Ti eserciti nella web app, nell’app per iPhone o su Telegram.
No. Il collegamento è gratis con qualsiasi account PupilBot, e leggere i tuoi dati non avvia nessun modello di IA da parte di PupilBot. Uno studio creato dalla tua IA conta nel tuo normale limite di studi.
Apri le Impostazioni nella web app di PupilBot e rimuovi l’app dalle app di IA collegate. Il suo accesso si ferma subito.
Streamable HTTP, senza stato: una richiesta JSON-RPC 2.0 per POST, una risposta JSON. Nessuno stream SSE, nessun id di sessione, nessun batching JSON-RPC. Un GET che chiede text/event-stream, e qualsiasi DELETE, rispondono 405 — è questo che dice al client di ripiegare su semplici POST; un GET che non chiede lo stream ottiene questa pagina. Versioni del protocollo: 2025-06-18, 2025-03-26, 2024-11-05.
Discovery: /.well-known/oauth-authorization-server (RFC 8414) e /.well-known/oauth-protected-resource (RFC 9728). Un POST non autenticato risponde 401 con una sfida WWW-Authenticate che nomina il secondo.
/openapi.json — descrizione OpenAPI 3.1 di questo endpoint e del suo flusso OAuth./mcp/server-card e /.well-known/ai-catalog.json — discovery prima della connessione (MCP Server Card, SEP-2127)./mcp.md — questa pagina in markdown.