Comment créer un serveur MCP sous Claude Desktop — un guide pratique - CometAPI

Depuis la présentation publique par Anthropic de Protocole de contexte de modèle (MCP) on 25 novembre 2024MCP est rapidement passé du stade de concept à celui d'écosystème pratique : une spécification ouverte et de multiples serveurs de référence sont disponibles, des implémentations communautaires (serveurs de mémoire, accès au système de fichiers, récupérateurs Web) sont disponibles sur GitHub et NPM, et MCP est déjà pris en charge par des clients tels que Claude pour ordinateur de bureau et des outils tiers. Le protocole a évolué (la spécification et les exemples de serveurs ont été mis à jour jusqu'en 2025), et les fournisseurs et les ingénieurs publient des modèles pour des intégrations plus sûres et utilisant un nombre de jetons plus efficace.

Cet article vous guide pas à pas dans la construction d'un serveur MCP et sa connexion à Claude Desktop, et des conseils pratiques / de sécurité / de mémoire dont vous aurez besoin en production.

Qu'est-ce que le protocole de contexte modèle (MCP) ?

Une définition en langage clair

Le protocole de contexte modèle (MCP) est un protocole ouvert et standardisé Cela permet aux hôtes LLM (les applications exécutant le modèle, par exemple Claude Desktop) de faire facilement appel à des services externes qui exposent numériques (fichiers, lignes de base de données), les outils (fonctions que le modèle peut invoquer), et instructions (modèles utilisables par le modèle). Au lieu de mettre en œuvre N×M intégrations (chaque modèle pour chaque outil), MCP fournit un schéma client-serveur cohérent et un contrat d'exécution afin que tout hôte de modèle compatible MCP puisse utiliser n'importe quel serveur conforme à MCP ; ainsi, les développeurs peuvent créer des services une seule fois et permettre à n'importe quel modèle ou interface utilisateur compatible MCP (par exemple, Claude Desktop) de les utiliser.

Pourquoi le MCP est important maintenant

Depuis qu'Anthropic a rendu le code source de MCP open source fin 2024, le protocole s'est rapidement imposé comme une couche d'interopérabilité de facto pour l'intégration d'outils (Claude, extensions VS Code et autres environnements d'agents). MCP réduit les tâches redondantes, accélère le développement de connecteurs (Google Drive, GitHub, Slack, etc.) et simplifie l'ajout de données persistantes à un assistant.

Qu’est-ce que l’architecture MCP et comment fonctionne-t-elle ?

De manière générale, MCP définit trois groupes de rôles et plusieurs modèles d'interaction.

Composants principaux : clients, serveurs et registre

Client MCP (hôte) : L'hôte ou l'application LLM qui a besoin de données contextuelles (Claude Desktop, un agent VS Code ou une application web) détecte et se connecte à un ou plusieurs serveurs MCP.
Serveur MCP (fournisseur de ressources) : Un service réseau qui expose des ressources (fichiers, mémoires, bases de données, actions) via le schéma MCP. Les serveurs déclarent leurs capacités et fournissent des points d'accès que le client peut appeler.
Registre / Découverte : Composants optionnels ou fichiers de configuration qui aident le client à découvrir les serveurs MCP disponibles, à lister les fonctionnalités et à gérer les autorisations ou l'installation (les « extensions » de bureau constituent une couche UX pour cela).

Flux de messages et négociation des capacités

Les interactions MCP suivent généralement ce schéma :

Découverte / inscription : Le client prend connaissance des serveurs disponibles (registres locaux, réseau ou registres sélectionnés).
Annonce de capacité : Le serveur partage un manifeste décrivant les ressources, les méthodes et les exigences d'autorisation.
Requête / réponse : Le client émet des requêtes structurées (par exemple, « lire le fichier X », « rechercher Y dans la mémoire » ou « créer une PR avec ces fichiers ») et le serveur répond avec des données contextuelles typées.
Résultats et diffusion en continu des actions : Les serveurs peuvent diffuser des résultats en continu ou fournir des points de terminaison pour les opérations de longue durée. La spécification définit des schémas pour les descripteurs de ressources typés et les réponses.

Modèle de sécurité et limites de confiance

MCP standardise intentionnellement les surfaces de contrôle afin que les LLM puissent agir sur les données utilisateur et effectuer des actions. Ce pouvoir exige des contrôles de sécurité rigoureux :

Consentement explicite de l'utilisateur / invites sont recommandées lorsque les serveurs peuvent accéder à des données privées ou effectuer des actions privilégiées (par exemple, écrire dans des référentiels).
Manifestations du moindre privilège : Les serveurs doivent déclarer les étendues minimales et les clients ne doivent demander que les capacités requises.
Transport et autorisation : Pour les intégrations sensibles, utilisez TLS, des identifiants tokenisés et des points de terminaison locaux. La communauté et les fournisseurs de plateformes (par exemple, Microsoft sous Windows) expérimentent différentes approches, notamment en matière de registre et d'interface utilisateur, afin de réduire les risques.

Pourquoi intégrer Claude aux serveurs MCP ?

L'intégration de Claude aux serveurs MCP débloque trois catégories de fonctionnalités pratiques :

Contexte exploitable en temps réel

Au lieu de copier et d'intégrer des instantanés obsolètes dans les invites, Claude peut demander un contexte à jour (fichiers, historique des conversations, lignes de la base de données) lors de chaque requête. Cela se traduit par moins d'extractions approximatives et des résultats plus pertinents. Les démonstrations d'Anthropic montrent Claude en train de créer des demandes de fusion sur GitHub ou de lire des fichiers locaux via MCP.

Des outils compacts et modulables plutôt qu'un adaptateur géant

Vous pouvez créer des serveurs MCP dédiés (un pour le calendrier, un pour le système de fichiers, un pour le stockage vectoriel) et les réutiliser sur différentes instances ou clients Claude (bureau, IDE, web). Cette modularité offre une meilleure évolutivité que les intégrations sur mesure.

Mémoire persistante et standardisée

MCP active les services de mémoire : des espaces de stockage persistants qui encodent l’historique des conversations, les préférences personnelles et l’état structuré de l’utilisateur. Grâce à la standardisation du modèle de ressources par MCP, plusieurs clients peuvent réutiliser le même serveur de mémoire et conserver un contexte utilisateur cohérent entre les applications. Plusieurs services de mémoire communautaires et modèles d’extension existent déjà.

Meilleure expérience utilisateur et contrôle local (Claude Desktop)

Sur les ordinateurs de bureau, MCP permet aux serveurs locaux d'accéder directement au système de fichiers de l'utilisateur (avec son consentement), rendant ainsi possibles les intégrations sensibles à la confidentialité sans recourir aux API cloud. Les extensions de bureau d'Anthropic illustrent la simplification de l'installation et de la détection des serveurs MCP sur les machines locales.

Comment créer un serveur MCP

Ce dont vous avez besoin avant de commencer

Claude DesktopInstallez la dernière version de Claude Desktop compatible avec votre système d'exploitation et assurez-vous que la prise en charge de MCP/Extensions est activée dans les paramètres. Certaines fonctionnalités peuvent nécessiter un abonnement payant (Claude Pro ou équivalent).
Machine de développementNode.js (version 16 ou 18 recommandée) ou Python 3.10+, ainsi que ngrok ou une solution de tunnelisation locale si vous souhaitez exposer un serveur local sur Internet à des fins de test. Utilisez TLS en production.
Le projet MCP fournit des SDK et des modèles dans la documentation principale et sur le dépôt GitHub ; installez le SDK Python ou Node en suivant les instructions officielles dans la documentation/le dépôt.

Option A — Installer un serveur MCP existant (par exemple)

Anthropic fournit des exemples de serveurs, incluant la mémoire, le système de fichiers et les outils.

Cloner les serveurs de référence :

git clone https://github.com/modelcontextprotocol/servers.git
cd servers

À l'intérieur, vous trouverez des dossiers tels que :

filesystem/
fetch/
memory/
weather/

Pour installer un serveur d'exemple :

cd memory
npm install
npm run dev

Cela lance le serveur MCP, généralement à l'adresse :

http://localhost:3000

Vérifiez que le point de terminaison du manifeste fonctionne et que l'appel d'un outil renvoie un JSON correctement typé.

Option B — Créez votre propre serveur MCP (recommandé pour l'apprentissage)

1) Créez un dossier de projet

mkdir my-mcp-server
cd my-mcp-server
npm init -y

2) Installez le SDK du serveur MCP

npm install @modelcontextprotocol/server

3) Créez un fichier serveur de base

Créer server.js:

touch server.js

Collez l'implémentation minimale du serveur MCP :

import { createServer } from "@modelcontextprotocol/server";

const server = createServer({
  name: "my-custom-server",
  version: "0.1.0",

  tools: [
    {
      name: "hello_world",
      description: "Returns a simple greeting",
      input_schema: {
        type: "object",
        properties: {
          name: { type: "string" }
        },
        required: 
      },
      output_schema: {
        type: "object",
        properties: {
          message: { type: "string" }
        }
      },
      handler: async ({ name }) => {
        return { message: `Hello, ${name}!` };
      }
    }
  ]
});

server.listen(3000);
console.log("MCP server running on http://localhost:3000");

Il s'agit d'un Serveur MCP complet exposer un seul outil : hello_world.

Comment connecter Claude Desktop à un serveur MCP ?

Vous trouverez ci-dessous un guide pratique pour créer un serveur MCP simple et l'enregistrer auprès de Claude Desktop. Cette section est très concrète : elle aborde la configuration de l'environnement, la création du manifeste du serveur, l'exposition des points de terminaison attendus par le client et la configuration de Claude Desktop pour utiliser le serveur.

1) Ouvrez l'espace de connexion développeur de Claude Desktop

Dans Claude Desktop : Paramètres → Développeur (ou Paramètres → Connecteurs (Selon la version du client). Il est possible d'ajouter un serveur MCP distant/local ou d'« Ajouter un connecteur ». L'interface utilisateur exacte peut varier d'une version à l'autre ; si vous ne la voyez pas, consultez le menu « Développeur » de l'application de bureau ou les dernières notes de version.

Serveur MCP dans Claude Desktop

2) Si vous configurez un serveur local : créez ou localisez le fichier de configuration

Après avoir lancé l'application de bureau Claude, celle-ci configure automatiquement tous les serveurs MCP détectés dans un fichier nommé ClaudeDesktopConfig.json. La première étape consiste à localiser et ouvrir ce fichier, ou à le créer s'il n'existe pas déjà :

Pour les utilisateurs Windows, le fichier se trouve sous « %APPDATA%\Claude\claude_desktop_config.json ».

Pour les utilisateurs Mac, le fichier se trouve sous « ~/Library/Application Support/Claude/claude_desktop_config.json ».

3) Ajoutez le serveur à Claude Desktop

Il existe deux modèles d'interface utilisateur pour informer Claude Desktop de l'existence de votre serveur MCP :

Extensions de bureau / Installateurs en un clicAnthropic propose des « extensions de bureau » documentées qui regroupent les fichiers manifestes et les installateurs, permettant ainsi aux utilisateurs d'ajouter des serveurs en un seul clic (recommandé pour une distribution à grande échelle). Vous pouvez regrouper votre fichier manifeste et les métadonnées de votre serveur pour une installation simplifiée.

**Enregistrement du serveur local (mode développeur)**Pour les tests locaux :

Placez le fichier manifeste dans un répertoire local connu ou servez-le à l'adresse indiquée. https://localhost:PORT/.well-known/mcp-manifest.json.
Dans les paramètres de Claude Desktop, ouvrez le panneau MCP/Extensions et choisissez « Ajouter un serveur local » ou « Ajouter un serveur par URL », puis collez l'URL du manifeste ou le jeton.
Accordez les autorisations requises lorsque le client vous le demande. Claude listera les ressources du serveur et les présentera comme outils/mémoires disponibles.

Nous allons maintenant installer le MCP local :Ajouter un mcpServers Ce fichier contient le nom de votre serveur et le chemin absolu/la commande pour le démarrer. Enregistrez les modifications et redémarrez Claude Desktop.

Après le redémarrage, l'interface utilisateur de Claude affichera les outils MCP (icône Recherche et outils) et vous permettra de tester les opérations disponibles (par exemple : « Quel temps fait-il à Sacramento ? »). Si l'hôte ne détecte pas votre serveur, consultez la documentation. mcp.log fichiers et mcp-server-<name>.log pour la sortie STDERR.

4) Tester l'intégration

Dans le chat de Claude, tapez :

Call the hello_world tool with name="Alice"

Claude invoquera votre serveur MCP et répondra en utilisant la sortie de l'outil.

Comment implémenter un service de mémoire sur MCP (conseils avancés) ?

Les services de mémoire figurent parmi les serveurs MCP les plus performants, car ils conservent et exposent le contexte utilisateur d'une session à l'autre. Les bonnes pratiques et conseils d'implémentation suivants s'appuient sur les spécifications, la documentation Claude et les modèles de la communauté.

Modèle et conception des données de mémoire

Structuré vs. non structuré : Stockez à la fois des informations structurées (par exemple, nom, préférences) et des fragments de conversation non structurés. Utilisez des métadonnées typées pour un filtrage rapide.
Segmentation et intégration : Découpez les longs documents ou conversations en segments sémantiquement cohérents et stockez leurs représentations vectorielles pour faciliter la recherche par similarité. Cela améliore le rappel et réduit le nombre de jetons utilisés lors de la récupération.
Signaux de récence et de saillance : Enregistrer les horodatages et les scores de saillance ; autoriser les requêtes privilégiant les souvenirs récents ou à forte saillance.
Balises de confidentialité : Attribuez aux éléments des étiquettes de sensibilité (privé, partagé, éphémère) afin que le client puisse demander son consentement.

Modèles d'API pour les opérations en mémoire

Mettre en œuvre au moins trois opérations :

write: Accepte un élément de mémoire avec des métadonnées, renvoie un accusé de réception et un identifiant de stockage.
query: Accepte une requête en langage naturel ou un filtre structuré et renvoie les k meilleurs souvenirs correspondants (éventuellement avec des métadonnées d'explicabilité).
delete/update: Prendre en charge les opérations de cycle de vie et les demandes explicites d'oubli des utilisateurs.

Les réponses de conception doivent inclure la provenance (d'où provient le souvenir) et un score de confiance/similarité afin que le client et le modèle puissent décider de la manière dont le souvenir doit être utilisé.

Stratégies d'augmentation de la récupération pour Claude

Fenêtres de contexte courtes : Renvoyer des extraits de mémoire concis plutôt que des documents complets ; laisser Claude demander le contexte complet si nécessaire.
Couche de synthèse : Il est possible de stocker un bref résumé de chaque élément mémoire afin de réduire le nombre de jetons. Utilisez la synthèse incrémentale lors des écritures.
Injection contrôlée : Fournir la mémoire sous forme d’un « ensemble de contexte » attachable que le client peut injecter sélectivement dans les invites plutôt que de surcharger le modèle avec tout.

Sécurité et gouvernance des MCP de mémoire

Consentement et piste d'audit : Enregistrer la date et l'heure de création d'un souvenir, ainsi que le consentement de l'utilisateur à son partage avec le modèle. Proposer une interface utilisateur claire dans Claude Desktop pour la consultation et la suppression des souvenirs.
Limitation du débit et validation : Se prémunir contre l'injection ou l'exfiltration de code en validant les types et en interdisant les requêtes d'exécution de code inattendues provenant des serveurs.
Chiffrement au repos et en transit : Utilisez un chiffrement robuste pour les données stockées et le protocole TLS pour tous les points de terminaison MCP. Pour les espaces de stockage cloud, utilisez le chiffrement par enveloppe ou des clés gérées par le client, si disponibles.

Conclusion : Comment créer un serveur MCP sous Claude Desktop

Cet article est une recette concise et pragmatique pour passer de zéro à un serveur Claude + mémoire fonctionnel sur votre ordinateur portable :

Tester un flux de travail : Demandez à Claude de « mémoriser » une information concise et vérifiez que le serveur l’a bien enregistrée ; puis demandez-lui de la restituer ultérieurement. Analysez les journaux et optimisez l’ordre de récupération.
Prérequis d'installation : Node.js >= 18, Git, Claude Desktop (dernière version).
Cloner un serveur de référence : fourchette modelcontextprotocol/servers des exemples ou un serveur de mémoire communautaire sur GitHub.
Installer et exécuter : npm install → npm run dev (ou suivez le fichier README du dépôt). Confirmez le point de terminaison du manifeste (par exemple, http://localhost:3000/manifest) renvoie du JSON. ()
Connecteur d'enregistrement dans Claude Desktop : Paramètres → Développeur / Connecteurs → Ajouter un connecteur → pointer vers http://localhost:3000 et approuver les portées.

L'intégration de Claude (ou de tout autre hôte) avec les serveurs MCP vous permet de créer un connecteur une seule fois et de le rendre disponible sur tous les clients MCP — Claude Desktop, IDE ou autres frameworks d'agents — ce qui réduit considérablement la maintenance et accélère la parité des fonctionnalités entre les outils.

Les développeurs peuvent accéder à la dernière API de Claude AI (à la date de publication de cet article), telle que : Claude Sonnet 4.5 API et API Claude Opus 4.1 via CometAPI, la dernière version du modèle est constamment mis à jour avec le site officiel. Pour commencer, explorez les capacités du modèle dans la section cour de récréation et consultez le Guide de l'API Pour des instructions détaillées, veuillez vous connecter à CometAPI et obtenir la clé API avant d'y accéder. API Comet proposer un prix bien inférieur au prix officiel pour vous aider à vous intégrer.

Prêt à partir ?→ Inscrivez-vous à CometAPI dès aujourd'hui !

Si vous souhaitez connaître plus de conseils, de guides et d'actualités sur l'IA, suivez-nous sur VK, X et Discord!

Comment créer un serveur MCP sous Claude Desktop — un guide pratique