Come funzionano le integrazioni

Ogni integrazione di Aymar Agents — un connettore nativo, un server MCP esterno che registri tu stesso, o un’azione del copilota — passa dallo stesso percorso a quattro passaggi prima di raggiungere il tuo agente IA o un chiamante identificato. Questa pagina descrive il meccanismo; il Catalogo delle integrazioni descrive ogni connettore concreto.

1. Connessione

Nulla esiste per il tuo agente finché non lo colleghi. Un connettore di prima parte (per esempio HubSpot) si collega con un token o una credenziale che generi tu stesso nel sistema esterno — la Piattaforma verifica quella credenziale contro il sistema reale prima di salvare qualsiasi cosa; se la verifica fallisce, non viene salvata nessuna credenziale. Un server MCP esterno (BYO-MCP) si registra da Impostazioni → Server MCP, con le credenziali di accesso al sistema che vuoi collegare — il percorso generico per qualsiasi sistema che non ha ancora un connettore proprio.

2. Allowlist azione per azione, negato di default

Collegare un sistema non attiva nulla da solo. Ogni azione concreta che quel sistema può offrire — creare un contatto, sincronizzare una fase, aggiungere una nota — nasce spenta; la attivi tu, una alla volta, dalla scheda stessa dell’integrazione. È lo stesso principio che regola le risorse dei tuoi agenti (documenti, modelli, server MCP): senza attivazione esplicita, non esiste.

3. Audience: Interno / Entrambi

Ogni azione dichiara se è Interno (solo il tuo team, o un chiamante identificato) o Entrambi (anche un visitatore anonimo su un canale pubblico, come il widget del tuo sito). “Interno” è il valore predefinito per tutto ciò che non è dichiarato esplicitamente. Un’azione con audience Entrambi che scrive nel sistema esterno restituisce al visitatore anonimo solo una conferma minima — mai il dato completo, mai i dati di un cliente precedente — minimizzata nell’esecutore stesso dell’azione, mai lasciata al giudizio del modello linguistico.

4. Permessi di chi chiama

Per un chiamante identificato (una persona con sessione, un dipendente con il proprio canale, una chiave API), il catalogo fine di permessi del tuo account decide cosa può fare con quell’integrazione, incrociato con il tetto del suo mezzo di accesso — gli scope sigillati di una chiave, o il ritaglio del suo canale. Questo livello è indipendente dall’audience: l’audience decide SE un chiamante non identificato raggiunge l’elemento; i permessi decidono COSA può fare uno identificato.

Tutti e quattro i livelli vengono applicati sempre sul server, mai come un’istruzione nel prompt che il modello linguistico potrebbe ignorare.

Server MCP: il meccanismo generico

Un server MCP è il ponte che collega i sistemi propri della tua attività — il tuo CRM, il tuo catalogo, il tuo calendario — al tuo agente IA, così che l’IA possa consultarli in tempo reale mentre conversa, invece di dipendere solo dai documenti caricati nella tua base di conoscenza. Ci sono due strade:

• Un connettore nativo (sezione 1) registra automaticamente, al momento del collegamento, un server MCP gestito — non lo modifichi né lo elimini da Impostazioni, viene gestito interamente dall’integrazione stessa.
• Un server MCP esterno (BYO-MCP), che registri tu a mano in Impostazioni → Server MCP, copre qualsiasi sistema senza ancora un connettore nativo, con più passaggi di configurazione in cambio di più portata.

In entrambi i casi, delimiti con etichette quali agenti hanno accesso al server — negato di default, come qualsiasi altra risorsa.

BYO-MCP: sotto la tua responsabilità

Registrare un server MCP esterno è un’opzione esplicita, segnalata come tale: il sistema dall’altra parte di quel server è tuo, contrattato e gestito da te, non dal tuo fornitore. Aymar Agents non offre mai un server MCP esterno “con tutto aperto” di default — ogni tool che quel server espone passa comunque dai livelli 2-4 sopra prima di raggiungere un agente o un chiamante.

Conformità: dove finiscono i tuoi dati

Quando un’azione di integrazione invia dati a un sistema esterno (un CRM, un foglio di calcolo, il tuo stesso helpdesk), quel sistema di destinazione resta fuori da ciò che Aymar Agents può garantire o verificare. Sei responsabile di minimizzare ciò che invii, dei tuoi stessi obblighi di informazione su quel sistema di destinazione, e del fatto che la cancellazione di un cliente finale sulla Piattaforma non elimina automaticamente una copia già sincronizzata sul tuo sistema. Vedi Responsabilità dei dati.

Walkthrough in sospeso

Alcune integrazioni hanno la loro procedura di collegamento completa documentata e verificata con screenshot reali; altre non ancora. Ogni pagina del catalogo lo dice onestamente nella propria sezione di stato — un passaggio non viene mai presentato come verificato se non lo è.

Vedi anche

• Catalogo delle integrazioni — ogni connettore, le sue azioni e la sua audience.
• Impostazioni e integrazioni — registrare un server MCP tuo, passo per passo.
• Controllo dell’agente: risorse e permessi — le quattro livelli nel dettaglio.
• Sicurezza e conformità — la stessa logica applicata a tutto il prodotto.