Connecter Notion
L’addon notion-connect relie pages, sources de données, blocs et vues Notion à vos projets arka-deck. L’agent peut lire et écrire dans Notion sans que vous quittiez le chat.
Ce qu’arka-deck enregistre — et ce qu’il n’enregistre pas
Section intitulée « Ce qu’arka-deck enregistre — et ce qu’il n’enregistre pas »| Donnée | Stockage |
|---|---|
| Connexion (token, scopes) | Chiffré dans SQLite local (AES-256-GCM) |
| Références externes (page id, source id) | Local |
| Informations de fraîcheur | Local |
| Journal d’exécution | Local |
L’addon n’importe pas tout le workspace Notion comme base documentaire locale. Seules les références et les opérations explicites sont enregistrées.
Configurer le connecteur
Section intitulée « Configurer le connecteur »- Ouvrir la vue External Sources ou Notion Config du projet.
- Choisir l’authentification :
- Token d’intégration (créer une intégration interne Notion et coller son token).
- OAuth Notion (flow guidé depuis l’application).
- Tester la connexion.
Le token est chiffré localement et n’est jamais exposé à l’UI après saisie.
Actions disponibles
Section intitulée « Actions disponibles »| Action | Description |
|---|---|
| Test connexion | Vérifier que le token fonctionne |
| Recherche | Trouver pages, sources, vues par titre |
| Lecture page | Récupérer une page Notion et ses blocs |
| Lecture source | Récupérer les éléments d’une source de données |
| Lecture vue | Récupérer une vue (table, kanban, etc.) |
| Création / mise à jour de page | Créer ou modifier une page |
| Ajout de blocs | Ajouter des blocs à une page existante |
| Corbeille page | Mettre une page à la corbeille (non destructif) |
L’agent peut invoquer ces actions pendant un tour (avec votre accord pour les opérations d’écriture, selon votre configuration de permissions provider).
Sécurité OAuth
Section intitulée « Sécurité OAuth »- Le
stateOAuth est en mémoire, à usage unique, avec TTL de 10 minutes. - Un redémarrage pendant l’autorisation invalide le callback : il faut relancer le flow.
- Les credentials chiffrés vivent dans
<arkaHome>/providers/providers.db.
- Le connecteur ne gère qu’une connexion par projet (multi-comptes prévu plus tard).
- Pas de synchronisation automatique du workspace Notion en arrière-plan.
- Pas de webhook entrant — arka-deck pull à la demande, pas de push Notion → arka-deck.
Pour aller plus loin
Section intitulée « Pour aller plus loin »- Fiche dev Notion Connect : ../../dev/addons-firstparty/notion-connect
- Posture sécurité : 07-securite-et-donnees