Canopy.
Guide · Model Context Protocol

Créer son serveur MCP.

Un serveur MCP permet à Claude, ChatGPT ou Cursor d’utiliser directement vos outils et vos données. Ce guide part d’un dossier vide et aboutit à un serveur branché à Claude, avec du code testé sur la version actuelle du SDK. Canopy peut aussi le construire pour vous.

Par , fondateur de Canopy · Mis à jour le

En bref

Qu’est-ce qu’un serveur MCP, et pourquoi en créer un ?

Le Model Context Protocol (MCP) est un standard ouvert qui définit comment une IA se connecte à des outils externes. Anthropic l’a annoncé et publié en open source le 25 novembre 2024 (voir l’introduction officielle). Un serveur MCP déclare des outils (des actions que l’IA peut déclencher), des ressources (des données qu’elle peut lire) et des prompts. Une fois branché, l’assistant découvre ces outils seul et les appelle quand la conversation le demande.

Pour une entreprise, le serveur MCP prolonge le GEO. Une marque déjà citée par les IA devient aussi utilisable par elles. Un client peut demander à son assistant de vérifier un stock, de réserver un créneau ou de comparer vos offres sans passer par votre site.

Le standard n’appartient plus à un seul éditeur. Le 9 décembre 2025, Anthropic a fait don de MCP à l’Agentic AI Foundation, fonds dédié de la Linux Foundation cofondé par Anthropic, Block et OpenAI. À cette date, Anthropic recensait plus de 10 000 serveurs MCP publics actifs et plus de 97 millions de téléchargements mensuels des SDK Python et TypeScript.

Le guide

Comment créer un serveur MCP en cinq étapes ?

Il faut Node.js 22 ou plus récent. Le code ci-dessous a été compilé et exécuté avec le SDK officiel @modelcontextprotocol/sdk en version 1.31.

  1. 01

    Installer le SDK

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

    terminal
    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 se compose d’un nom, d’une description que l’IA lit pour décider quand l’appeler, d’un schéma de paramètres et d’une fonction. L’exemple cherche dans un catalogue produit. Remplacez le tableau par un appel à votre base ou à votre API.

    src/index.ts
    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, l’outil de test officiel, lance votre serveur, liste ses outils et vous permet de les appeler à la main avant de les confier à une IA.

    terminal
    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 Code
    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. La sécurité, les quotas et la supervision se règlent à cette étape.

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).

Local ou distant

Sur votre poste ou en ligne ?

Serveur localServeur distant
UsageOutils internes, prototypes, postes de développeurs.Service ouvert à vos clients, partenaires ou à toute l’équipe.
TransportEn stdio, le client lance le serveur sur la machine.En Streamable HTTP, le serveur tourne sur une URL.
AuthentificationAucune en général, accès limité à la machine.OAuth 2.1, comme le prévoit la spécification MCP.
Mise à jourChaque poste doit récupérer la nouvelle version.Un seul déploiement met tout le monde à jour.
Bonnes pratiques

Les règles d’un bon serveur MCP.

  • 01

    Peu d’outils, bien nommés

    Une IA choisit mieux dans une courte liste d’outils clairs. Partez des tâches de vos utilisateurs avant de regarder la liste de vos routes d’API.

  • 02

    Des descriptions écrites pour l’IA

    Le modèle lit la description pour décider d’appeler l’outil. Écrivez-y ce que fait l’outil, quand l’utiliser et ce qu’il renvoie.

  • 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 seulement les champs utiles et laissez de côté le reste de l’objet stocké en base. Chaque caractère renvoyé consomme le contexte du modèle et dégrade la suite de la conversation.

Référence

Le serveur MCP de Toolzy.io.

Toolzy.io, la marketplace de location d’outils entre voisins que nous avons développée, a son propre serveur MCP. Branché à Claude, il permet de demander « une perceuse à louer près de Bordeaux ce week-end » et d’obtenir des annonces réelles, avec distance, prix et disponibilités. Il expose trois outils.

  • 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. Il filtre par catégorie, prix par jour, livraison et 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.

Chaque description dit à l’IA quand utiliser l’outil et comment présenter le résultat. Voir l’étude de cas Toolzy.

On le construit pour vous

Besoin d’un serveur MCP en production ?

Nous cadrons les outils utiles à vos clients ou à vos équipes, développons le serveur en TypeScript et le branchons à votre API, à Airtable, Supabase ou n8n. La mission comprend l’authentification OAuth, le déploiement et la supervision, comme pour Toolzy. Vous gardez le code.

Serveur MCP sur mesure
Sur devis
Prix ferme après un cadrage
Parler de mon projet
FAQ

Les questions fréquentes sur les serveurs MCP.

Un serveur MCP (Model Context Protocol) expose des outils, des données et des modèles de prompts à une IA selon un protocole standard. Une fois branché, un assistant comme Claude ou ChatGPT peut appeler ces outils au fil de la conversation, par exemple pour chercher dans votre catalogue, créer un ticket ou consulter un stock.

Oui pour un serveur sur mesure. Quelques dizaines de lignes de TypeScript ou de Python suffisent pour un premier outil. Des outils comme n8n permettent aussi d’exposer des workflows en MCP sans écrire de code, avec moins de contrôle sur le comportement.

Claude (Desktop, Code et claude.ai), ChatGPT, Cursor, VS Code avec GitHub Copilot, Windsurf et de nombreux autres. Un même serveur fonctionne dans tous ces outils, ce qui fait l’intérêt du protocole.

Le serveur MCP s’appuie souvent sur votre API et la présente dans un format qu’une IA sait découvrir et utiliser seule, avec la liste des outils, leurs descriptions et leurs schémas de paramètres. L’API s’adresse à des développeurs, le serveur MCP à des agents.

Il l’est autant qu’on le conçoit. Un serveur distant doit authentifier ses utilisateurs (OAuth), limiter chaque outil aux données de l’utilisateur connecté, valider tous les paramètres et journaliser les appels. Les outils qui écrivent des données demandent une attention particulière.

Un serveur local avec quelques outils en lecture se monte en quelques jours. Un serveur distant, authentifié et branché à vos systèmes, relève d’un projet IA & automatisation, chiffré sur devis après un cadrage.