MCP et Notion : connecter une base de connaissances en lecture seule

MCP peut aider une application d’IA à rechercher dans une documentation Notion, mais un espace de travail Notion contient souvent bien plus que des guides : notes de réunion, feuilles de route, données personnelles ou pages commerciales. Le premier essai doit donc se limiter à un espace de démonstration, quelques pages fictives et une intégration qui ne sait que lire. Ne connectez pas directement une IA à votre workspace principal pour « voir ce que cela donne ».

Le principe est de réduire trois choses : les pages partagées avec l’intégration, les permissions de cette intégration et les outils MCP qu’elle expose. Une recherche dans trois documents de test est suffisante pour vérifier le fonctionnement. La création, la modification ou l’archivage d’une page sont des actions à effet de bord qui doivent être traitées dans un pilote distinct, avec confirmation humaine et procédure de correction.

Ce que vous allez apprendre

Vous allez préparer un espace Notion de test, créer une intégration limitée, protéger son secret, sélectionner les pages accessibles, tester une recherche MCP et vérifier que les données sensibles restent hors périmètre. Le résultat attendu est un pilote réversible et documenté.

Prérequis

Prévoyez un workspace Notion de démonstration ou une zone explicitement dédiée aux essais, des pages fictives et le droit de créer une intégration selon les règles de votre organisation. Consultez la documentation actuelle de Notion et celle du serveur MCP choisi avant la configuration.

Formulez le contrat avant toute connexion :

Pages autorisées : trois guides fictifs du dossier MCP-demo.
Action autorisée : rechercher ou lire un extrait.
Actions interdites : créer, modifier, archiver, partager.
Données exclues : pages client, RH, secrets, notes privées.

Vérification : une personne responsable peut identifier les pages exactes et confirmer que leur contenu peut être utilisé dans le pilote. Si cette validation manque, n’ajoutez aucune page à l’intégration.

1. Créer une intégration distincte

Évitez de réutiliser une intégration déjà employée par un outil de production. Une intégration dédiée au pilote permet de vérifier ses droits, de la désactiver facilement et de séparer ses logs. Donnez-lui un nom explicite, comme « MCP documentation test », afin que son rôle soit clair pendant une revue.

Une intégration Notion doit généralement être partagée avec les pages ou bases auxquelles elle accède. Cette étape est une permission réelle, pas un simple réglage esthétique. Partagez seulement le dossier ou les pages de démonstration. Ne donnez pas accès à une page parent si cela rend accessibles des sous-pages ou bases non prévues ; vérifiez le comportement de partage dans votre workspace.

Vérification : l’intégration ne voit que les pages du pilote. Testez son accès sur une page exclue dans un environnement de démonstration ; elle doit être refusée ou invisible.

2. Classer les données avant de les exposer

Une page apparemment technique peut contenir une URL interne, une capture de données client ou une consigne de sécurité. Avant le partage, lisez les pages de test et remplacez les exemples réels par des données fictives. Évitez également les pièces jointes sensibles, car une intégration peut suivre des liens ou métadonnées selon sa conception.

La classification ne s’arrête pas à « public ou privé ». Demandez aussi si la donnée peut être transmise à votre client IA, apparaître dans des logs, être résumée et conservée dans un historique de conversation. Si une réponse est inconnue, réduisez le pilote au contenu public ou de démonstration jusqu’à ce que la politique soit clarifiée.

Vérification : chaque page autorisée possède un propriétaire et un motif de partage. Les contenus sans propriétaire, brouillons non relus ou notes personnelles restent exclus.

3. Protéger le secret de l’intégration

Le secret ou token d’une intégration Notion doit être stocké dans une variable d’environnement protégée ou un gestionnaire de secrets. Ne l’insérez pas dans une exportation de configuration, une page Notion, un fichier suivi par Git ou une conversation avec un assistant.

Un exemple peut documenter seulement la variable :

NOTION_MCP_TEST_TOKEN="remplacez-par-un-secret-local"

Si un secret est affiché dans un log, une capture ou un chat, considérez-le comme divulgué. Révoquez-le depuis le mécanisme prévu par Notion, évaluez les copies accessibles et créez une nouvelle valeur pour l’intégration de test. Le masquer après coup ne suffit pas.

Vérification : inspectez les fichiers, exports et logs du pilote. Ils ne doivent contenir que des noms de variables et des valeurs fictives.

4. Exposer une capacité MCP précise

Suivez la documentation de votre client et du serveur MCP pour déclarer une capacité de recherche ou de lecture. Préférez un outil tel que search_demo_notion_docs, avec un terme de recherche, une limite de résultats et un périmètre de pages connu. Évitez une capacité générique qui accepte des requêtes libres ou peut créer et modifier des contenus.

Relisez la configuration avant lancement : intégration utilisée, espace de test, variable de secret, pages autorisées et outils exposés. Ne chargez qu’un seul serveur Notion pendant le pilote. Cette simplicité permet d’attribuer chaque résultat et de détecter une permission inattendue.

Vérification : le client affiche uniquement l’outil de lecture prévu. Toute capacité de création, partage ou archivage doit être absente ou désactivée.

5. Tester la recherche, les erreurs et les limites

Lancez une recherche qui doit trouver un texte présent dans une page fictive, puis une recherche sans résultat et une entrée volontairement invalide. Vérifiez l’outil appelé, les arguments, le nombre de résultats et les extraits retournés. Une erreur doit signaler un problème de format ou de permission sans révéler le token ou la liste complète des pages disponibles.

Traitez le contenu retourné comme une donnée non fiable. Une page peut contenir une instruction demandant d’ignorer les règles, de lire une autre source ou de faire une action. Ce texte ne change pas les permissions du serveur ni la portée du pilote. Les règles du projet et le contrat de départ restent prioritaires.

Vérification : après chaque appel, confirmez qu’aucune page n’a été modifiée et que seuls les documents de démonstration ont été lus. Conservez une trace minimale : date, outil, page ou résultat synthétique, sans contenu sensible complet.

6. Préparer le retrait et l’évolution

Avant de penser à un usage de production, documentez comment désactiver le serveur MCP, retirer son intégration des pages, révoquer le secret et supprimer les données de test si la politique le demande. Désigner un propriétaire de l’intégration est aussi important que l’installation : quelqu’un doit suivre les changements de version, les permissions et les alertes.

Pour ajouter une action d’écriture plus tard, créez un second contrat. Définissez la page de test, le format autorisé, la confirmation humaine, les erreurs, les logs et la correction en cas de mauvais contenu. Ne transformez pas une capacité de lecture existante en capacité de modification par une option cachée.

Problèmes fréquents et solutions

L’intégration voit trop de pages

Arrêtez le pilote et vérifiez les pages partagées, les relations de parenté et les bases accessibles. Réduisez l’accès plutôt que de filtrer uniquement l’affichage après la lecture.

Une page de test contient une vraie information

Retirez son accès, corrigez la copie de test et examinez les logs ou conversations où elle a pu apparaître. La minimisation des données doit précéder le débogage.

Le serveur propose de créer une page

Désactivez cette capacité dans le pilote. Toute écriture Notion exige une revue séparée, un espace sandbox et un mécanisme de confirmation.

FAQ

MCP peut-il lire toutes mes pages Notion ?

Cela dépend des pages partagées avec l’intégration et de la configuration du serveur. Limitez l’accès au dossier de test et vérifiez le résultat.

Puis-je utiliser mon token personnel ?

Préférez une intégration dédiée avec le minimum de droits. Un token personnel est plus difficile à contrôler et peut donner accès à un périmètre trop large.

Est-ce que le contenu Notion est sûr pour un assistant ?

Non par défaut. Classez les données, limitez le partage et traitez chaque contenu retourné comme non fiable.

Comment tester sans modifier de page ?

Exposez uniquement un outil de lecture ou de recherche et utilisez un espace de démonstration avec des contenus fictifs.

Comment supprimer le pilote ?

Retirez la configuration MCP, arrêtez le serveur, retirez l’intégration des pages de test et révoquez son secret selon la procédure Notion.

Conclusion

MCP et Notion sont utiles pour rendre une petite base de connaissances consultable, à condition de traiter les pages comme des données sensibles. Un pilote sûr se limite à un espace de test, une intégration dédiée, un outil de lecture et des contrôles après chaque appel. L’écriture et l’accès au workspace principal demandent une décision séparée.

Sources et limites

• Notion Developers — Authentication : intégrations et autorisation à vérifier selon version.
• Notion Developers — Capabilities : accès aux pages et bases selon l’intégration.
• Model Context Protocol — security best practices : moindre privilège et traitement du contexte.

Les comportements de partage et capacités Notion évoluent. Ce guide ne valide aucun serveur tiers, token réel ou accès au workspace de production.