Comprendre le MCP

🖥️ ~5 min de lecture 🌶️ Avancé

Vous avez déjà utilisé des connecteurs prêts à l'emploi (Gmail, Google Calendar...). Dans ce module, vous allez apprendre à créer votre propre connecteur pour brancher Claude sur n'importe quel outil — même un logiciel interne que personne d'autre n'utilise.

Partie 1

Qu'est-ce qu'un MCP ?

Le protocole qui permet à Claude de parler à vos outils.

MCP signifie Model Context Protocol. C'est le langage standardisé qu'utilise Claude pour communiquer avec des outils externes. Quand vous installez un connecteur Gmail ou Google Calendar, vous utilisez déjà un serveur MCP — vous ne le saviez peut-être pas.

🔌

L'analogie de la prise électrique

Le MCP, c'est comme une prise électrique standardisée. Tous les appareils (vos outils) ont des formes différentes, mais ils se branchent tous sur la même prise (le protocole MCP). Votre serveur MCP est l'adaptateur qui traduit le format de votre outil vers le format que Claude comprend.

Partie 2

Pourquoi créer son propre MCP ?

Quand les connecteurs existants ne suffisent plus.

Les connecteurs préinstallés couvrent les outils grand public (Gmail, Notion, Slack...). Mais si votre entreprise utilise un outil métier spécifique — un CRM interne, un logiciel de gestion de patients, un ERP fait sur mesure — aucun connecteur existant ne fonctionnera. Il faut en créer un.

→ Votre CRM maison n'a pas de connecteur officiel
→ Votre logiciel de gestion de stock est un outil interne
→ Vous avez une base de données clients accessible via une API
→ Vous voulez connecter Claude à un site web ou une application spécifique

💡 Exemple concret — KinéPro

Imaginez un cabinet de kinésithérapie qui utilise KinéPro, un logiciel de gestion de patients développé sur mesure. Pas de connecteur Gmail ou Notion qui puisse accéder aux fiches patients. La solution : créer un serveur MCP personnalisé qui connecte Claude directement à l'API de KinéPro.

Partie 3

Comment ça fonctionne

Le circuit complet en un coup d'oeil.

🧑‍💻

Vous

Posez une question

→

🤖

Claude

Comprend la demande

→

⚙️
Serveur MCP
Votre adaptateur

→

🏥

KinéPro

Votre outil métier

Le serveur MCP est le traducteur entre Claude et votre outil. C'est le seul fichier que vous devez créer.

📌 Ce que vous allez construire dans ce module

Un serveur MCP complet qui connecte Claude à KinéPro (un logiciel de gestion de cabinet de kinésithérapie). Claude pourra consulter les patients du jour, afficher les fiches patients, et gérer les rendez-vous — le tout en langage naturel.

MCP = le protocole · Serveur MCP = votre adaptateur · API = la porte de votre outil
Ensemble, ils permettent à Claude d'accéder à n'importe quel outil métier.

Préparer les logiciels

🖥️ ~3 min de lecture 🌶️ Avancé

Avant de construire quoi que ce soit, il faut s'assurer que votre ordinateur est prêt. Deux logiciels gratuits à installer — rien de compliqué.

Prérequis

Les outils nécessaires

Deux installations, cinq minutes, et vous êtes prêt.

1

Installer Node.js — Le moteur

Node.js est le moteur qui fait tourner votre serveur MCP. C'est gratuit, léger, et utilisé par des millions de développeurs dans le monde.

→

Allez sur nodejs.org

→

Cliquez sur le gros bouton à gauche qui dit "LTS" (c'est la version recommandée)

→

Téléchargez le fichier, lancez l'installation et cliquez sur "Suivant" tout le temps sans rien changer

💡

Pourquoi Node.js ?

Votre serveur MCP est un petit programme JavaScript. Node.js est le logiciel qui permet de faire tourner du JavaScript en dehors d'un navigateur web. Sans lui, votre serveur ne peut pas démarrer.

2

Installer Claude Desktop

Si vous ne l'avez pas déjà, téléchargez Claude Desktop. C'est l'application de bureau qui va se connecter à votre serveur MCP.

→

Allez sur claude.ai/download

→

Téléchargez la version pour votre système (Windows ou Mac)

→

Installez et connectez-vous avec votre compte Anthropic

Vérification

Tout est bien installé ?

Un test rapide pour confirmer que Node.js fonctionne.

Ouvrez un terminal et tapez cette commande :

Cliquez sur le bouton Démarrer, tapez "CMD" et ouvrez l'invite de commande. Puis tapez :

Vérifier Node.jsCMD
node --version

Appuyez sur Cmd + Espace, tapez "Terminal" et ouvrez-le. Puis tapez :

Vérifier Node.jsTerminal
node --version

✅ Résultat attendu

Vous devriez voir un numéro de version s'afficher (ex : v20.11.0). Si c'est le cas, Node.js est correctement installé et vous pouvez passer à la suite.

⚠️

Si ça ne fonctionne pas

Si le terminal affiche une erreur du type "node" n'est pas reconnu, essayez de redémarrer votre ordinateur après l'installation de Node.js. Si le problème persiste, réinstallez Node.js en vérifiant que l'option "Add to PATH" est bien cochée.

Créer le serveur MCP

🖥️ ~10 min de lecture 🌶️ Avancé

C'est le coeur du module. Vous allez créer deux fichiers, les placer dans un dossier, et lancer une commande d'installation. Même si vous n'avez jamais touché à du code, suivez chaque étape et tout ira bien.

Étape A

Créer le dossier du serveur

L'endroit où vivra votre serveur MCP.

Créez un dossier nommé mcp-server directement sur votre disque C:.

Chemin finalWindows
C:\mcp-server

Créez un dossier nommé mcp-server dans votre dossier "Documents".

Chemin finalMac
~/Documents/mcp-server

Étape B

Créer le fichier package.json

La carte d'identité de votre serveur.

Ouvrez un éditeur de texte (Bloc-notes sur Windows, TextEdit sur Mac), créez un nouveau fichier et collez le contenu ci-dessous. Enregistrez-le sous le nom package.json dans votre dossier mcp-server.

package.jsonJSON
{
  "name": "kinepro-mcp-server",
  "version": "1.0.0",
  "description": "Serveur MCP pour connecter Claude a KinePro",
  "main": "server.js",
  "dependencies": {
    "node-fetch": "^2.6.7"
  }
}

ℹ️

Qu'est-ce que ce fichier ?

Le package.json est la carte d'identité de votre serveur. Il liste le nom du projet et les bibliothèques dont il a besoin (ici, node-fetch pour faire des requêtes vers votre API). C'est Node.js qui lit ce fichier pour savoir quoi installer.

Étape C

Créer le fichier server.js

Le cerveau de votre serveur — le traducteur entre Claude et votre outil.

Créez un nouveau fichier nommé server.js dans le même dossier mcp-server. Collez le contenu ci-dessous :

server.jsJavaScript
// Serveur MCP pour KinéPro
// Ce fichier traduit les demandes de Claude en appels vers l'API KinéPro

const fetch = require('node-fetch');
const readline = require('readline');

// Configuration — récupérée depuis les variables d'environnement
const API_BASE_URL = process.env.API_BASE_URL;
const API_TOKEN   = process.env.API_TOKEN;

// Les "outils" que Claude peut utiliser
const TOOLS = [
  {
    name: "get_patients_today",
    description: "Récupère la liste des patients du jour",
    inputSchema: { type: "object", properties: {} }
  },
  {
    name: "get_patient_detail",
    description: "Affiche la fiche détaillée d'un patient",
    inputSchema: {
      type: "object",
      properties: {
        patient_id: { type: "string", description: "L'identifiant du patient" }
      },
      required: ["patient_id"]
    }
  },
  {
    name: "create_appointment",
    description: "Crée un nouveau rendez-vous pour un patient",
    inputSchema: {
      type: "object",
      properties: {
        patient_id: { type: "string", description: "L'identifiant du patient" },
        date: { type: "string", description: "Date au format YYYY-MM-DD" },
        heure: { type: "string", description: "Heure au format HH:MM" }
      },
      required: ["patient_id", "date", "heure"]
    }
  }
];

// Fonction qui appelle l'API KinéPro
async function callAPI(endpoint, method, body) {
  const response = await fetch(
    `${API_BASE_URL}/${endpoint}`,
    {
      method: method || 'GET',
      headers: {
        'Authorization': `Bearer ${API_TOKEN}`,
        'Content-Type': 'application/json'
      },
      body: body ? JSON.stringify(body) : undefined
    }
  );
  return await response.json();
}

// Gestion des appels d'outils
async function handleToolCall(name, args) {
  switch(name) {
    case 'get_patients_today':
      return await callAPI('patients/today');
    case 'get_patient_detail':
      return await callAPI(`patients/${args.patient_id}`);
    case 'create_appointment':
      return await callAPI('appointments', 'POST', args);
    default:
      return { error: `Outil inconnu : ${name}` };
  }
}

// Boucle de communication MCP (stdin/stdout)
const rl = readline.createInterface({ input: process.stdin });
rl.on('line', async (line) => {
  const msg = JSON.parse(line);
  let response;

  if (msg.method === 'initialize') {
    response = { capabilities: { tools: {} } };
  } else if (msg.method === 'tools/list') {
    response = { tools: TOOLS };
  } else if (msg.method === 'tools/call') {
    const result = await handleToolCall(
      msg.params.name, msg.params.arguments
    );
    response = {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
    };
  }

  if (response) {
    process.stdout.write(
      JSON.stringify({ jsonrpc: '2.0', id: msg.id, result: response }) + '\n'
    );
  }
});

🔍

Décryptage — Pas besoin de comprendre chaque ligne

Ce fichier fait 3 choses simples : 1) Il déclare les outils que Claude peut utiliser (voir les patients, créer un RDV...). 2) Pour chaque outil, il appelle la bonne URL de l'API KinéPro. 3) Il renvoie le résultat à Claude. C'est tout.

Étape D

Installer les dépendances

Une seule commande à taper dans le terminal.

C'est l'étape la plus impressionnante si vous n'avez jamais utilisé un terminal, mais elle est très simple. Une commande, c'est tout.

1

Ouvrir l'invite de commande

Cliquez sur votre bouton Démarrer, tapez "CMD" et ouvrez l'invite de commande.

2

Aller dans le dossier

Tapez la commande suivante et appuyez sur Entrée :

Se déplacer dans le dossierCMD
cd C:\mcp-server

3

Lancer l'installation

Copiez et collez cette commande (clic droit pour coller dans le terminal) puis Entrée :

Installer les dépendancesCMD
npm install && npm install node-fetch

Attendez que les lignes finissent de défiler. Si vous voyez "added X packages", c'est gagné.

1

Ouvrir le Terminal

Appuyez sur Cmd + Espace, tapez "Terminal" et ouvrez-le.

2

Aller dans le dossier

Tapez la commande suivante pour entrer dans le dossier :

Se déplacer dans le dossierTerminal
cd ~/Documents/mcp-server

3

Lancer l'installation

Tapez ensuite cette commande pour tout installer :

Installer les dépendancesTerminal
npm install && npm install node-fetch

Attendez la fin du chargement. Si vous voyez "added X packages", c'est bon.

✅

Votre dossier doit maintenant contenir

server.js + package.json + un dossier node_modules (créé automatiquement par npm). Si vous voyez ces 3 éléments, tout est prêt.

Configurer Claude Desktop

🖥️ ~5 min de lecture 🌶️ Avancé

Il faut maintenant "dire" à Claude Desktop où se trouve votre serveur MCP et comment s'y connecter. C'est une modification dans un seul fichier de configuration.

Étape A

Trouver le fichier de réglages

Le fichier de configuration de Claude Desktop.

Appuyez sur la touche Windows + R, collez ceci et faites Entrée :

Ouvrir le dossier de configWindows
%APPDATA%\Claude\

Cherchez le fichier claude_desktop_config.json. S'il n'existe pas, créez-le.

Ouvrez le Finder, faites Cmd + Shift + G, collez ceci et faites Entrée :

Ouvrir le dossier de configMac
~/Library/Application Support/Claude

Cherchez le fichier claude_desktop_config.json. S'il n'existe pas, créez-le.

Étape B

Modifier le fichier de configuration

Indiquer à Claude où trouver votre serveur MCP.

Faites un clic droit sur le fichier claude_desktop_config.json et choisissez Ouvrir avec... (puis choisissez Bloc-notes sur Windows ou TextEdit sur Mac).

Effacez tout ce qu'il y a dedans et collez le texte correspondant à votre système :

claude_desktop_config.jsonPOUR WINDOWS
{
  "mcpServers": {
    "kinepro": {
      "command": "node",
      "args": ["C:\\mcp-server\\server.js"],
      "cwd": "C:\\mcp-server",
      "env": {
        "API_BASE_URL": "https://kinepro.example.com/api",
        "API_TOKEN": "votre-cle-api-ici"
      }
    }
  }
}

claude_desktop_config.jsonPOUR MAC
{
  "mcpServers": {
    "kinepro": {
      "command": "node",
      "args": ["/Users/NOM_UTILISATEUR/Documents/mcp-server/server.js"],
      "cwd": "/Users/NOM_UTILISATEUR/Documents/mcp-server",
      "env": {
        "API_BASE_URL": "https://kinepro.example.com/api",
        "API_TOKEN": "votre-cle-api-ici"
      }
    }
  }
}

⚠️

Sur Mac : Remplacez NOM_UTILISATEUR

Vous devez remplacer NOM_UTILISATEUR par votre vrai nom de session Mac. Pour le connaître, tapez whoami dans votre Terminal. Si le terminal répond marie, alors remplacez NOM_UTILISATEUR par marie.

Décryptage

Que signifie chaque champ ?

Un tableau pour comprendre ce que vous venez de configurer.

Champ	Signification	Exemple
"kinepro"	Le nom de votre connecteur — vous choisissez ce que vous voulez	kinepro, mon-crm, gestion-stock...
"command"	Le programme qui fait tourner le serveur	Toujours "node" pour un serveur JavaScript
"args"	Le chemin vers votre fichier server.js	Dépend de votre système (Windows ou Mac)
"cwd"	Le dossier de travail du serveur	Le dossier qui contient server.js
"API_BASE_URL"	L'adresse de l'API de votre outil métier	L'URL fournie par votre prestataire technique
"API_TOKEN"	La clé secrète pour s'authentifier auprès de l'API	Un long code fourni par votre prestataire

💡

Où trouver l'API_BASE_URL et l'API_TOKEN ?

Ces informations sont fournies par le développeur de votre outil métier ou par votre prestataire informatique. Si vous avez développé l'outil vous-même, c'est l'URL de votre API et un token d'authentification que vous avez configuré.

Tester et utiliser

🖥️ ~3 min de lecture 🌶️ Avancé

Votre serveur MCP est prêt, Claude est configuré. Il ne reste plus qu'à tout relancer et tester. Voici comment vérifier que tout fonctionne.

Étape 1

Relancer Claude Desktop

Indispensable pour que la nouvelle configuration soit prise en compte.

1

Quitter complètement Claude

Important : ne vous contentez pas de fermer la fenêtre. Faites un clic droit sur l'icône Claude dans la barre des tâches (Windows) ou la barre des menus (Mac) et choisissez "Quit" ou "Quitter".

2

Relancer Claude Desktop

Ouvrez à nouveau l'application Claude Desktop normalement.

3

Vérifier la connexion

Ouvrez une nouvelle conversation. Vous devriez voir une petite icône de marteau 🔨 sous la zone de texte. Cliquez dessus : votre connecteur "kinepro" doit apparaître dans la liste des outils disponibles.

🔨 L'icône marteau

L'icône marteau confirme que Claude a détecté votre serveur MCP. Si vous la voyez, votre connexion fonctionne. Claude utilisera automatiquement votre outil quand vous poserez une question pertinente.

Étape 2

Tester avec des questions

Demandez à Claude d'utiliser votre nouvel outil.

Voici des exemples de ce que vous pouvez demander dans le chat. Claude détectera automatiquement qu'il doit utiliser votre serveur MCP KinéPro :

Exemples de questionsÀ tester
"Quels sont mes patients aujourd'hui ? Affiche-moi ça proprement."

"Donne-moi la fiche complète du patient P-2847."

"Crée un rendez-vous pour Mme Durand le 25 mars à 10h30."

"Combien de patients ai-je cette semaine ? Fais-moi un résumé."

✅

Claude s'adapte à votre langage naturel

Vous n'avez pas besoin de formuler vos questions d'une façon précise. Claude comprend le contexte et choisit automatiquement le bon outil MCP. Posez vos questions comme vous les poseriez à un assistant humain.

Dépannage

Ça ne marche pas ?

Les erreurs les plus courantes et comment les résoudre.

Problème	Cause probable	Solution
Pas d'icône marteau	Claude n'a pas lu la config	Quittez et relancez Claude (pas juste fermer la fenêtre)
Erreur de connexion	API_BASE_URL incorrecte	Vérifiez l'URL dans claude_desktop_config.json
Erreur 401 / Unauthorized	API_TOKEN invalide ou expiré	Demandez un nouveau token à votre prestataire
"node" non reconnu	Node.js mal installé	Réinstallez Node.js et redémarrez votre PC
Erreur JSON	Virgule ou guillemet manquant dans la config	Vérifiez la syntaxe du fichier JSON (pas de virgule après le dernier élément)

🔌

Vous avez créé votre propre MCP !

Vous savez maintenant connecter Claude à n'importe quel outil métier disposant d'une API. Le principe est toujours le même : un fichier server.js qui traduit, un fichier config qui branche. Vous pouvez dupliquer ce serveur et l'adapter à autant d'outils que vous le souhaitez.