# Collegare il vostro assistente IA

Simafri ERP si collega al vostro assistente IA tramite **MCP** (Model Context Protocol), il protocollo aperto che parlano Claude, ChatGPT e i principali assistenti. Una volta collegato, il vostro assistente tiene la vostra gestione insieme a voi: prepara i vostri preventivi, emette le vostre fatture, registra i vostri incassi, prepara i vostri solleciti, registra i vostri acquisti e riconcilia la vostra banca, su tutte le società del vostro account.

|                               |                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------ |
| **Server MCP di Simafri ERP** | `https://erp-mcp.simafri.com/mcp`                                                    |
| **Trasporto**                 | HTTP streamable                                                                      |
| **Collegamento**              | connettore autorizzato dal vostro spazio [erp.simafri.com](https://erp.simafri.com/) |

## Che cosa fa il vostro assistente con la vostra gestione

| Ambito                      | Che cosa fa l'assistente                                                                                                                                                     |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vendite**                 | prepara un preventivo, una fattura o una nota di credito, aggiunge e rimuove righe, emette il documento con la sua numerazione, trasforma un preventivo accettato in fattura |
| **Fatturazione ricorrente** | prepara una fattura che ritorna ogni mese o ogni anno, la sospende, la riprende, produce la scadenza del giorno                                                              |
| **Incassi**                 | registra un incasso, lo imputa a una o più fatture, crea un link di pagamento online, avvia i solleciti delle fatture scadute                                                |
| **Acquisti**                | registra una fattura ricevuta, la ripartisce per aliquota IVA, registra e imputa il pagamento al fornitore                                                                   |
| **Banca**                   | carica un estratto conto, riconcilia ogni movimento con l'incasso o il pagamento corrispondente, mette da parte un movimento senza giustificativo                            |
| **Magazzino**               | legge la giacenza di ogni articolo, registra un carico, uno scarico o un inventario, regola la soglia di avviso                                                              |
| **Contabilità**             | legge il piano dei conti e la sua mappatura, esporta il giornale di un periodo per il vostro commercialista                                                                  |
| **Clienti, catalogo e CRM** | crea e aggiorna un cliente, un fornitore o un articolo, tiene le vostre campagne di prospezione e lo storico di ogni contatto                                                |
| **Giustificativi**          | allega una scansione a un documento e rilegge un giustificativo già allegato                                                                                                 |
| **Visione d'insieme**       | legge le vostre società, le loro impostazioni di fatturazione, le loro valute e i loro tassi di cambio                                                                       |

Ciò che il vostro assistente registra è registrato esattamente come sullo schermo: stessa numerazione, stessi controlli, stesso registro delle attività, a nome del vostro account.

### Che cosa potete chiedergli

* «Fai un preventivo alla società Martin per tre giornate di formazione, al prezzo di catalogo.»
* «Il preventivo D-2026-0142 è accettato: trasformalo in fattura, emettila e crea il link di pagamento.»
* «Chi mi deve dei soldi, e da quando? Avvia i solleciti previsti.»
* «Ecco l'estratto conto del mese: caricalo e riconcilia ciò che si può riconciliare.»
* «Registra la fattura del fornitore allegata, ripartita al 20 %, e prepara il suo pagamento.»
* «Esporta il giornale del trimestre per il mio commercialista.»

## 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 vostro assistente, aggiungete un **connettore personalizzato** e indicategli l'indirizzo `https://erp-mcp.simafri.com/mcp`.

2. L'assistente apre il vostro spazio [erp.simafri.com](https://erp.simafri.com/): accedete con un accesso di rango **Propriétaire** (Proprietario).

3. La pagina di autorizzazione mostra il programma che chiede l'accesso e l'indirizzo verso cui vi riporterà. Scegliete **che cosa potrà fare**:

   <!-- -->

   * **Lecture seule** (Sola lettura): consulta i vostri libri;
   * **Lecture et écriture** (Lettura e scrittura): consulta e registra, come fareste voi sullo schermo.

4. Fate clic su **Autoriser** (Autorizzare). Gli strumenti di Simafri ERP compaiono nel vostro assistente: chiedetegli, per esempio, l'elenco delle vostre fatture del mese.

Il collegamento vale per **tutte le società dell'account**, comprese quelle che aprirete in seguito. Collegare lo stesso assistente una seconda volta aggiorna il collegamento esistente.

## Collegarsi tramite chiave

Per un programma in cui impostate voi stessi le intestazioni (Claude Code, un programma della vostra azienda), Simafri ERP si collega anche tramite **chiave API**. Rivolgete la richiesta al vostro **canale di assistenza Simafri** precisando la portata desiderata, lettura o scrittura: vi consegniamo la chiave. Con Claude Code:

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

## Vedere e rimuovere un collegamento

La schermata **Connecteurs** (Connettori), nel gruppo **Le compte** (Il conto) del menu di sinistra, elenca i programmi collegati al vostro account. Ogni riga indica il programma, che cosa può fare, la persona che lo ha autorizzato, la data del collegamento e il suo ultimo utilizzo.

**Révoquer** (Revocare) interrompe il collegamento immediatamente e completamente: il programma perde l'accesso nello stesso istante, su tutte le vostre società. Per collegarlo di nuovo, basta ripetere l'autorizzazione.

## Vi diamo una mano

Passate dal vostro **canale di assistenza Simafri** indicando l'assistente che usate: vi accompagniamo nel collegamento.
