> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano/21.-outlook-mcp-server.md).

# 21. Outlook MCP Server

**Outlook MCP Server** collega una casella di posta Microsoft Outlook / Microsoft 365 al tuo Agente: legge e cerca email, legge e scarica allegati, invia messaggi, gestisce calendario e contatti, sempre per conto dell'utente connesso.

## Cosa può fare

* Cercare e leggere email (per mittente, oggetto, intervallo di date, cartella);
* Leggere gli allegati ed **estrarne il testo** (PDF, Word, Excel, immagini tramite riconoscimento visivo);
* Comporre e inviare email in testo semplice o HTML;
* Visualizzare e creare eventi del calendario.

## Esempi

*"Trova le ultime 5 email di Mario Rossi e riassumile."*\
\
*"Scarica l'allegato dell'ultima fattura e dimmi importo e data di scadenza."*\
\
"*Scrivi un'email a* [*client@example.com*](mailto:client@example.com) *per confermare la riunione di domani alle 15:00."*

## Come funziona l'accesso

Ogni utente collega la propria casella di posta con un accesso Microsoft sicuro (non condividi mai una password con l'Agente).

Avviene in chat: l'Agente offre un pulsante di accesso, l'utente effettua l'accesso con Microsoft e concede le autorizzazioni. Da quel momento l'Agente opera **solo** sulla casella di posta di quell'utente.

### **È sicuro?**

Assolutamente! Il tuo **account email è collegato in modo sicuro** tramite il sistema di accesso ufficiale di Microsoft (OAuth) e l'assistente **non memorizza né vede mai la password dell'utente.**

## Parametri di configurazione

| Parametro          | Obbligatorio | Descrizione                                                                                                                                                                                                                                                                             |
| ------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MS_TENANT_ID`     | Sì           | ID della directory (tenant) Microsoft Entra (Azure AD).                                                                                                                                                                                                                                 |
| `MS_CLIENT_ID`     | Sì           | ID client della registrazione dell'app Azure dedicata a Outlook.                                                                                                                                                                                                                        |
| `MS_CLIENT_SECRET` | No           | Segreto client della registrazione dell'app. Non richiesto se l'app è configurata come "client pubblico" su Azure.                                                                                                                                                                      |
| `IDENTITY STRICT`  | No           | `true`/`false`. Predefinito: `true`. L'account Outlook collegato deve corrispondere all'email dell'utente AIsuru nella chat (IDENTITY STRICT deve essere true). Se true, le azioni verranno eseguite solo quando l'email dell'account AIsuru corrisponde a quella dell'account Outlook. |

### Parametri personalizzati

Non sono necessari parametri aggiuntivi.

### Parametri di configurazione: registra un'app Microsoft (Azure)

1. Apri il **portale Azure** ([portal.azure.com](http://portal.azure.com/)) e vai a **Microsoft Entra ID → Registrazioni app → Nuova registrazione;**
2. Assegnale un nome (ad es. "AIsuru Outlook") e scegli i tipi di account adatti al tuo caso;
3. In **Autenticazione** aggiungi una piattaforma *Web* con URI di reindirizzamento `https://mcp.aisuru.ai/oauth/verify` e abilita i token di accesso;
4. In **Autorizzazioni API → Microsoft Graph (delegate)** aggiungi: `Mail.ReadWrite`, `Mail.Send`, `Calendars.ReadWrite`, `offline_access`, `User.Read`, quindi concedi il consenso dell'amministratore;
5. Copia l'**ID applicazione (client)** e l'**ID directory (tenant)** dalla pagina Panoramica;
6. (Facoltativo) In **Certificati e segreti** crea un *nuovo segreto client* e copiane immediatamente il valore (mostrato una sola volta), quindi incollalo come MS\_CLIENT\_SECRET.

{% hint style="info" %}
**Nota:** per la maggior parte degli utilizzi non devi creare nulla: è sufficiente l'accesso a Microsoft nella chat. Questa configurazione tecnica è solo per chi desidera usare la propria **app Azure aziendale** (consigliata per le aziende).
{% endhint %}
