Qu’est-ce qu’un MCP server pour Claude Code ?

Un MCP server est un processus qui expose des outils à Claude Code via le Model Context Protocol. Il sert d’intermédiaire entre Claude Code et une application externe, par exemple Notion ou Gmail, en exécutant les appels API nécessaires.

Claude Code peut-il accéder directement à Notion ou Gmail ?

Claude Code n’a pas un accès externe automatique. Il faut déclarer un serveur MCP adapté, fournir les identifiants nécessaires et accorder les permissions côté application. Sans cela, Claude Code ne peut pas lire vos bases Notion ou vos e-mails Gmail.

Pourquoi ma connexion Notion retourne-t-elle des résultats vides ?

La cause la plus fréquente est l’absence de partage entre la page ou la base Notion et l’intégration. Notion limite l’accès aux ressources explicitement partagées avec l’intégration. Il faut utiliser Add connections sur les pages ou bases concernées.

Faut-il donner des droits d’écriture aux MCP servers ?

Pas au départ. Le plus sûr est de commencer en lecture seule, surtout pour tester les résumés, extractions et analyses. Les droits d’écriture doivent être ajoutés uniquement si le cas d’usage le justifie, avec validation humaine et périmètre limité.

Quels sont les principaux risques de sécurité ?

Les risques principaux sont l’exposition de tokens API, des permissions trop larges et des actions d’écriture non contrôlées. Il faut stocker les secrets dans des variables d’environnement, limiter les scopes OAuth, révoquer les accès inutiles et tester sur un périmètre réduit.

Comment connecter Claude Code avec des MCP servers ?

Les MCP servers permettent à Claude Code de lire et d’agir sur Notion, Gmail ou d’autres outils via leurs API. L’enjeu n’est pas magique : il faut configurer le bon serveur, limiter les droits et tester chaque connexion proprement.

À quoi servent les MCP servers ?

Les MCP servers servent de ponts entre Claude Code et des applications externes comme Notion, Gmail, GitHub, Slack ou tout autre service qui expose une API. Une API, pour Application Programming Interface, est une interface qui permet à deux logiciels de communiquer de manière structurée.

Le Model Context Protocol, ou MCP, est un protocole standardisé par Anthropic pour connecter un modèle ou un agent à des outils, des données et des systèmes externes. La documentation officielle d’Anthropic le présente comme une couche commune pour exposer des ressources, des prompts et des outils à un modèle, sans devoir réinventer une intégration spécifique pour chaque application.

Claude Code n’a pas, par défaut, un accès libre à vos données Notion, Gmail ou internes. C’est important. Le serveur MCP est généralement un processus local, lancé sur votre machine ou dans votre environnement de développement, qui dialogue avec Claude Code via une interface standard comme stdio, c’est-à-dire l’entrée et la sortie standard d’un programme. Ensuite, ce serveur exécute les appels API vers le service cible.

La logique tient en trois étapes simples :

Claude Code interprète votre demande, par exemple : “Résume les tâches Notion en retard”.
Le serveur MCP traduit cette intention en appels API vers Notion, Gmail ou un autre service.
Le serveur MCP renvoie une réponse structurée que Claude Code peut exploiter pour répondre, générer un fichier ou proposer une action.

Élément	Rôle
Claude Code	Interprète la demande et orchestre l’action
MCP server	Expose des outils accessibles à Claude Code
API externe	Permet de lire ou modifier les données du service connecté

Un exemple concret : Avec un serveur MCP Notion configuré, Claude Code peut lire une base de projets, identifier les tâches dont la date d’échéance est dépassée, puis produire un résumé exploitable. La documentation officielle Notion API détaille notamment les endpoints permettant de lire des bases de données et des pages.

Autre cas utile : Avec un serveur MCP Gmail, Claude Code peut extraire des montants de factures depuis des e-mails, à condition que les autorisations OAuth nécessaires soient configurées. OAuth 2.0 est le mécanisme d’autorisation documenté par Google pour donner un accès limité à une application sans partager votre mot de passe. Les références utiles sont la documentation officielle Anthropic Model Context Protocol, la documentation Notion API, la documentation Google OAuth 2.0 et la documentation Gmail API.

Quels prérequis préparer ?

Avant de connecter Claude Code à des serveurs MCP, je prépare surtout l’environnement d’exécution et les accès. Un serveur MCP, pour Model Context Protocol, sert à exposer des outils ou des données externes à Claude de façon standardisée.

Claude Code doit être installé et fonctionnel. Claude Code est l’outil en ligne de commande d’Anthropic qui permet de travailler avec Claude directement dans un environnement de développement, depuis un terminal. C’est lui qui va charger la configuration MCP et dialoguer avec les serveurs déclarés.

Node.js 18 ou supérieur est également nécessaire dans la plupart des cas. Node.js permet d’exécuter du JavaScript côté machine, en dehors du navigateur. Beaucoup de serveurs MCP sont distribués sous forme de paquets npm, c’est-à-dire via le gestionnaire de paquets officiel de l’écosystème Node.js. Les versions modernes de nombreux paquets demandent Node.js 18+, notamment pour bénéficier des API récentes du runtime.

Service à connecter	Identifiant généralement nécessaire
Notion	Token d’intégration Notion, avec accès explicite aux pages ou bases concernées.
Gmail	Autorisation OAuth 2.0, avec les scopes adaptés aux actions prévues.
Autres API	Clé API, token personnel ou identifiants propres au service.

OAuth 2.0 est un protocole d’autorisation. Il permet de donner à une application un accès limité à un compte ou à des données, sans lui transmettre directement votre mot de passe. Les permissions accordées s’appellent souvent des scopes. Par exemple, un scope Gmail peut autoriser uniquement la lecture des emails, ou aussi leur envoi.

La sécurité doit rester simple et stricte. Un token ne doit jamais être collé dans un dépôt Git, même privé. Les permissions doivent être limitées au strict nécessaire. Les variables d’environnement sont préférables aux secrets écrits en dur dans un fichier de configuration. Les clés inutilisées doivent être révoquées, et les scopes OAuth doivent être vérifiés avant validation.

Checklist courte avant installation :

Claude Code installé et fonctionnel
Node.js 18+ installé
Accès terminal disponible
Compte administrateur ou droits suffisants sur l’outil cible
Token API ou configuration OAuth prête
Pages, bases ou boîtes mail explicitement autorisées

Les références utiles sont les documentations officielles Node.js https://nodejs.org/en/docs, npm https://docs.npmjs.com/, Notion API https://developers.notion.com/ et Google OAuth 2.0 https://developers.google.com/identity/protocols/oauth2.

Comment configurer Claude Code ?

Claude Code se configure en déclarant les serveurs MCP dans un fichier JSON nommé claude_desktop_config.json, puis en redémarrant Claude Code pour charger cette configuration. MCP signifie Model Context Protocol : c’est un protocole qui permet à Claude d’appeler des outils externes, par exemple une API, une base de données ou un service métier.

Les emplacements courants indiqués dans l’écosystème Claude Desktop sont les suivants : sur macOS, ~/Library/Application Support/Claude/claude_desktop_config.json ; sur Windows, %APPDATA%\Claude\claude_desktop_config.json. L’emplacement exact peut dépendre de l’outil utilisé, de votre mode d’installation et de la version. Si votre installation diffère, vérifiez la documentation officielle d’Anthropic.

{
  "mcpServers": {
    "example-service": {
      "command": "npx",
      "args": [
        "-y",
        "@example/mcp-server",
        "--project",
        "demo"
      ],
      "env": {
        "EXAMPLE_API_KEY": "votre-cle-api"
      }
    }
  }
}

La structure reste simple, mais chaque élément compte.

La clé mcpServers regroupe tous les serveurs MCP que Claude Code peut lancer.
Le nom example-service est un nom logique choisi par vous, utile pour identifier le serveur.
La clé command indique la commande système à exécuter, ici npx, l’outil Node.js qui lance un package npm.
La clé args contient les arguments passés à la commande, dans l’ordre exact d’exécution.
Le bloc env transmet des variables d’environnement, souvent utilisées pour les clés API, tokens ou identifiants sensibles.

Les erreurs les plus fréquentes sont rarement compliquées, mais elles font perdre du temps. Un JSON invalide suffit à empêcher le chargement : virgule manquante, virgule en trop, guillemets oubliés. Une commande npm ou npx introuvable indique souvent que Node.js n’est pas installé ou pas disponible dans le PATH, c’est-à-dire la liste des dossiers où le système cherche les commandes. Une variable d’environnement absente provoque généralement une erreur d’authentification. Un redémarrage oublié empêche Claude Code de relire le fichier. Des permissions API insuffisantes peuvent aussi donner un résultat vide, même si la connexion fonctionne.

Symptôme	Cause probable	Action
Le serveur n’apparaît pas	Fichier mal placé ou JSON invalide	Vérifier le chemin et valider le JSON
Erreur d’authentification	Token absent ou incorrect	Contrôler la variable d’environnement
Résultat vide	Droits insuffisants côté application	Partager explicitement les ressources

Comment connecter Notion ?

Pour connecter Notion à Claude via MCP, il y a cinq actions à faire dans l’ordre : créer une intégration Notion, récupérer son token, donner accès aux pages ou bases utiles, installer le serveur MCP Notion, puis déclarer ce serveur dans la configuration Claude.

Allez sur https://www.notion.so/my-integrations, puis créez une nouvelle intégration.
Choisissez le bon workspace Notion, surtout si vous en avez plusieurs.
Définissez les capacités nécessaires : lecture seule si Claude doit consulter vos données, écriture uniquement si Claude doit créer ou modifier des pages.
Copiez le token d’intégration, souvent appelé Internal Integration Secret.

Point important : Notion ne donne pas accès automatiquement à tout votre workspace. Chaque page ou base de données doit être partagée explicitement avec l’intégration. Ouvrez la page ou la base concernée, cliquez sur Share, puis utilisez Add connections pour ajouter votre intégration.

Installez ensuite le serveur MCP Notion côté machine. MCP signifie Model Context Protocol : c’est le protocole qui permet à Claude d’appeler des outils externes, comme Notion, de façon structurée.

npm install -g @notionhq/notion-mcp-server

Avant un usage en production, vérifiez toujours le paquet sur npm et dans la documentation officielle. Les sources à consulter sont la documentation Notion API, la page Notion Integrations sur developers.notion.com, et le dépôt ou paquet officiel @notionhq/notion-mcp-server.

Ajoutez ensuite le serveur dans votre fichier claude_desktop_config.json. Remplacez la valeur du token par votre vrai secret Notion.

{
  "mcpServers": {
    "notion": {
      "command": "notion-mcp-server",
      "env": {
        "NOTION_API_KEY": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Redémarrez Claude Code ou Claude Desktop pour recharger la configuration. Un premier test simple consiste à demander : List all databases in my Notion workspace. Si tout est bien configuré, Claude doit voir uniquement les bases partagées avec l’intégration.

Faites ensuite un test plus métier, par exemple : Lis ma base Projets et résume les tâches en retard. Ce test valide à la fois l’accès, la structure de la base et la capacité de Claude à exploiter les propriétés Notion comme les dates, statuts ou responsables.

Si les résultats sont vides, la base n’est probablement pas partagée avec l’intégration.
Si la lecture suffit, évitez les droits d’écriture pour limiter les risques.
Si Claude doit mettre à jour Notion, respectez exactement la structure des propriétés : texte, date, statut, relation, personne ou checkbox.

Que peut-on automatiser ensuite ?

Une fois les MCP servers connectés, Claude Code peut exploiter les outils autorisés comme des sources de travail réelles. Il peut lire, résumer, extraire, comparer et, si vous l’autorisez explicitement, modifier certaines données.

Dans Notion, les usages deviennent vite concrets. Vous pouvez demander une synthèse des projets en retard, la liste des tâches sans responsable, un reporting hebdomadaire ou la recherche des décisions prises dans une base documentaire. Vous pouvez aussi préparer une synthèse client à partir des comptes rendus, tickets et notes commerciales disponibles.

Dans Gmail, sous réserve d’un serveur MCP Gmail correctement configuré, Claude Code peut analyser des messages avec des autorisations OAuth limitées. OAuth est un protocole d’autorisation qui permet de donner un accès précis à une application, sans partager votre mot de passe. Les cas utiles sont simples : extraire les totaux de factures reçues par e-mail, repérer les messages non traités, résumer les échanges d’un client ou identifier les demandes urgentes.

La différence entre lecture et écriture doit rester claire. La lecture sert à analyser, résumer, classer ou comparer des données. L’écriture permet de créer, modifier ou supprimer des informations, par exemple changer le statut d’une tâche Notion ou ajouter un commentaire. Cette deuxième catégorie demande des permissions strictes, des tests et idéalement une validation humaine avant exécution.

Voici des prompts directement utilisables dans Claude Code :

Analyse ma base Notion Projets et liste les tâches en retard avec propriétaire, date d’échéance et statut actuel.

Résume les e-mails de facturation reçus cette semaine et extrait les montants détectés, avec l’expéditeur et la date du message.

Compare les statuts Notion avec les derniers échanges Gmail liés aux mêmes clients et signale les incohérences possibles.

Prépare un reporting hebdomadaire des projets Notion, uniquement à partir des données disponibles, sans modifier les pages.

Pour fiabiliser ces automatisations, la méthode la plus saine reste progressive :

Commencer en lecture seule pour éviter toute modification accidentelle.
Tester sur un périmètre réduit, par exemple une seule base Notion ou une semaine d’e-mails.
Journaliser les actions demandées et les résultats obtenus.
Vérifier manuellement les sorties importantes, surtout les montants, dates et décisions.
Élargir progressivement les droits et le périmètre si les résultats sont fiables.

Action	Risque	Précaution
Résumer une base Notion	Faible	Lecture seule
Extraire des montants d’e-mails	Moyen	Vérification humaine
Modifier des tâches Notion	Élevé	Droits limités et validation

Et si Claude Code devenait vraiment connecté à vos outils ?

Les MCP servers donnent à Claude Code ce qui lui manque par défaut : un accès contrôlé à vos outils réels. Notion devient interrogeable depuis le terminal, Gmail peut alimenter des analyses, et d’autres services peuvent suivre la même logique via leurs API. La clé reste la méthode : installer les bons serveurs, déclarer proprement la configuration, limiter les droits, tester en lecture seule puis élargir progressivement. Bien configuré, ce dispositif évite les copier-coller, accélère les analyses et transforme Claude Code en assistant opérationnel connecté à vos données utiles.

FAQ

Qu’est-ce qu’un MCP server pour Claude Code ?
Un MCP server est un processus qui expose des outils à Claude Code via le Model Context Protocol. Il sert d’intermédiaire entre Claude Code et une application externe, par exemple Notion ou Gmail, en exécutant les appels API nécessaires.
Claude Code peut-il accéder directement à Notion ou Gmail ?
Claude Code n’a pas un accès externe automatique. Il faut déclarer un serveur MCP adapté, fournir les identifiants nécessaires et accorder les permissions côté application. Sans cela, Claude Code ne peut pas lire vos bases Notion ou vos e-mails Gmail.
Pourquoi ma connexion Notion retourne-t-elle des résultats vides ?
La cause la plus fréquente est l’absence de partage entre la page ou la base Notion et l’intégration. Notion limite l’accès aux ressources explicitement partagées avec l’intégration. Il faut utiliser Add connections sur les pages ou bases concernées.
Faut-il donner des droits d’écriture aux MCP servers ?
Pas au départ. Le plus sûr est de commencer en lecture seule, surtout pour tester les résumés, extractions et analyses. Les droits d’écriture doivent être ajoutés uniquement si le cas d’usage le justifie, avec validation humaine et périmètre limité.
Quels sont les principaux risques de sécurité ?
Les risques principaux sont l’exposition de tokens API, des permissions trop larges et des actions d’écriture non contrôlées. Il faut stocker les secrets dans des variables d’environnement, limiter les scopes OAuth, révoquer les accès inutiles et tester sur un périmètre réduit.

A propos de l’auteur

Je suis Franck Scandolera, responsable de l’agence webAnalyste et de l’organisme Formations Analytics. J’accompagne les entreprises sur le tracking avancé server-side, l’Analytics Engineering, l’automatisation No/Low Code avec n8n, l’intégration de l’IA, le SEO et le GEO. J’ai travaillé pour des références comme Logis Hôtel, Yelloh Village, BazarChic, la Fédération Française de Football ou Texdecor. Si vous voulez connecter proprement vos outils, automatiser vos flux de données et intégrer l’IA dans vos process business, contactez-moi.

Franck Scandolera

⭐ Analytics engineer, Data Analyst et Automatisation IA indépendant ⭐

Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…

Mon terrain de jeu :

Data Analyst & Analytics engineering : tracking avancé (GA4, Matomo, Piano, GTM server, Tealium, Commander Act, e-commerce, CAPI, RGPD), entrepôt de données (BigQuery, Snowflake, PostgreSQL, ClickHouse), modèles (Airflow, dbt, Dataform), dashboards décisionnels (Looker, Power BI, Metabase, SQL, Python).
Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.