Microsoft Word su MCP: trova, leggi e organizza i documenti Word in OneDrive e SharePoint da qualsiasi agente AI

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

Word (Microsoft 365)

Fai lavorare la tua AI con i documenti Word in OneDrive e SharePoint: trova documenti, leggi dettagli, cronologia delle versioni e chi ha accesso, ottienili in PDF o come file originale, crea nuovi documenti da un modello, rinomina, sposta, fai check-out e check-in e ripristina una versione precedente. Microsoft 365 tramite Microsoft Graph, con accesso dal tuo account Microsoft; link di condivisione ed eliminazione sono disattivati all'installazione.

Setup

La configurazione richiede circa 10 minuti. Ti servono l'account Microsoft nel cui OneDrive o SharePoint si trovano i documenti e una registrazione di app gratuita in Microsoft Entra.

1. Apri https://entra.microsoft.com (o https://portal.azure.com) e vai su Applications → App registrations → New registration.

2. Dai un nome all'app, ad esempio "AnythingMCP Microsoft 365", e scegli i Supported account types. Da questa scelta dipende il valore di MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (single tenant): il Directory (tenant) ID dalla pagina Overview dell'app (un GUID) o il tuo dominio, come contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multi-tenant): organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: common (account aziendali, scolastici e personali) o consumers (solo account personali).

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

3. In Redirect URI scegli la piattaforma Web e inserisci <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Deve coincidere 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 Files.ReadWrite. Aggiungi anche Files.ReadWrite.All se l'AI deve raggiungere documenti in SharePoint, in Teams o condivisi con te (vedi Scope).

5. Apri Certificates & secrets → New client secret e 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 incolli uno nuovo.

6. Incolla l'Application (client) ID 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 Authorize with Provider e accedi con l'account con i cui documenti l'AI deve lavorare. Il refresh token viene salvato cifrato e gli access token (validi circa un'ora) si rinnovano da soli.

8. Esegui microsoft_word_get_my_drive: mostra a quale OneDrive è collegato il connettore.

Una sola app Entra per tutti i connettori Microsoft: la registrazione creata per il connettore Outlook, OneDrive o Excel funziona anche qui. Aggiungi i permessi del passo 4, mantieni lo stesso redirect URI e riusa lo stesso client ID, secret e tenant. Ogni connettore chiede solo i propri scope quando lo autorizzi.

Consenso dell'amministratore: questi permessi delegati di norma 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 API permissions → Grant admin consent per l'organizzazione.

Di chi sono i documenti che vede: tutto avviene come l'utente che ha autorizzato il connettore, quindi l'AI vede e modifica esattamente ciò che può quell'utente. Gli account aziendali o scolastici (Microsoft 365) supportano tutti i tool; un OneDrive personale supporta ricerca, dettagli, download, PDF, copia, rinomina e spostamento.

Scope: il connettore chiede offline_access User.Read Files.ReadWrite. offline_access fa sì che Microsoft rilasci un refresh token, Files.ReadWrite copre il tuo OneDrive. Per documenti in librerie SharePoint, in canali Teams o condivisi da altre persone, e per microsoft_word_find_documents, aggiungi Files.ReadWrite.All alla registrazione dell'app, sostituisci Files.ReadWrite con questo nelle impostazioni OAuth del connettore e autorizza di nuovo. Per una configurazione in sola lettura usa offline_access User.Read Files.Read.All, autorizza di nuovo e disattiva microsoft_word_copy_document, microsoft_word_rename_document, microsoft_word_move_document, microsoft_word_restore_version, microsoft_word_check_out e microsoft_word_check_in.

Cosa legge: documenti Word (.docx, .docm e il vecchio .doc). Li trova per nome e contenuto nel tuo OneDrive (microsoft_word_search_my_documents, che restituisce anche altri tipi di file), per percorso come Documents/Contracts/Offer 2026.docx, sfogliando le cartelle oppure ovunque tu abbia accesso (OneDrive, SharePoint, Teams, condivisi con te) con Microsoft Search e KQL in microsoft_word_find_documents, solo con account aziendale o scolastico. Per ogni documento legge nome, dimensione, chi lo ha creato e modificato per ultimo e quando, il webUrl che lo apre in Word per il Web, lo stato di check-out, la cronologia delle versioni e chi ha accesso. Per leggere il contenuto, microsoft_word_convert_to_pdf fa convertire il documento da Microsoft 365 in un PDF che l'AI può leggere: Graph non ha un'API che restituisca il testo di un documento. microsoft_word_download_document e microsoft_word_download_version consegnano il file originale o una versione precedente.

Cosa scrive: Graph non può scrivere dentro un documento e il connettore non può caricare file. Un nuovo documento nasce copiando un modello con microsoft_word_copy_document con un nuovo nome; la copia avviene in background e compare nella cartella di destinazione dopo qualche secondo. Il connettore inoltre rinomina i documenti, li sposta nello stesso drive, rende di nuovo attuale una versione precedente con microsoft_word_restore_version (il contenuto sostituito resta nella cronologia, quindi si può annullare; solo account aziendali o scolastici) e fa check-out e check-in con commento nelle librerie SharePoint che lo richiedono. Il documento poi lo modifichi tu tramite il suo webUrl.

Disattivati all'installazione: microsoft_word_create_sharing_link (un link view o edit per anonymous, organization o users) e microsoft_word_delete_document. Un link di condivisione consegna il file ad altre persone, e un documento letto dall'AI potrebbe chiederle di condividere o eliminare qualcosa, quindi un admin li attiva quando il team ne ha bisogno. I documenti eliminati finiscono nel cestino e lì si possono ripristinare.

Formati dei dati: ogni tool prende drive_id e item_id del documento. Ricerca e lookup per percorso li restituiscono come id e parentReference.driveId; in microsoft_word_find_documents i risultati stanno in hitsContainers[0].hits[], con resource.id e resource.parentReference.driveId. microsoft_word_list_folder con item_id root elenca il livello più alto di un drive. Gli ID di versione sono come 4.0 e arrivano dal più recente. I file, PDF compresi, vengono allegati fino a 10 MB; quelli più grandi vengono descritti ma non allegati, e l'AI ti dà invece il webUrl. La conversione in PDF funziona per file .docx, .docm, .doc, .dotx, .odt e .rtf e non modifica il file salvato.

Paginazione e limiti: le risposte di elenchi e ricerche contengono @odata.nextLink finché ci sono altri risultati; l'AI richiama lo stesso tool con skip_token uguale al valore $skiptoken di quel link. microsoft_word_find_documents pagina con from e size, e moreResultsAvailable dice se ce ne sono altri. Microsoft Graph limita le richieste per utente e per app: un 429 o 503 con Retry-After significa aspettare e riprovare. Convertire in PDF un documento grande può richiedere qualche secondo.

Errori comuni: 401 InvalidAuthenticationToken significa che l'autorizzazione è stata revocata o che il client secret è scaduto: se serve incolla un nuovo secret e clicca di nuovo Authorize with Provider. 403 accessDenied significa che manca un permesso o il consenso, oppure che il documento è di qualcun altro e lo scope non include Files.ReadWrite.All; microsoft_word_find_documents risponde 403 senza Files.Read.All o Files.ReadWrite.All. 404 itemNotFound è un ID di drive, elemento o versione sbagliato, o un elemento eliminato. 406 o 415 sulla conversione in PDF significa che il tipo di file non si può convertire o che il file è protetto da password. 409 nameAlreadyExists significa che il nome è già usato in quella cartella: scegline un altro o imposta conflict_behavior su rename. 423 resourceLocked significa che il file è in check-out da un'altra persona o bloccato per la modifica.

Il connettore non carica file Word, non ne modifica il contenuto, non legge né aggiunge commenti e revisioni e non gestisce siti SharePoint (lo fa il connettore Microsoft SharePoint).

Prerequisiti: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Word (Microsoft 365) e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Trova in SharePoint il contratto quadro con Contoso e riassumi le condizioni di pagamento e di recesso."
• "Crea una nuova offerta da Templates/Offer template.docx nella cartella Offerte 2026 e chiamala Offerta Acme 2026.docx."
• "Chi ha accesso a Documents/Contracts/NDA Acme.docx, e c'è un link anonimo?"
• "Mostrami la cronologia delle versioni di questo documento e ripristina la versione salvata lunedì scorso."
• "Fai il check-out della policy viaggi nella libreria HR così posso modificarla, e dammi il link per aprirla in Word."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT