Blog

Claude Desktop tutoriel pas-à-pas : installer l’app, configurer les Extensions MCP

10 دقائق للقراءة

Claude Desktop est l’application native officielle d’Anthropic pour macOS, Windows et Linux. Depuis début 2026, elle intègre les Desktop Extensions — des paquets MCP installables en un clic au format .mcpb. Plus besoin d’éditer un JSON à la main : Claude branche votre système de fichiers, votre dépôt GitHub local, une base SQLite ou Google Drive comme on installe une extension de navigateur.

Ce tutoriel vous accompagne pas-à-pas : installation, configuration des Extensions, ajout manuel d’un serveur MCP, premiers cas d’usage concrets (lire vos documents, parler à votre dépôt), et règles de sécurité.

📍 Article principal : Claude AI : le guide complet 2026

Cet article fait partie de la série Claude AI. Pour la vue d’ensemble, lisez d’abord le guide principal.

Prérequis

  • OS : macOS 13+ (Ventura), Windows 10/11 64-bit, ou Linux récent (Ubuntu 22.04+ testé).
  • Compte Anthropic sur claude.ai — un plan Free permet d’essayer, Pro (20 USD/mois) débloque les serveurs MCP locaux sans limite stricte.
  • Node.js 18+ (uniquement si vous utilisez des serveurs MCP basés sur npm comme @modelcontextprotocol/server-filesystem).
  • Connexion réseau : Claude Desktop appelle l’API Anthropic en ligne mais exécute les serveurs MCP localement.
  • Temps estimé : 30 à 45 minutes.

Étape 1 — Télécharger et installer Claude Desktop

L’application est gratuite. Téléchargez l’installeur depuis le site officiel selon votre OS, puis suivez l’assistant standard. Aucun terminal n’est requis pour cette étape.

# Page de téléchargement officielle
# https://claude.ai/download

À la fin de l’installation, lancez l’application. Au premier démarrage, Claude vous demande de vous connecter — utilisez le bouton « Sign in » qui ouvre votre navigateur pour l’OAuth Anthropic. Une fois revenu sur l’app, vous voyez la fenêtre de chat classique. Signal de réussite : votre avatar apparaît en bas à gauche.

Étape 2 — Découvrir le panneau Settings > Extensions

C’est ici que tout se joue. Les Extensions sont des serveurs MCP packagés au format .mcpb — un format conçu par Anthropic pour distribuer un binaire MCP avec son manifeste, ses permissions et sa configuration par défaut, exactement comme une extension Chrome.

Ouvrez le menu Claude (icône en haut), choisissez Settings, puis l’onglet Extensions. Vous y trouvez deux sections :

  • Installed : la liste des extensions actives sur cette machine.
  • Browse extensions : un répertoire d’extensions revues par Anthropic. À noter : seuls quelques serveurs MCP sont activement maintenus par Anthropic (Filesystem, Fetch, Git, Memory, Sequential Thinking, Time, Everything). Les serveurs SQLite, GitHub, Google Drive et PostgreSQL ont été archivés en mai 2025 et déplacés dans servers-archived — ils restent fonctionnels comme implémentations de référence, mais ne sont plus mis à jour. Les Extensions du répertoire mélangent serveurs officiels et forks communautaires : lisez l’auteur et la date de publication avant d’installer.

Notez que chaque extension demande des permissions explicites à la première activation (lecture de tel dossier, accès à tel token). Refusez les permissions globales et n’autorisez que les chemins dont vous avez besoin — Claude est un agent, pas un script en lecture seule.

Étape 3 — Installer l’extension Filesystem en un clic

Filesystem est l’extension la plus utile pour démarrer : elle donne à Claude le droit de lire et écrire dans un dossier précis. Idéal pour faire trier vos notes, renommer un dossier de scans, ou générer un index Markdown à partir de fichiers.

Dans Browse extensions, cherchez « Filesystem », cliquez sur Install. Claude Desktop vous demande deux choses :

  1. Le chemin racine autorisé — par exemple ~/Documents/projets-claude. C’est la seule zone que l’extension peut toucher.
  2. Mode lecture seule ou lecture/écriture. Commencez en lecture seule, escaladez plus tard.

Validez. L’extension passe en Active avec un pastille verte. Testez immédiatement dans une nouvelle conversation :

Liste les fichiers du dossier configuré et résume ce qu'il contient.

Claude répond en listant les fichiers du dossier que vous avez autorisé, avec un résumé pour chacun. Si vous voyez « Tool not available », vérifiez que l’extension est bien activée et que la conversation a été redémarrée — Claude charge les outils MCP au début de chaque session.

Étape 4 — Ajouter un serveur MCP manuellement (sans Extension)

Certains serveurs MCP utiles n’ont pas encore d’Extension officielle — par exemple un MCP que vous écrivez vous-même, ou un connecteur communautaire. Dans ce cas vous éditez le fichier de configuration JSON. Son emplacement :

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows : %APPDATA%\Claude\claude_desktop_config.json
  • Linux : ~/.config/Claude/claude_desktop_config.json

Exemple minimal pour ajouter le serveur Filesystem (officiellement maintenu par Anthropic) :

{
  "mcpServers": {
    "fs-projets": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/moi/projets"
      ]
    }
  }
}

Sauvegardez le fichier, quittez complètement Claude Desktop (Cmd+Q sur macOS, clic droit dans le tray sur Windows — pas juste fermer la fenêtre), puis rouvrez. L’icône 🔌 apparaît dans la barre du bas du chat : cliquez dessus pour voir les serveurs MCP détectés. Si fs-projets est marqué « connected », vous pouvez maintenant demander « liste les fichiers Markdown du dossier » et Claude exécute la requête.

Pour brancher une base SQLite, GitHub, Google Drive ou PostgreSQL, utilisez un fork communautaire maintenu (par exemple @berthojoris/mcp-sqlite-server pour SQLite) ou écrivez votre propre serveur — la spécification MCP est ouverte et un projet TypeScript ou Python d’une cinquantaine de lignes suffit pour un cas simple.

Étape 5 — Cas d’usage : organiser un dossier de documents

Maintenant que Filesystem est branché, voici un workflow réel utile pour un freelance, un formateur ou un comptable. Imaginons un dossier ~/Documents/factures-2025 rempli de PDF nommés au hasard (Document-1.pdf, scan-final-FINAL2.pdf…).

Dans Claude Desktop :

Parcours le dossier factures-2025. Pour chaque PDF, lis le contenu, identifie le client et le mois,
et renomme le fichier en YYYY-MM_NomClient.pdf. Avant de renommer, montre-moi le mapping prévu.

Claude liste d’abord les fichiers, lit le texte de chaque PDF (extraction native), propose le mapping, et n’exécute le renommage qu’après votre validation. Sur un dossier de 40 PDF, comptez 3 à 5 minutes. Output attendu : un dossier où chaque facture est désormais identifiable d’un coup d’œil — utile à Dakar comme à Abidjan où la comptabilité PME se fait souvent dossier par dossier.

Étape 6 — Cas d’usage : naviguer dans un dépôt GitHub local

L’extension GitHub officielle Anthropic ayant été archivée, installez un fork communautaire de GitHub MCP depuis Browse extensions (vérifiez la fraîcheur du dépôt avant d’installer) ou éditez le JSON pour pointer vers npx -y <package-github-mcp-maintenu>. L’extension demande un token GitHub — préférez un fine-grained token limité à 1-2 dépôts plutôt qu’un token classique avec scope repo qui voit tout votre compte.

Vous pouvez maintenant demander à Claude des choses qui prenaient 15 minutes auparavant :

  • « Liste les 10 dernières issues ouvertes sur mon dépôt monrepo, regroupe par label. »
  • « Compare la branche develop avec main et résume les changements. »
  • « Ouvre une PR depuis ma branche feature/auth avec un titre et une description que tu rédiges. »

La différence avec Claude Code en CLI : Claude Desktop reste un chat — pratique pour discuter avec votre code sans ouvrir un terminal. Pour du code génératif lourd (refactor, scaffolding), basculez sur Claude Code en CLI qui est conçu pour cela.

Étape 7 — Sécurité, permissions et désactivation

Les serveurs MCP locaux ont accès à votre disque, à vos tokens et parfois à vos bases. Trois règles à graver :

  1. Une extension par usage, un chemin par extension — ne donnez jamais accès à ~/ en entier. Créez un dossier dédié ~/Documents/projets-claude/ et travaillez à l’intérieur.
  2. Tokens GitHub à scope minimal — préférez un token fine-grained limité à un ou deux dépôts plutôt qu’un token classique repo qui voit tout.
  3. Audit régulier — dans Settings > Extensions, désactivez les extensions inutilisées. Une extension désactivée ne consomme ni token API, ni n’expose votre disque.

Pour désinstaller proprement une extension, cliquez dessus dans Installed, choisissez Uninstall. Le binaire est supprimé et l’entrée disparaît du fichier de config.

Étape 8 — Adaptation au contexte ouest-africain

Claude Desktop fait quelques aller-retours réseau pour chaque message — l’inférence reste côté Anthropic. Sur une connexion 4G de Dakar, Bamako ou Ouagadougou, les latences sont acceptables mais vous payez en données. Trois gestes utiles :

  • Préférez les sessions courtes — fermez la conversation quand vous avez terminé pour éviter que Claude ne recharge du contexte inutilement.
  • Utilisez les extensions locales — un MCP filesystem qui lit 200 fichiers ne coûte que des tokens d’API ; il n’envoie pas les 200 fichiers d’un coup, seulement les morceaux pertinents.
  • Paiement — Pro à 20 USD/mois est facturable en USD par carte Visa internationale (Wave, Mixx by Yas et Orange Money ne sont pas acceptés directement par Anthropic en mai 2026). Pour les freelances sans carte internationale, l’API à l’usage via un compte Anthropic + carte virtuelle reste l’option la plus accessible.

Erreurs fréquentes

Erreur Cause Solution
« Tool not available » dans le chat Extension installée mais conversation pas redémarrée Fermer et rouvrir la conversation (Cmd+N), Claude recharge les outils MCP
Le fichier de config JSON est ignoré App pas vraiment quittée (juste minimisée) Cmd+Q sur macOS, ou Quit Claude depuis le tray Windows
JSON invalide après édition manuelle Virgule en trop ou guillemets unicode Vérifier avec jq . claude_desktop_config.json avant de relancer
Permission denied sur le dossier filesystem macOS demande l’accès au dossier Documents Authoriser dans Préférences Système > Confidentialité > Fichiers et dossiers
Le serveur npx met longtemps au démarrage Première résolution du package npm Pré-installer en global : npm install -g @modelcontextprotocol/server-filesystem puis remplacer npx par le binaire dans le JSON

Tutoriels frères

Pour aller plus loin

FAQ

Claude Desktop est-il gratuit ?

L’application est gratuite à télécharger. L’usage avec un plan Free est possible mais limité ; les serveurs MCP locaux deviennent vraiment utiles avec un plan Pro (20 USD/mois) ou Max.

Quelle différence entre Claude Desktop et Claude.ai dans le navigateur ?

Le navigateur n’autorise pas l’exécution de serveurs MCP locaux. Pour lire vos fichiers, parler à votre dépôt local ou requêter une base SQLite sur votre disque, Claude Desktop est obligatoire.

Une Extension peut-elle accéder à tout mon disque ?

Non — chaque Extension demande une permission explicite à la première activation, généralement un chemin précis. Vous pouvez révoquer la permission à tout moment depuis Settings > Extensions.

Puis-je écrire ma propre Extension ?

Oui. Une Extension est un serveur MCP packagé au format .mcpb avec un manifeste. La documentation Anthropic décrit le format ; un projet TypeScript ou Python suffit pour démarrer.

Quels OS sont officiellement supportés en mai 2026 ?

macOS 13+, Windows 10/11, et Linux récent (Ubuntu 22.04 testé). Sur Linux, certaines distributions exigent une installation via AppImage ou Flatpak — vérifiez la page de téléchargement.

Mes conversations Claude Desktop sont-elles privées ?

Les messages transitent par l’API Anthropic (politique de rétention standard). Les fichiers lus par un serveur MCP local restent sur votre machine sauf si vous les copiez dans la conversation — Claude voit seulement les extraits qu’il choisit de lire pour répondre.

Sponsoriser ce contenu

Cet emplacement est à vous

Position premium en fin d'article — c'est l'instant où les lecteurs sont le plus engagés. Réservez cet espace pour votre marque, votre formation ou votre offre.

Recevoir nos tarifs
Publicité