# Collegare il Suo assistente IA

La posta di Simafri Suite si collega al Suo assistente IA tramite **MCP** (Model Context Protocol), il protocollo aperto che parlano Claude, ChatGPT e i principali assistenti. Una volta collegato, il Suo assistente gestisce la posta per Lei: legge, cerca, risponde, scrive, archivia e programma i Suoi invii, nelle Sue caselle, a Suo nome.

|                            |                                                                  |
| -------------------------- | ---------------------------------------------------------------- |
| **Server MCP della posta** | `https://suite-mcp.simafri.com/mcp`                              |
| **Trasporto**              | HTTP streamable                                                  |
| **Collegamento**           | il Suo account Simafri Suite (connettore), oppure una chiave API |

## Che cosa fa il Suo assistente con le Sue e-mail

| Gesto                              | Che cosa fa l'assistente                                                                                                                      |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Leggere**                        | scorre le Sue caselle e le loro cartelle, i messaggi non letti, un'intera discussione con i suoi allegati                                     |
| **Leggere gli allegati**           | il testo di un PDF, di un documento Word, di un foglio di calcolo Excel, di una presentazione, di un file compresso; le immagini, che osserva |
| **Cercare**                        | in una casella, per oggetto, testo, corrispondente o nome del file allegato                                                                   |
| **Rispondere e scrivere**          | risponde in una discussione, al mittente o a tutti, scrive un nuovo messaggio, con copie, copie nascoste e allegati                           |
| **Inoltrare**                      | inoltra un messaggio a un'altra persona, allegati compresi                                                                                    |
| **Programmare**                    | fissa l'ora di partenza di un messaggio, elenca gli invii programmati e ne richiama uno                                                       |
| **Archiviare**                     | sposta una discussione nell'archivio, nel cestino o in arrivo, la segna come letta o non letta                                                |
| **Smistare la posta indesiderata** | segnala uno spam e blocca il suo mittente, annulla l'iscrizione a una newsletter                                                              |
| **Bozze**                          | salva un messaggio da finire, lo riprende, lo elimina                                                                                         |
| **Firma e contatti**               | imposta la firma di un indirizzo, consulta e tiene la rubrica                                                                                 |
| **Scaricare**                      | va a prendere la posta subito                                                                                                                 |

Ciò che il Suo assistente invia parte dai Suoi indirizzi, con la firma DKIM del Suo dominio, e viene riposto in **Inviata**, esattamente come un messaggio scritto su [suite.simafri.com](https://suite.simafri.com/).

### Che cosa può chiedergli

* «Riassumi i messaggi non letti di `contatto@` da lunedì, e dimmi quali aspettano una risposta.»
* «Rispondi a Camille che il preventivo parte domani, allega il PDF ricevuto ieri e programma l'invio alle 8.»
* «Archivia tutte le notifiche di consegna di questo mese.»
* «Ritrova il contratto che Julien mi ha mandato in primavera e dimmi la sua data di scadenza.»
* «Annulla la mia iscrizione a questa newsletter e segnala gli ultimi due spam.»

## Collegarsi tramite connettore

È la via più semplice: niente da copiare, niente da incollare. Serve gli assistenti che aggiungono un server MCP tramite il suo indirizzo, come i connettori di Claude e di ChatGPT.

1. Nel Suo assistente, aggiunga un **connettore personalizzato** e gli indichi l'indirizzo `https://suite-mcp.simafri.com/mcp`.
2. L'assistente apre [suite.simafri.com](https://suite.simafri.com/): acceda come di consueto, con l'indirizzo della Sua casella o la Sua identità Simafri.
3. La pagina di autorizzazione mostra l'applicazione che chiede l'accesso: confermi l'autorizzazione.
4. Gli strumenti della Sua posta compaiono nel Suo assistente. Gli chieda, per esempio, di elencare i Suoi ultimi messaggi.

Ogni persona del team collega il proprio assistente, qualunque sia il suo ruolo nell'account, e quel collegamento agisce per lei.

## Collegarsi tramite chiave

Per un assistente in cui imposta Lei stesso le intestazioni (Claude Code, Claude Desktop, un client MCP della Sua azienda), il collegamento avviene tramite **chiave API**.

1. Il titolare dell'account apre [suite.simafri.com](https://suite.simafri.com/), **Impostazioni**, **Chiavi API**, e crea una chiave.
2. **Copi subito la chiave**: viene mostrata una sola volta.
3. Aggiunga il server al Suo assistente, con la chiave nell'intestazione `Authorization`. Con Claude Code:

```
claude mcp add --transport http --scope user simafri-suite https://suite-mcp.simafri.com/mcp --header "Authorization: Bearer LA_SUA_CHIAVE"
```

Una chiave agisce per l'intero account: serve l'automazione dell'azienda, come un programma che smista la posta di tutte le caselle. Per l'assistente di una persona, il connettore è la via maestra.

## Che cosa raggiunge il Suo assistente

Un assistente collegato tramite connettore lavora **con i Suoi diritti**: vede ciò che il Suo schermo Le mostra.

* **Le Sue caselle**: quelle che Lei consulta, la Sua e le caselle condivise che Le sono affidate, come `contatto@`. Ogni casella si apre alle persone che la consultano, e con loro al loro assistente.
* **I Suoi invii**: partono da un indirizzo che Lei consulta.
* **Le impostazioni dell'account** (chi consulta quale casella, gli inviti, la rubrica comune) seguono il Suo ruolo, come sullo schermo.
* **Il Suo letto e non letto** resta Suo: in una casella condivisa, ciò che il Suo assistente segna come letto resta letto solo per Lei.

## Vedere e interrompere un collegamento

La schermata **Applicazioni collegate** elenca i Suoi collegamenti: la apra dal menu del Suo account, in alto a destra su [suite.simafri.com](https://suite.simafri.com/). Ogni riga indica l'applicazione, la data dell'autorizzazione e l'ultima volta in cui è stata usata.

Scollegare un'applicazione interrompe il suo collegamento immediatamente e completamente: l'assistente perde l'accesso nello stesso istante.

* Ogni persona vede e interrompe **i collegamenti che ha autorizzato**.
* Il **titolare dell'account** vede e interrompe **tutti i collegamenti dell'account**, con il nome della persona che ha autorizzato ciascuno. Quando un collaboratore se ne va, un solo gesto chiude l'accesso del suo assistente.
* Una chiave API si revoca da **Impostazioni**, **Chiavi API**.

## Il server MCP dell'account: indirizzi, domini, archiviazione

Un secondo server MCP porta l'**account** Simafri stesso, ciò che Lei fa su [my.simafri.com](https://my.simafri.com/). Si collega allo stesso modo, tramite connettore, con la Sua identità Simafri:

|                             |                                  |
| --------------------------- | -------------------------------- |
| **Server MCP dell'account** | `https://mcp.simafri.com/v1/mcp` |

Lì il titolare dell'account affida al proprio assistente la gestione di Simafri Suite:

* **gli indirizzi**: rivedere la riserva e gli indirizzi, creare un indirizzo con la sua password, assegnare una nuova password, chiudere un indirizzo. La scheda di accesso compare una volta, perché il titolare la consegni alla persona;
* **i domini**: le righe DNS dell'instradamento della posta, la loro verifica, e il passaggio di DMARC a una politica più rigorosa;
* **l'archiviazione**: la stima di un'aggiunta, poi la proforma, che il titolare salda come di consueto.

Lo stesso server porta anche i Suoi [siti Serenity](https://docs.simafri.com/it/serenity/) e i Suoi VPS. Colleghi i due server allo stesso assistente: gestirà così il Suo account e la Sua posta.

## Le diamo una mano

Scriva a <support@simafri.com> indicando l'assistente che usa: La accompagniamo nel collegamento.
