Come collegare Notion, GitHub e Gmail alle attività di un agente IA

Da Account → Collega le tue app, collega Google Drive, Gmail, Notion, GitHub, Linear, Slack, Fireflies o Granola, e un agente collegato riceve quattro nuovi strumenti MCP (list_connections, search_context, read_context e save_context) che gli permettono di trovare e leggere il contesto reale prima di svolgere un'attività, invece di costringerti a incollare una specifica o una conversazione nelle note. È pensato prima di tutto per la lettura: un agente può portare nel suo lavoro un documento di Notion o una issue di GitHub e scrivere un risultato finito su Google Drive, ma non può inviare le tue email, pubblicare su Slack o aprire una issue nel tracker di qualcuno. Non sono cose che gli viene semplicemente detto di non fare: sono cose che non è in grado di fare.

Da quali app un agente può ricavare il contesto?

• Google Drive: lettura e scrittura di file, con ambito drive.file, cioè i file creati da questa app più quelli che le hai passato esplicitamente, mai l'intero Drive.
• Gmail: ricerca e lettura della posta, in sola lettura. Google classifica questo ambito come riservato, quindi compare solo dopo che l'installazione di Done ha completato la verifica aggiuntiva che lo sblocca.
• Notion: lettura e scrittura di pagine. L'OAuth di Notion non ha alcun parametro di ambito; ciò che un agente può raggiungere sono le pagine che hai scelto durante l'installazione, non qualcosa che Done richiede.
• GitHub: lettura e scrittura di file e issue nei repository a cui dai accesso. Per i repository privati l'ambito repo è tutto o niente: GitHub non ne offre uno più ristretto di sola lettura.
• Linear: lettura e scrittura di issue. I token di accesso durano 24 ore; Done rinnova il collegamento dietro le quinte, così non scade in silenzio.
• Slack: ricerca in sola lettura nella cronologia dei canali e dei gruppi a cui dai accesso, riutilizzando la stessa app Slack che Done usa già per le notifiche di approvazione.
• Fireflies: trascrizioni delle riunioni in sola lettura, tramite una chiave bearer che incolli dalle impostazioni di Fireflies (piano Pro di Fireflies o superiore).
• Granola: trascrizioni delle riunioni in sola lettura, allo stesso modo, tramite una chiave presa dalle impostazioni di Granola (piano Business o Enterprise di Granola).

Come usa concretamente un agente un'app collegata in un'attività?

Il punto di partenza è list_connections: mostra che cosa è collegato, a quale account punta ogni collegamento e quali capacità ha davvero, che possono essere meno di quelle offerte dall'app se hai ristretto la schermata di consenso al momento del collegamento. Da lì, search_context prende una ricerca e restituisce dei risultati: un titolo, un tipo (file, nota, issue, messaggio, trascrizione, email), un link e un ref, mai il contenuto. read_context prende quel ref e restituisce il testo vero e proprio. Di solito un agente cerca la specifica o la conversazione a cui un'attività fa riferimento, legge il risultato che corrisponde e lavora su quello, invece di tirare a indovinare dal solo titolo dell'attività. Se ha prodotto qualcosa che vale la pena conservare, save_context lo scrive in un collegamento a Drive che abbia files.write, e l'agente riferisce comunque il risultato nell'attività con propose_completion o complete_task, come in qualsiasi altra esecuzione.

In che cosa cerca davvero search_context? Nel testo completo di tutto?

No, e le differenze contano per ciò che un agente può aspettarsi di trovare. Drive cerca nei nomi e nei contenuti dei file; la ricerca di GitHub copre solo issue e pull request, non il codice (leggere un file preciso è una chiamata read_context con il suo ref, owner/repo:path, non un risultato di ricerca); Slack cerca nei messaggi; Notion nei titoli e nel testo delle pagine; Fireflies e Granola soltanto nei titoli delle riunioni, quindi una cosa detta dentro una trascrizione non emerge, a meno che la riunione non abbia preso il nome da quella cosa. Nulla di tutto questo è un indice unificato a testo completo di tutte le app collegate: ogni fornitore risponde con ciò che la sua API supporta davvero.

Un agente collegato può inviare email, pubblicare su Slack o aprire una issue al posto mio?

No, ed è voluto. In tutto il livello dei connettori non è definita alcuna capacità di inviare posta o messaggi: un agente può leggere la tua posta in arrivo e i tuoi canali per avere contesto, ma non ha modo di inviare nulla da nessuno dei due. Anche save_context è più ristretto di quanto l'elenco dei fornitori potrebbe far pensare: è l'unico strumento di scrittura, e oggi solo l'adattatore di Google Drive implementa davvero la scrittura. Quindi nemmeno un collegamento a GitHub o a Notion con accesso in scrittura può, per ora, ricevere scritture tramite save_context. Un agente che propone di mandare un'email a qualcuno o di pubblicare un aggiornamento sta descrivendo ciò che una persona dovrebbe fare dopo, non qualcosa che qui può eseguire.

Le app collegate funzionano con un token limitato a uno spazio di lavoro o di sola lettura?

Può usarle solo un token completo, senza limitazioni di ambito. Un collegamento è una credenziale personale legata al tuo account, non a un singolo spazio di lavoro: per questo list_connections, search_context, read_context e save_context vengono rifiutati senza eccezioni a un token MCP limitato a uno spazio di lavoro o a un progetto, come succede a get_digest e agli altri strumenti che riguardano l'intero account e non hanno una parte “per bacheca” a cui restringersi. La tua Gmail non ha una “fetta di questo spazio di lavoro”: invece di limitarla a metà, Done rifiuta tutto a un token più ristretto.

Mi serve un piano a pagamento per collegare un'app?

Non dal lato di Done: non c'è alcun controllo sul piano, dal pannello Account fino a search_context o save_context. Due delle otto app, Fireflies e Granola, possono richiedere un piano a pagamento del loro servizio prima di rilasciarti una chiave API, ma sono i loro prezzi, non quelli di Done. Quali app OAuth mostrano davvero un pulsante Collega nel tuo account dipende dal fatto che il gestore di Done abbia configurato le credenziali di quel fornitore su questa installazione: un'app non configurata lo dice chiaramente, invece di offrire un pulsante che finisce nel vicolo cieco della pagina di errore di qualcun altro.