Documenti
Notion
Cerca e legge pagine e database di Notion condivisi con l’integrazione; crea pagine e aggiunge testo con conferma.
- Token o credenziali
- Azioni con conferma
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
search | Cerca pagine e database per titolo tra quelli condivisi con l’integrazione. | Lettura |
read_page | Proprietà e contenuto testuale di una pagina (fino a 400 blocchi). | Lettura |
query_database | Righe di un database Notion con le proprietà in forma leggibile (le più recenti per prime). | Lettura |
create_page | Crea una sottopagina sotto una pagina esistente. Richiede conferma. | Con conferma |
append_to_page | Aggiunge paragrafi in fondo a una pagina. Richiede conferma. | Con conferma |
Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti creazione e aggiornamento pagine (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli Notion e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- notion.so/profile/integrations → New integration (tipo Internal), capacità: Read content (più Insert/Update content se abiliti la scrittura).
- Copia l’Internal Integration Secret e incollalo qui: resta nel Vault.
- In Notion, su ogni pagina o database da rendere disponibile: ••• → Connections → aggiungi l’integrazione.
Da incollare (cifrato nel Vault, poi non più visibile): Internal integration secret.
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Permessi insufficienti
- All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.
Link utili
Console del fornitore citate nei passi: