Fiche concept

Transport stdio MCP — pour Claude Desktop, Claude Code, agents locaux

À jour au 2026-07-24T14:00:00Z

Édité par Cédric-Olivier Mâry, éditeur et directeur de la publication — 27 ans d'écosystème SAP. Comment ces pages sont produites, et où intervient l'automatisation.

Qu'est-ce que Transport stdio MCP — pour Claude Desktop, Claude Code, agents locaux ?

Le transport stdio de MCP est un canal fragile où un seul console.log accidentel sur stdout peut corrompre la trame JSON-RPC et bloquer la session — tout serveur doit router ses diagnostics exclusivement vers stderr.

Le transport stdio du MCP relie un serveur Model Context Protocol à un client — Claude Desktop, Claude Code, ou un script d'agent local — en faisant transiter des messages JSON-RPC 2.0 délimités par des sauts de ligne sur l'entrée et la sortie standard du processus. Le client démarre le serveur comme processus enfant ; le serveur lit les requêtes depuis stdin, écrit les réponses sur stdout, et envoie chaque ligne de journal ou message de débogage exclusivement vers stderr. Cette frontière n'est pas une préférence de style, elle est structurelle : une seule instruction d'affichage égarée, ou un simple message de console atterrissant sur stdout, corrompt la trame JSON-RPC et bloque ou fait planter la session sur-le-champ. La première ligne de défense de tout auteur de serveur consiste à router toute sortie de diagnostic vers stderr dès la toute première ligne de code.

Choisir entre stdio et HTTP

Pourquoi c'est important

Claude Desktop et Claude Code utilisent stdio par défaut car l'OS gère l'isolation des processus et l'authentification est implicite — zéro configuration réseau à gérer.
Ne passez à HTTP que si le serveur doit être partagé entre clients/machines, est persistant indépendamment d'un client, cible un conteneur sans lancement de processus enfant, ou a besoin de TLS/bearer auth fins.
Une erreur fréquente est de basculer vers HTTP pour un « effet production » sur une boîte à outils personnelle, perdant la simplicité du stdio sans raison.

Points clés

Transport stdio — l'hôte lance le serveur en processus enfant ; messages JSON-RPC 2.0 séparés par sauts de ligne sur stdin/stdout.
Modèle de confiance — la frontière de processus OS est la frontière de sécurité ; l'hôte qui lance le serveur est de confiance par l'utilisateur.
Cas d'usage — Claude Desktop, Claude Code, Cursor, Continue, tout IDE-agent local ; boucle de productivité d'un seul développeur.
Discipline de logs — stderr seul ; écrire sur stdout corrompt le flux JSON-RPC et déconnecte l'hôte.
Mono-client par construction — migrez vers Streamable HTTP (C227) dès qu'il faut plus d'un opérateur sur le serveur.

Termes employés sur cette page

stdio transport: Format de communication MCP où l'hôte lance le serveur comme processus enfant et échange des messages JSON-RPC 2.0 via son stdin/stdout ; le mode de déploiement le plus simple.
claude_desktop_config.json: Fichier de configuration JSON par utilisateur où Claude Desktop enregistre les serveurs MCP ; liste command + args + env pour chaque serveur.
JSON-RPC 2.0: Protocole léger d'appel de procédure distante sur JSON ; l'encodage de communication de chaque message MCP quel que soit le transport.
Single-client constraint: Propriété architecturale de stdio : un seul processus hôte possède les flux d'E/S du serveur ; un second client nécessite le transport HTTP.
Decision owner: La personne responsable qui assume l'arbitrage et finance l'action suivante.
Semantic contract: La définition partagée des termes métier, métriques, entités et règles d'accès utilisée par les outils et les équipes.
Control plane: La couche qui applique la politique, l'accès, la traçabilité, la supervision et l'escalade à travers le modèle opérationnel.
Evidence grade: Une étiquette qui distingue le fait vérifié, le signal directionnel, l'hypothèse modélisée et l'observation de terrain.

Sources

Fiche complète réservée aux abonnés. Ce que la fiche complète ajoute : le cadre de décision complet · la comparaison SAP · Snowflake · Databricks · Fabric · les pièges courants et leur correctif · l'aide-mémoire · les schémas d'architecture · les blocs de code · les chiffres à citer.

Ouvrir dans l'application →