> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gocromo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connettori e integrazioni

> Porta contesto esterno in Cromo e consenti ai progetti di utilizzare strumenti approvati in sicurezza.

Connettori e integrazioni consentono a un Progetto di leggere dati da sistemi esterni o di agire attraverso di essi. Cromo offre due modelli di connessione complementari.

## Integrazioni gestite

Le integrazioni gestite collegano comuni applicazioni aziendali attraverso un flusso di autorizzazione. Cromo si integra con:

* Google Drive e Gmail;
* Microsoft OneDrive, OneNote e Outlook;
* Notion;
* Slack;
* GitHub.

Dopo aver collegato un'applicazione, seleziona file, cartelle, filtri email o altre risorse che appartengono al Progetto, quindi imposta filtri e pianificazione della sincronizzazione.

Il contenuto sincronizzato entra nella pipeline Fonti, conservando l'origine esterna prima che qualsiasi proposta Conoscenza venga revisionata.

## Connettori MCP

Un connettore MCP collega a Cromo un server Model Context Protocol. Può esporre:

* **Strumenti** che l'assistente o un flusso di lavoro possono richiamare;
* **Risorse** che forniscono contesto;
* **Prompt** messi a disposizione dal server.

Cromo si collega ai server MCP tramite Streamable HTTP.

Per i server con molti strumenti puoi nascondere l'elenco completo dietro la ricerca. In questo modo riduci il contesto attivo dell'assistente senza impedirgli di trovare un'operazione pertinente.

## Autenticazione

Un connettore MCP può usare:

* nessuna autenticazione;
* un bearer token;
* header personalizzati.

I valori segreti sono cifrati a riposo e non vengono più mostrati dopo il salvataggio. Conserva la credenziale originale nel password manager o nel sistema di gestione dei segreti.

<Warning>
  Considera un connettore come un permesso operativo, non soltanto come una sorgente dati. Uno strumento che può creare, aggiornare, inviare o eliminare record esterni richiede credenziali più ristrette e test più approfonditi di una risorsa di sola lettura.
</Warning>

## Accesso di progetti e Workspace

Gli Admin del Workspace scelgono il livello di accesso di ogni progetto a una connessione: nessun accesso, accesso in lettura o accesso completo.

Gli utenti devono inoltre disporre del ruolo Cromo appropriato:

* i Viewer possono vedere le informazioni sui connettori;
* i Member possono usare i connettori approvati;
* Admin e Owner possono creare e gestire la configurazione dei connettori.

## Test prima dell'utilizzo

Prima di fare affidamento su un connettore:

1. verifica la connessione;
2. esamina Strumenti, Risorse e Prompt rilevati da Cromo;
3. verifica che la credenziale appartenga all'account previsto;
4. esegui un'operazione di sola lettura;
5. se servono scritture, prova una singola operazione sicura;
6. documenta responsabilità e procedure di rotazione.

Per un flusso di lavoro avviato da webhook, prova separatamente il webhook del flusso di lavoro e il connettore richiamato dal flusso di lavoro.

## Esempi di connessione

### Da Google Drive a Conoscenza

Sincronizza le procedure operative correnti da una cartella Drive approvata. Revisiona la Conoscenza generata prima di usarla nella Chat o nei flussi di lavoro.

### Da Gmail alla gestione dei reclami

Usa una connessione Gmail filtrata per i messaggi di reclamo. Conserva l'email originale come evidenza, crea un record Ticket e mantieni in bozza le risposte destinate al cliente.

### CRM tramite MCP

Usa uno strumento CRM di sola lettura per esaminare lead o clienti durante la convalida del processo. Aggiungi accesso in scrittura con ambito ristretto solo dopo aver testato mappature dei campi ed effetti collaterali.

Esempio di prompt collegato:

```text theme={null}
Usando il connettore CRM e la Qualification Policy, revisiona i nuovi lead
creati oggi. Consiglia qualificazione, responsabile e prossima azione con
citazioni della policy. Restituisci prima gli aggiornamenti proposti; non
scrivere nel CRM.
```

Mantieni separate la sincronizzazione delle Fonti, l'accesso operativo dei connettori e i permessi dei flussi di lavoro, affinché possano essere revisionati indipendentemente.

<Card title="Collega un'app o un server MCP" icon="plug" href="/it/guides/connect-an-app-or-mcp-server">
  Segui l'intero processo di connessione, verifica, minimo privilegio e risoluzione dei problemi.
</Card>