Notion MCP : le guide complet pour connecter l’IA à votre espace de travail

Qu’est-ce que Notion MCP ?

MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA d’utiliser des outils et des sources de données externes. Notion MCP est son implémentation officielle, hébergée par Notion : un serveur qui fait le lien entre votre outil d’IA et votre espace de travail et rend Notion accessible sous forme d’outils typés — rechercher, lire une page, modifier une page, interroger une base de données — plutôt que par une API brute que l’agent devrait apprendre à utiliser seul.

En pratique, par rapport à l’ancien fonctionnement par jeton d’intégration, c’est le jour et la nuit. Vous vous authentifiez une seule fois via OAuth, l’agent découvre automatiquement les outils disponibles, et le contenu des pages est transmis en markdown — un format à la fois plus facile à exploiter pour les modèles et bien moins coûteux en tokens que le JSON des blocs Notion.

Serveur hébergé ou auto-hébergé

Il existe deux façons officielles de l’utiliser, avec un choix par défaut qui s’impose :

Utilisez le serveur hébergé, sauf si vous avez expressément besoin de limiter l’accès à la lecture seule ou d’une installation isolée du réseau. Notion a clairement indiqué que le projet open source notion-mcp-server sur GitHub n’est plus sa priorité et pourrait être abandonné.

Configuration : Claude Code, Claude Desktop, Cursor, ChatGPT

Claude Code (une commande)

claude mcp add --transport http notion https://mcp.notion.com/mcp

Au prochain lancement, Claude Code lance la procédure d’authentification OAuth ; autorisez l’accès et les outils Notion apparaissent automatiquement.

Claude Desktop

Paramètres → Connecteurs → ajoutez Notion depuis le répertoire (un clic), ou ajoutez un connecteur personnalisé avec l’URL https://mcp.notion.com/mcp.

Cursor

Ajoutez ceci à .cursor/mcp.json (projet) ou aux paramètres MCP globaux :

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

ChatGPT et autres outils

Tout outil pouvant servir de client MCP peut se connecter — ChatGPT le prend en charge via les connecteurs. Les outils qui ne prennent pas en charge MCP ne peuvent pas du tout utiliser Notion MCP : c’est la raison la plus courante pour laquelle une configuration « ne fonctionne pas ».

Variante auto-hébergée

Créez une intégration interne sur notion.so/profile/integrations, accordez-lui l’accès aux pages précises que vous souhaitez rendre accessibles, puis lancez le serveur avec votre jeton :

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_****" }
    }
  }
}

Ce que les agents peuvent réellement faire

• Rechercher dans vos pages et vos contenus connectés — l’agent trouve le contexte sans que vous ayez à le copier-coller.
• Lire les pages en markdown — tout le contenu d’une page en un seul appel, avec une consommation de tokens réduite, y compris les transcriptions des notes de réunion.
• Rédiger et modifier — créer des pages, remplacer leur contenu ou effectuer des modifications ciblées par recherche et remplacement.
• Travailler avec les bases de données — interroger les sources de données avec des filtres et des tris, mettre à jour les propriétés, créer des entrées.
• Déplacer et organiser — changer la page parente des pages, gérer la structure.

En pratique, cela couvre tout le cycle d’un wiki LLM : l’agent assimile les sources, rédige des synthèses dans Notion, relie les pages entre elles et répond aux questions à partir de ce qu’il a déjà construit. Nous utilisons exactement cette configuration au quotidien — vous trouverez des procédures à copier-coller dans Claude Code + Notion : cinq processus de travail, et le récit complet de la mise en place, avec un regard honnête sur ses limites, dans Wiki LLM pour Notion.

Sécurité et autorisations

• Vos autorisations fixent la limite maximale. Un agent connecté via Notion MCP peut accéder exactement à ce à quoi votre compte a accès — rien de plus, et il ne peut pas contourner les autorisations définies au niveau des pages.
• La limite minimale dépend de vous. Le serveur hébergé utilise toujours l’ensemble de vos droits d’accès : réfléchissez donc avant de connecter un agent expérimental à un espace de travail contenant des données sensibles. Pour un accès en lecture seule, utilisez le serveur auto-hébergé avec un jeton d’intégration limité à « Lire le contenu ».
• Contrôles Enterprise. Les administrateurs d’espaces de travail disposant de l’offre Enterprise peuvent activer la gouvernance MCP : une liste d’applications d’IA approuvées, un audit des connexions et une commande pour tout déconnecter.
• Les données sont transmises au modèle. Tout ce que l’agent lit entre dans son contexte — considérez la politique de gestion des données de l’outil d’IA lui-même comme faisant partie de votre périmètre de sécurité.

La carte manquante : ce que MCP ne vous apporte pas

MCP donne à un agent des mains — pour rechercher, lire, écrire. Il ne lui donne pas d’yeux. Chaque requête offre une vue à travers un trou de serrure : l’agent voit les pages qu’il a récupérées à ce tour, pas la structure de l’espace de travail — quelles pages sont des points centraux, quels groupes existent, où se trouvent les pages orphelines. C’est un problème de graphe, pas de récupération d’informations.

C’est précisément la couche qu’IVGraph ajoute à une configuration Notion + MCP : votre espace de travail représenté sous forme de graphe de connaissances 3D interactif pour vous, et cette même structure accessible par programmation aux agents via l’API LLM d’IVGraph — recherche, voisinages des nœuds et chemins les plus courts entre les pages. L’agent effectue les modifications via MCP ; le graphe vous montre à tous les deux à quoi ressemble réellement l’espace de travail.

FAQ