Créer son serveur MCP.

1. 01

   Installer le SDK

   Un projet Node.js en module ES, le SDK officiel et Zod pour décrire les paramètres des outils. Python dispose d’un SDK équivalent si votre équipe y est plus à l’aise.

   mkdir mon-serveur-mcp && cd mon-serveur-mcp
   npm init -y && npm pkg set type=module
   npm install @modelcontextprotocol/sdk zod
   npm install -D typescript @types/node

2. 02

   Déclarer un premier outil

   Un outil, c’est un nom, une description que l’IA lit pour décider quand l’appeler, un schéma de paramètres et une fonction. Ici, une recherche dans un catalogue produit. Remplacez le tableau par un appel à votre base ou à votre API.

   import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
   import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
   import { z } from 'zod';
   
   const CATALOGUE = [
     { nom: 'Chaise en chêne', prix: 149, stock: 12 },
     { nom: 'Table basse noyer', prix: 389, stock: 3 },
   ];
   
   const server = new McpServer({ name: 'catalogue', version: '1.0.0' });
   
   server.registerTool(
     'rechercher_produit',
     {
       title: 'Rechercher un produit',
       description: 'Cherche un produit du catalogue par mot-clé. Renvoie le nom, le prix et le stock.',
       inputSchema: { query: z.string().describe('Mot-clé, par exemple « chaise »') },
     },
     async ({ query }) => {
       const resultats = CATALOGUE.filter((p) =>
         p.nom.toLowerCase().includes(query.toLowerCase()),
       );
       return { content: [{ type: 'text', text: JSON.stringify(resultats) }] };
     },
   );
   
   await server.connect(new StdioServerTransport());

3. 03

   Compiler et tester avec l’Inspector

   MCP Inspector est l’outil de test officiel : il lance votre serveur, liste ses outils et vous permet de les appeler à la main avant de les confier à une IA.

   npx tsc --init --module nodenext --target es2022 --outDir dist --rootDir src
   npx tsc
   npx @modelcontextprotocol/inspector node dist/index.js

4. 04

   Le brancher à Claude

   En local, le client lance votre serveur comme un processus et lui parle par l’entrée et la sortie standard (stdio). Avec Claude Code, une commande suffit. Avec Claude Desktop, on déclare le serveur dans le fichier de configuration.

   claude mcp add catalogue -- node /chemin/vers/mon-serveur-mcp/dist/index.js

5. 05

   Le mettre en ligne

   Pour que vos clients ou d’autres équipes l’utilisent sans rien installer, le serveur passe en Streamable HTTP, le transport distant recommandé par la spécification, derrière une authentification OAuth. C’est là que se jouent la sécurité, les quotas et la supervision.

TypeScript n’est pas le seul choix : MCP propose 10 SDK officiels (TypeScript, Python, C#, Go, Rust, Ruby, Java, Swift, PHP, Kotlin), dont 6 classés Tier 1. Côté spécification, une fonctionnalité dépréciée reste en place au moins 12 mois avant de pouvoir être retirée (90 jours en procédure accélérée).

• 01

  Peu d’outils, bien nommés

  Une IA choisit mieux entre six outils clairs qu’entre quarante. Partez des tâches de vos utilisateurs, pas de la liste de vos routes d’API.

• 02

  Des descriptions écrites pour l’IA

  La description est ce que le modèle lit pour décider. Dites ce que fait l’outil, quand l’utiliser, et ce qu’il renvoie. C’est le levier de qualité le plus sous-estimé.

• 03

  Lecture d’abord, écriture ensuite

  Commencez par des outils en lecture seule. Pour ceux qui modifient des données (commande, paiement, suppression), exigez une confirmation et signalez-le dans les annotations de l’outil.

• 04

  Des réponses courtes et structurées

  Renvoyez les champs utiles, pas l’objet complet de votre base. Chaque caractère renvoyé consomme le contexte du modèle et dégrade la suite de la conversation.

• search_tools

  Cherche un outil à louer dans une ville, puis dans les communes voisines sur 15 km. Chaque résultat indique s’il est sur place et à quelle distance. Filtres : catégorie, prix par jour, livraison, accompagnement.

• get_tool_details

  Renvoie la fiche d’une annonce (prix, caractéristiques, photos) et des alternatives de la même catégorie à moins de 20 km, à proposer si l’outil est trop cher ou trop loin.

• check_availability

  Vérifie qu’un outil est libre sur des dates données et calcule le prix total de la location.