KEPLIN Docs

Agenti di IA e l'MCP

Cos'è la connessione MCP, cosa può fare un agente in un'app, e perché non vede mai più di quanto vede l'account che lo ha autorizzato.

Keplin ha una porta da cui un agente di IA entra e lavora nelle app: crea schermate, modifica il modello, scrive script, esegue API, pubblica. Non è un assistente che suggerisce — è una connessione attraverso la quale un programma fa le stesse cose che faresti tu nel browser.

La porta si chiama MCP e vive nel menu Connessioni MCP, nella barra laterale.

La regola che spiega tutto il resto

È scritta nell'intestazione della pagina stessa:

Le applicazioni a cui hai autorizzato l'accesso al tuo account. Ognuna vede e fa esattamente ciò che vedi e fai tu nel browser.

Non ci sono autorizzazioni dedicate agli agenti, né un elenco di cose che solo loro possono fare. Un agente collegato al tuo account:

  • vede le app che vedi tu — se sei developer con un'app assegnata, è quella e nessun'altra;
  • fa quello che puoi fare tu — se non sei amministratore, nemmeno lui crea app o tocca gli utenti;
  • salva nella tua versione di lavoro — la stessa che mostra la tua intestazione, a meno che non gliene venga chiesta un'altra;
  • viene rifiutato dagli stessi blocchi che fermano te: un elemento in checkout da un'altra persona non si salva, e il rifiuto porta il nome di chi lo ha.

La pagina Connessioni MCP, con l'indirizzo della connessione e l'elenco delle autorizzazioni
La pagina Connessioni MCP, con l'indirizzo della connessione e l'elenco delle autorizzazioni

Nota

Connessioni MCP è una pagina di account, non di amministrazione. Mostra quello che hai autorizzato tu, e solo tu revochi. Nessun amministratore vede né revoca le connessioni di un'altra persona — tagliare l'accesso a qualcuno si fa disattivando il suo account, il che taglia tutto, non solo l'MCP.

L'indirizzo della connessione

Il primo pannello della pagina è Indirizzo MCP — "Incolla questo nel tuo client. È l'indirizzo da cui entra; l'autorizzazione si concede dopo, nel browser."

Il pannello Indirizzo MCP, con l'indirizzo e il pulsante Copia
Il pannello Indirizzo MCP, con l'indirizzo e il pulsante Copia

Clicca su Copia e incolla l'indirizzo nella configurazione del tuo client di IA. È tutto quello che deve sapere: il resto — chi sei, cosa puoi fare — si risolve nell'autorizzazione, che è l'argomento della pagina successiva.

L'indirizzo segue il punto da cui sei entrato. Chi apre la piattaforma dal dominio dell'azienda legge il dominio dell'azienda; chi entra localmente legge l'indirizzo locale. Copialo dall'installazione a cui l'agente si collegherà, e non da un appunto vecchio.

Cosa riesce a fare un agente

Un agente collegato lavora l'app intera, e nello stesso ordine in cui ci lavorerebbe una persona:

Area Cosa riesce a fare
Dati Creare connessioni a database, importare tabelle, disegnare il modello, creare enum e trigger.
API Creare e modificare le API GraphQL sopra il modello.
Schermate Creare layout e schermate, aggiungere e configurare widget, collegare i dati alle schermate, scrivere il codice degli eventi.
Navigazione Montare il menu dell'app e puntarlo alle schermate.
Autorizzazioni Definire le azioni e i ruoli dell'app.
Script Scrivere script in Python, installarne le dipendenze ed eseguirli.
Report e processi Creare report, workflow, trigger e pianificazioni.
Immagine Generare e caricare icone e loghi, e mettere a punto il tema dell'app.
Operatività Leggere il Radar, vedere le esecuzioni, consultare la cronologia e le versioni.

Tutto questo succede sulla piattaforma, con le stesse convalide dell'editor. Una schermata scritta da un agente è una schermata come un'altra: entra nella cronologia, entra nelle versioni, e si apre nell'editor visuale per essere corretta a mano.

Chi ha fatto cosa

Un agente non sparisce dentro la tua identità. L'audit distingue le due cose: quello che hai salvato tu e quello che ha salvato un agente a tuo nome.

Questo significa che la risposta a "chi ha cambiato questa schermata?" resta esatta, anche con degli agenti al lavoro. La trovi in due posti:

  • la cronologia dell'app, commit per commit;
  • OsservabilitàAudit, con il prima e il dopo di ogni modifica.

Il pannello App a cui ha accesso, nella scheda di un utente: un interruttore per app — al di fuori di queste, l'app non appare.
Il pannello App a cui ha accesso, nella scheda di un utente: un interruttore per app — al di fuori di queste, l'app non appare.

Cosa non è

Non è Perché
Un account di servizio Non c'è un utente "robot". L'agente usa il tuo account, con la tua portata.
Una chiave API Le Chiavi API danno accesso al GraphQL di un'app a un sistema esterno. L'MCP dà accesso alla costruzione della piattaforma, a nome di una persona.
Un assistente dentro l'editor L'agente vive nel tuo client di IA. La piattaforma è ciò che lui opera, non dove abita.
Una cosa che ha bisogno del browser aperto Non ne ha bisogno. L'agente lavora lo stesso senza che nessuno abbia la piattaforma aperta.

Prima di collegare un agente

Tre decisioni che vale la pena prendere prima, e non dopo:

  1. Con quale account. Un agente con un account di amministratore può eliminare app. Se il lavoro riguarda una sola app, autorizzalo con un account di developer che abbia quell'app — e nessun'altra.
  2. In quale versione. Crea una versione per il lavoro dell'agente e passa a quella prima di metterlo al lavoro. Se qualcosa va storto, si elimina la versione e la main non ne ha mai saputo nulla.
  3. Con quali dati. Una versione nuova copia le connessioni ai database dell'origine. Puntale all'ambiente giusto prima di dare la chiave a qualcuno che lavora in fretta.

Atenção

La connessione MCP è potente quanto l'account che la autorizza. Autorizzarla con un account di amministratore significa dare accesso a tutte le app della piattaforma, comprese quelle che verranno create — e la pagina di autorizzazione lo dice a chiare lettere prima che tu prema Autorizza.

Perché non vedo…?

  • …il menu Connessioni MCP? È una pagina di account e compare a chiunque entri nella piattaforma. Se non la vedi, controlla che la sessione sia avviata.
  • …niente in Connessioni attive? Non hai ancora autorizzato nessun client — la pagina dice "Nessuna connessione". L'autorizzazione si fa a partire dal client, ed è l'argomento della pagina successiva.
  • …tutte le app, con l'agente collegato? L'agente vede quello che vede il tuo account. Se mancano app, mancano nella tua scheda in Utenti.