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.
Si votre installation Notion expose aussi un endpoint MCP, vous pouvez l’attacher ensuite depuis Sources externes → MCP projet. Sans endpoint MCP configuré, aucun MCP Notion fictif n’est proposé.
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.
- Pas d’exposition MCP sans endpoint réellement configuré sur l’installation.
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