Come collegare Microsoft OneNote a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → OneNote (Microsoft 365), inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Microsoft OneNote + ChatGPT

Fai lavorare la tua AI in OneNote: sfoglia blocchi appunti, sezioni e pagine, leggi le pagine, crea blocchi appunti, sezioni e pagine e aggiungi note alle pagine esistenti. OneNote aziendale o scolastico e OneNote personale tramite Microsoft Graph, con il tuo account Microsoft.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Step 1 — Ottieni le credenziali

1. Apri l'interfaccia di amministrazione di Microsoft Entra (entra.microsoft.com) o il portale di Azure e vai su Applications → App registrations → New registration.

2. Dai un nome all'app (per esempio "AnythingMCP Microsoft 365") e scegli i Supported account types. La scelta determina cosa va in MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (single tenant): possono accedere solo gli utenti della tua organizzazione. Usa la Directory (tenant) ID dalla pagina Overview dell'app (un GUID) o il tuo dominio, per esempio contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multi-tenant): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common (account aziendali, scolastici e personali) oppure consumers (solo account personali).

   Se il valore non corrisponde al tipo di account, Microsoft rifiuta l'accesso (AADSTS50194 o AADSTS50020).

3. In Redirect URI scegli la piattaforma Web e inserisci https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback. L'URI deve corrispondere carattere per carattere, altrimenti Microsoft risponde AADSTS50011.

4. Apri API permissions → Add a permission → Microsoft Graph → Delegated permissions e aggiungi offline_access, User.Read e Notes.ReadWrite. offline_access fa sì che Microsoft rilasci un refresh token; senza, il connettore smette di funzionare un'ora dopo l'autorizzazione.

5. Apri Certificates & secrets → New client secret. Copia il Value del secret, non il Secret ID; viene mostrato una sola volta. Annota la data di scadenza: quando il secret scade, il connettore smette di funzionare finché non ne crei uno nuovo e lo inserisci.

6. Inserisci l'Application (client) ID dalla pagina Overview in MICROSOFT_CLIENT_ID, il valore del secret in MICROSOFT_CLIENT_SECRET e il valore del tenant del passo 2 in MICROSOFT_TENANT_ID, poi installa il connettore.

7. Nella pagina del connettore clicca su Authorize with Provider e accedi con l'account di cui l'AI deve usare i blocchi appunti. Il refresh token è salvato cifrato e gli access token (validi circa un'ora) vengono rinnovati automaticamente.

8. Comincia con microsoft_onenote_list_notebooks: elenca i blocchi appunti che il connettore può aprire e il tuo ruolo in ciascuno (proprietario, collaboratore o lettore).

Una sola app Entra per tutti i connettori Microsoft: la registrazione dell'app che hai creato per il connettore Outlook, OneDrive, SharePoint o Excel funziona anche qui. Aprila, aggiungi il permesso del passo 4 in API permissions, mantieni lo stesso URI di reindirizzamento e riusa lo stesso client ID, lo stesso secret e lo stesso tenant. Ogni connettore chiede solo i propri permessi quando lo autorizzi:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (più Files.ReadWrite.All per le cartelle di lavoro in SharePoint o condivise con te)
• SharePoint: Sites.ReadWrite.All e Files.ReadWrite.All
• OneNote: Notes.ReadWrite
• Microsoft To Do: Tasks.ReadWrite
• Planner: Tasks.ReadWrite

Tutti richiedono anche offline_access e User.Read.

Consenso dell'amministratore: questi permessi delegati di solito non richiedono un amministratore, ma molte organizzazioni disattivano il consenso degli utenti. Se l'accesso mostra "Need admin approval" (AADSTS65001 o AADSTS90094), un amministratore del tenant apre una volta la registrazione dell'app e clicca su API permissions → Grant admin consent per l'organizzazione. Da quel momento ogni utente può autorizzare. Ogni connettore lavora comunque solo con ciò che può vedere l'account che ha effettuato l'accesso.

Blocchi appunti condivisi con te: Notes.ReadWrite copre i tuoi blocchi appunti. Per lavorare nei blocchi appunti che i colleghi hanno condiviso con te (account aziendali o scolastici), aggiungi Notes.ReadWrite.All alla registrazione dell'app, usalo al posto di Notes.ReadWrite nelle impostazioni OAuth del connettore e autorizza di nuovo.

Solo lettura: sostituisci gli scope nelle impostazioni OAuth del connettore con offline_access User.Read Notes.Read, autorizza di nuovo e disattiva microsoft_onenote_create_notebook, microsoft_onenote_create_section, microsoft_onenote_create_page, microsoft_onenote_append_to_page e microsoft_onenote_update_page.

Le modifiche aspettano il tuo sì: prima di creare un blocco appunti, una sezione o una pagina, o di modificare una pagina, l'AI ti dice cosa sta per scrivere e dove, e aspetta il tuo sì.

Disattivato all'installazione: microsoft_onenote_delete_page. Il connettore non può annullare un'eliminazione, quindi attivalo solo se l'AI deve davvero eliminare pagine.

Trovare e leggere le pagine: un blocco appunti contiene sezioni, eventualmente raccolte in gruppi di sezioni, e ogni sezione contiene pagine. L'AI può cercare nei titoli delle pagine e filtrare per data dell'ultima modifica, ma Microsoft Graph non cerca nel testo delle pagine: l'AI apre quindi le pagine più probabili e le legge. Le immagini di una pagina si aprono solo con il tuo accesso, l'input penna non è incluso e le pagine molto lunghe vengono tagliate a circa 200 KB. Se hai moltissimi elementi in OneNote, l'elenco delle pagine di tutti i blocchi appunti può fallire con l'errore 10008; l'AI procede allora sezione per sezione.

Scrivere le pagine: le nuove pagine accettano una formattazione semplice: titoli, elenchi, tabelle, link, caselle di controllo per le attività e immagini da un indirizzo web pubblico. microsoft_onenote_append_to_page è il modo più semplice per aggiungere note in fondo a una pagina. Una pagina nuova ha bisogno di qualche secondo prima che OneNote accetti modifiche: se un'aggiunta subito dopo la creazione risponde 404, l'AI aspetta un attimo e riprova.

Errori comuni: 401 InvalidAuthenticationToken significa che l'autorizzazione è stata revocata o che il client secret è scaduto; se serve inserisci un nuovo secret e clicca di nuovo su Authorize with Provider. 403 (codice 40004 o 40002) significa che manca Notes.ReadWrite o che non è stato dato il consenso, oppure che il blocco appunti è condiviso con te in sola lettura. 404 (o codice 20102 o 20112) significa che l'id è sbagliato o che l'elemento è stato eliminato. 20117 significa che lì esiste già un blocco appunti o una sezione con quel nome; 20115, 20153 o 20155 significano che il nome contiene un carattere non ammesso o è troppo lungo (128 caratteri per i blocchi appunti, 50 per le sezioni). 30105 o 30108 significano che il tuo OneDrive for Business non è ancora configurato: apri OneDrive una volta, oppure chiedi al tuo amministratore di controllare la licenza. 429 significa che Microsoft Graph sta limitando l'account: aspetta un momento e riprova.

Il connettore non carica immagini o file nelle pagine, non gestisce l'input penna, non copia pagine o sezioni e non apre i blocchi appunti dei gruppi Microsoft 365 o dei siti SharePoint.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Microsoft OneNote.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Quali blocchi appunti OneNote ho, e quali sezioni ci sono nel blocco Lavoro?"
• "Trova le mie pagine dell'ultimo mese con budget nel titolo e riassumi cosa dicono."
• "Crea nella sezione Riunioni una pagina Kickoff Acme con questi appunti e una casella di controllo per ogni azione da fare."
• "Aggiungi alla pagina Chiamata fornitore: venerdì risentire Anna per la data di consegna."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse