Qu'est-ce que le serveur MCP Notion pour Claude ?

Réponse rapide : le serveur MCP de Notion connecte Claude directement à votre espace de travail Notion grâce au Model Context Protocol. Une fois configuré, Claude peut lire, rechercher, mettre à jour et créer des pages Notion en langage naturel. La configuration prend moins de 20 minutes et ne demande aucune compétence en programmation.

L'intégration Notion MCP transforme Claude, d'assistant IA autonome, en un outil vraiment utile pour les équipes B2B SaaS : une IA capable de lire votre documentation réelle, d'interroger vos bases de données et de mettre à jour vos pages sans que vous ayez à changer d'onglet.

Ce guide couvre la configuration complète pour Claude Desktop et Claude Code, ainsi que les workflows concrets dont les équipes SaaS tirent le plus de valeur une fois la connexion établie.

Qu'est-ce que le serveur MCP de Notion ?

Le serveur MCP de Notion est une intégration officielle développée par Notion. Elle s'appuie sur le Model Context Protocol (un standard ouvert créé par Anthropic) pour donner à Claude un accès direct à votre espace de travail Notion. Plus besoin de copier-coller du contenu dans Claude : il lit et écrit directement dans Notion.

C'est important pour les équipes B2B SaaS, car votre espace Notion contient probablement vos spécifications produit, vos études clients, vos documents d'onboarding et vos notes de réunion. Connecter Claude à ce contexte en fait un assistant bien plus utile que s'il partait de zéro.

Ce que Claude peut faire une fois connecté :

• Rechercher dans tout votre espace Notion par mot-clé ou par sujet
• Lire l'intégralité du contenu de toute page à laquelle il a accès
• Interroger les entrées d'une base de données et les filtrer par propriétés
• Créer de nouvelles pages et de nouvelles entrées de base de données
• Mettre à jour le contenu de pages existantes
• Résumer de longs documents à la demande

Ce qu'il vous faut avant de commencer

Avant de configurer l'intégration Claude et Notion MCP, vérifiez que vous disposez des éléments suivants :

• Claude Desktop (gratuit ou Pro) ou Claude Code installé
• Un compte Notion (quel que soit le forfait)
• Node.js installé sur votre machine (version 18 ou supérieure)
• Un accès administrateur à votre espace de travail Notion, ou l'autorisation de créer des intégrations

Si vous utilisez spécifiquement Claude Code, Notion publie aussi un plugin officiel qui regroupe le serveur MCP et des commandes slash prêtes à l'emploi. Cette option est détaillée plus bas.

Comment configurer Notion MCP avec Claude Desktop

Étape 1 : créer une intégration Notion

1. Rendez-vous sur notion.so/my-integrations
2. Cliquez sur New integration
3. Donnez-lui un nom (par exemple « Claude MCP »)
4. Sélectionnez l'espace de travail auquel Claude doit avoir accès
5. Dans les capacités, activez Read content, Update content et Insert content
6. Cliquez sur Save
7. Copiez l'Internal Integration Token qui s'affiche. Vous en aurez besoin à l'étape 3.

Étape 2 : connecter des pages à votre intégration

Les intégrations Notion n'accèdent qu'aux pages que vous partagez explicitement avec elles. C'est une fonction de sécurité, pas un bug.

Pour chaque page ou base de données Notion à laquelle Claude doit avoir accès :

1. Ouvrez la page dans Notion
2. Cliquez sur le menu à trois points (en haut à droite)
3. Sélectionnez Connections
4. Trouvez le nom de votre intégration et cliquez sur Confirm

Vous pouvez partager une page de niveau supérieur pour donner à Claude accès à tout ce qu'elle contient.

Étape 3 : configurer le serveur MCP dans Claude Desktop

Ouvrez le fichier de configuration de Claude Desktop. Sur Mac, il se trouve ici :

~/Library/Application Support/Claude/claude_desktop_config.json

Sous Windows :

%APPDATA%\Claude\claude_desktop_config.json

Ajoutez ce qui suit dans le fichier, en remplaçant YOUR_INTEGRATION_TOKEN par le token de l'étape 1 :

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_INTEGRATION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Étape 4 : redémarrer Claude Desktop

Quittez complètement Claude Desktop, puis rouvrez-le. Au chargement de l'application, une icône de marteau doit apparaître en bas à gauche de l'interface de conversation. Cela confirme que le serveur MCP est actif et que Claude a accès aux outils.

Étape 5 : tester la connexion

Saisissez ceci dans Claude :

"Search my Notion workspace for pages about [a topic you know exists]."

Si Claude renvoie des résultats issus de votre espace de travail, l'intégration fonctionne.

Comment configurer Notion MCP avec Claude Code

Les utilisateurs de Claude Code disposent d'une option un peu différente (et plus rapide) : le plugin Notion officiel pour Claude Code.

Option A : installer le plugin Notion officiel

Le plugin officiel (publié sur makenotion/claude-code-notion-plugin sur GitHub) regroupe le serveur MCP avec des skills et des commandes slash préconfigurés. C'est la voie recommandée si Claude Code est votre interface principale.

Étapes d'installation :

1. Ouvrez Claude Code
2. Exécutez la commande suivante dans le terminal :

claude mcp add notionhq/notion-mcp-server

1. Lorsque vous y êtes invité, collez votre token d'intégration Notion
2. Confirmez la connexion

Le plugin ajoute des commandes slash comme /notion-search, /notion-create, et /notion-update directement dans votre workflow Claude Code.

Option B : configuration manuelle via claude.json

Si vous préférez une configuration manuelle ou avez besoin d'une configuration personnalisée, ajoutez le serveur MCP de Notion à votre fichier claude.json en reprenant la même structure JSON que dans la section Claude Desktop ci-dessus.

Workflows concrets pour les équipes B2B SaaS

Faire fonctionner l'intégration n'est que la première étape. Voici où elle devient vraiment rentable.

Interroger vos bases de données Notion

Les équipes SaaS stockent souvent leurs données clients, leurs demandes de fonctionnalités ou leurs tâches de sprint dans des bases de données Notion. Une fois que Claude y a accès, vous pouvez les interroger en langage courant.

Exemples de prompts :

• « Trouve toutes les entrées de ma base de données roadmap produit dont le statut est 'In Review' »
• « Montre-moi toutes les pages portant le tag du client Acme Corp »
• « Liste toutes les tâches assignées à [nom] qui sont marquées comme prioritaires »

Claude lit les propriétés de la base de données et filtre les résultats sans que vous ayez à créer de vues personnalisées.

Résumer de longs documents

Les spécifications produit, les rapports d'études clients et les guides d'onboarding ont tendance à s'allonger. Claude peut résumer en quelques secondes n'importe quelle page Notion connectée.

Exemples de prompts :

• « Résume la page d'étude client du T2 en 5 points »
• « Donne-moi les décisions clés du document de décision d'architecture de notre système de facturation »
• « Quelles sont les principales objections consignées dans notre playbook commercial ? »

C'est particulièrement utile avant des appels clients ou des revues internes, quand il vous faut un brief rapide. Les équipes qui structurent davantage leur documentation et leurs workflows de contenu associent souvent ce type de dispositif à l'appui d'agences de content marketing B2B SaaS performantes, afin de transformer le savoir interne en contenus qui alimentent le pipeline.

Mettre à jour des pages sans quitter votre workflow

Claude peut aussi écrire dans Notion, pas seulement y lire. Pour les équipes SaaS, cela supprime la friction du va-et-vient entre votre assistant IA et votre outil de documentation.

Exemples de prompts :

• « Ajoute une nouvelle section à notre checklist d'onboarding pour les clients grands comptes, sur la configuration du SSO »
• « Mets à jour la propriété de statut de la page de la fonctionnalité 'API rate limiting' sur 'Shipped' »
• « Crée une nouvelle page dans notre base de données de notes de réunion avec la date du jour et le résumé suivant : [coller les notes] »

Construire une base de connaissances vivante

Dans un contexte B2B SaaS, l'usage le plus durable de claude notion mcp consiste à faire de Notion une couche de mémoire persistante pour Claude. Au lieu de réexpliquer votre produit, vos clients ou vos processus à chaque conversation, Claude lit ce contexte dans Notion au début de chaque session.

Pour cela :

1. Créez dans Notion une page « Claude Context » avec votre ICP, le positionnement de votre produit et votre terminologie clé
2. Partagez cette page avec votre intégration
3. Commencez chaque session Claude par : « Lis ma page Claude Context dans Notion avant que nous commencions »

Cela prend environ 30 minutes à mettre en place et fait gagner un temps précieux à chaque session suivante. Pour les grandes équipes, ce type de démarche s'intègre aux marketing operations B2B SaaS au sens large, surtout lorsque la documentation, l'exécution des campagnes et le reporting doivent rester alignés.

Résoudre les problèmes de configuration courants

Claude indique qu'il ne trouve aucun outil Notion
Le serveur MCP ne s'est pas chargé. Quittez complètement Claude Desktop et relancez-le. Vérifiez que votre claude_desktop_config.json ne contient pas d'erreurs de syntaxe JSON (une virgule ou un crochet manquant suffit à invalider tout le fichier).

Claude peut rechercher mais ne renvoie aucun résultat
Votre intégration n'est connectée à aucune page. Revenez à l'étape 2 et partagez les pages concernées avec votre intégration.

Erreurs d'authentification lorsque Claude tente d'accéder à Notion
Votre token d'intégration a probablement été saisi de façon incorrecte. Retournez sur notion.so/my-integrations, régénérez le token et mettez à jour votre fichier de configuration.

Claude peut lire les pages mais ne peut pas les modifier
Vérifiez les capacités de votre intégration. Rendez-vous sur notion.so/my-integrations, ouvrez votre intégration et confirmez que « Update content » et « Insert content » sont bien activés.

Claude Desktop ou Claude Code : lequel choisir ?

Les deux options reposent sur le même serveur MCP de Notion et offrent un accès identique à votre espace de travail. La différence tient à la préférence d'interface, pas aux capacités.

FAQ

Qu'est-ce que le serveur MCP de Notion et comment fonctionne-t-il avec Claude ?
Le serveur MCP de Notion est une intégration officielle qui utilise le Model Context Protocol pour donner à Claude un accès direct en lecture et en écriture à votre espace de travail Notion. Claude envoie des requêtes au serveur MCP, qui les traduit en appels à l'API Notion. Résultat : Claude peut rechercher, lire, créer et mettre à jour du contenu Notion en langage naturel, sans aucun copier-coller manuel.

L'intégration Claude Notion MCP est-elle gratuite ?
Le serveur Notion MCP est lui-même gratuit et open source. Il vous faut une offre Claude compatible avec l'utilisation d'outils MCP (Claude Pro ou supérieur pour Claude Desktop, ou Claude Code, qui a sa propre tarification). L'offre gratuite de Notion prend en charge les intégrations : aucune offre Notion payante n'est donc nécessaire.

Comment ajouter Notion MCP à Claude Code précisément ?
Exécutez claude mcp add notionhq/notion-mcp-server dans le terminal de Claude Code et suivez les instructions pour saisir le jeton de votre intégration Notion. Vous pouvez aussi installer le plugin Notion officiel pour Claude Code depuis le dépôt makenotion/claude-code-notion-plugin GitHub, qui ajoute le serveur MCP ainsi que des commandes slash prêtes à l'emploi en une seule étape.

Claude peut-il modifier mes pages Notion, ou seulement les lire ?
Claude peut lire, créer et mettre à jour des pages et des entrées de base de données Notion, à condition que les bonnes capacités soient activées sur votre intégration. Rendez-vous sur notion.so/my-integrations et vérifiez que « Update content » et « Insert content » sont bien activés pour votre intégration.

Est-il sûr de connecter Claude à mon espace de travail Notion ?
Les intégrations Notion n'accèdent qu'aux pages que vous partagez explicitement avec elles. Claude ne peut voir aucune page en dehors de celles que vous avez connectées. Votre jeton d'intégration doit rester privé et n'être stocké que dans votre fichier de configuration local, jamais dans un dépôt partagé ou public.