Guide Dify + MCP 2026 : Connectez vos agents IA à n'importe quel outil
Le Model Context Protocol (MCP) est le nouveau standard universel pour connecter les modèles IA aux outils externes. Ce guide vous montre comment intégrer des serveurs MCP dans Dify — en donnant à vos agents l'accès à votre système de fichiers, GitHub, Slack, des bases de données et toute API via une interface standardisée.
Qu'est-ce que le MCP (Model Context Protocol) ?
Le Model Context Protocol (MCP) est un standard ouvert introduit par Anthropic fin 2024. Il définit une façon universelle pour les modèles de langage de se connecter aux outils et sources de données externes. Avant MCP, chaque plateforme IA nécessitait ses propres intégrations pour chaque outil — un connecteur GitHub, un adaptateur de base de données, un lecteur de fichiers, tous développés séparément. MCP change tout cela.
La meilleure analogie : MCP, c'est comme l'USB-C pour l'IA. De même que l'USB-C permet de connecter n'importe quel appareil à n'importe quel ordinateur, MCP permet à n'importe quel agent IA de se connecter à n'importe quel serveur d'outils compatible MCP. Un standard, une extensibilité infinie.
Note technique : MCP utilise une architecture client-serveur via HTTP ou stdio. L'agent IA (client) envoie des requêtes aux serveurs MCP, qui exposent des "outils" — des fonctions que l'agent peut appeler. Le protocole est indépendant du langage : les serveurs peuvent être écrits en Node.js, Python, Go ou tout autre langage.
Standardisé
Un protocole pour tous les outils. Construisez une fois, connectez partout.
Open Source
Licence Apache 2.0. Écosystème de serveurs piloté par la communauté.
Sécurisé
Les serveurs tournent en local ou sur votre réseau privé. Vos données restent les vôtres.
Extensible
Créez des serveurs MCP personnalisés pour toute API, base de données ou service.
Dify comme client MCP
Dify supporte MCP nativement en tant que client, ce qui signifie que vos agents Dify peuvent communiquer avec n'importe quel serveur MCP. Quand vous ajoutez un serveur MCP à Dify, il découvre automatiquement tous les outils exposés et les rend disponibles dans vos applications Agent. Votre agent IA décide lui-même quand appeler quels outils.
C'est une avancée majeure par rapport aux intégrations API traditionnelles. Au lieu de définir manuellement chaque appel API comme un "outil personnalisé" dans Dify, vous pointez Dify vers un serveur MCP et tout le catalogue d'outils est lu automatiquement. Ajoutez un serveur MCP GitHub et votre agent peut immédiatement lister des dépôts, lire des fichiers, créer des issues et passer en revue des pull requests.
Ce que vous pouvez connecter via MCP
Comment connecter un serveur MCP à Dify
Ajouter un serveur MCP comme outil dans Dify prend environ 2 minutes. Voici le processus complet étape par étape :
Démarrer votre serveur MCP
Lancez votre serveur MCP en local ou sur votre serveur. Par exemple, pour démarrer le serveur filesystem officiel d'Anthropic : npx @modelcontextprotocol/server-filesystem /chemin/vers/vos/fichiers — cela démarre un serveur MCP HTTP sur le port 3000 par défaut.
Ouvrir les outils Dify
Dans votre instance Dify, cliquez sur Outils dans la navigation supérieure. Puis cliquez sur Outils personnalisés dans la barre latérale gauche.
Créer un nouvel outil MCP
Cliquez sur le bouton "+ Créer". Dans le sélecteur de type d'outil, choisissez Serveur MCP (pas OpenAPI).
Saisir l'URL du serveur MCP
Collez l'URL de votre serveur MCP, par exemple http://localhost:3000/mcp. Si votre serveur nécessite une authentification, saisissez le token dans le champ Authorization.
Découverte automatique
Dify récupère automatiquement le manifeste des outils du serveur. Vous verrez la liste de tous les outils exposés — ex. "read_file", "list_directory", "write_file" pour un serveur filesystem.
Ajouter à votre application Agent
Ouvrez ou créez une application Agent dans Dify. Dans la section Outils, cliquez sur Ajouter un outil et sélectionnez votre serveur MCP. Votre agent peut maintenant utiliser tous les outils découverts.
Conseil self-hosted : Si Dify et votre serveur MCP tournent sur le même hôte, utilisez l'IP interne ou le nom d'hôte — pas localhost, car Dify tourne dans Docker. Par exemple : http://172.17.0.1:3000/mcp ou http://host.docker.internal:3000/mcp sur macOS/Windows.
Serveurs MCP populaires pour Dify
Anthropic et la communauté maintiennent un écosystème croissant de serveurs MCP. Voici les plus utiles à connecter à Dify :
| Serveur MCP | Fonction | Outils principaux | Installation |
|---|---|---|---|
| filesystem | Lire et écrire des fichiers locaux | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | Dépôts GitHub, PRs, issues | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Messages et canaux Slack | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Accès SQL en lecture seule | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Recherche web en temps réel | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Automatisation navigateur & scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Indexation fichiers Windows | search, get_file_info | npx @modelcontextprotocol/server-everything |
Configurer un serveur MCP : exemple pas à pas
Exemple complet : configurer le serveur MCP filesystem d'Anthropic pour que votre agent Dify puisse lire et écrire des fichiers sur votre serveur.
Étape 1 : Installer Node.js 18+ (ignorer si déjà installé)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Étape 2 : Démarrer le serveur MCP filesystem
npx @modelcontextprotocol/server-filesystem /home/user/documents
# Serveur démarré sur http://localhost:3000/mcp
Étape 3 : Exécuter en service de fond (optionnel)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documents" --name mcp-filesystem pm2 save && pm2 startup
Étape 4 : Tester le serveur
curl http://localhost:3000/mcp
# Devrait retourner : {"name":"filesystem","version":"...","tools":[...]} Étape 5 : Serveur MCP GitHub (avec authentification)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_votre_token_ici \ npx @modelcontextprotocol/server-github
# Créer un PAT GitHub sur : github.com/settings/tokens
Cas d'usage concrets
Trois configurations Dify + MCP prêtes pour la production que vous pouvez reproduire dès aujourd'hui :
Cas d'usage 1 : Assistant documentaire IA
Connectez le serveur MCP filesystem à un agent Dify. Votre IA peut désormais parcourir vos dossiers de documents, lire des contrats, extraire des données clés, comparer des versions et écrire des résumés sur disque — tout en langage naturel. Demandez "résume tous les rapports PDF dans /rapports/T1 et crée un résumé exécutif" et regardez-le s'exécuter.
Cas d'usage 2 : Reviewer de PR GitHub
Connectez le serveur MCP GitHub à Dify. Créez un agent qui révise automatiquement les pull requests : liste les PRs ouvertes, lit les diffs, vérifie les standards de code, identifie les bugs potentiels et poste un commentaire de review — tout depuis l'interface Dify. Planifiez-le via les workflows Dify pour une revue de code automatique.
Cas d'usage 3 : Analyste de base de données
Connectez le serveur MCP PostgreSQL à Dify avec des identifiants en lecture seule. Créez un analyste de données en langage naturel : les utilisateurs posent des questions métier en français, l'agent écrit des requêtes SQL, les exécute sur votre base de données et retourne les résultats de manière lisible. Aucune connaissance SQL nécessaire pour les utilisateurs finaux.
Questions fréquentes
Qu'est-ce que MCP (Model Context Protocol) ?
MCP est un standard ouvert d'Anthropic qui définit comment les modèles IA se connectent aux outils et sources de données externes. C'est comme le 'USB-C pour l'IA' — au lieu d'intégrations personnalisées, un standard universel fonctionne partout. Dify supporte MCP comme client.
Que puis-je connecter à Dify via MCP ?
Via MCP, vous pouvez connecter Dify à : systèmes de fichiers locaux, GitHub (repos, PRs, issues), Slack (messages, canaux), bases PostgreSQL, navigateurs web (Puppeteer), recherche web (Brave, DuckDuckGo) et tout service avec un serveur MCP.
Ai-je besoin de coder pour utiliser MCP avec Dify ?
Pour les serveurs MCP officiels (filesystem, GitHub, etc.), une seule commande npx suffit pour démarrer le serveur, puis ajoutez l'URL dans Dify. Pas de code nécessaire. Créer un serveur MCP personnalisé nécessite des bases en Node.js ou Python.
MCP est-il sécurisé pour la production ?
La sécurité MCP dépend de votre configuration. Exécutez toujours les serveurs MCP sur localhost ou un réseau privé — jamais directement sur internet. Utilisez des tokens d'authentification et limitez l'accès au système de fichiers à des répertoires spécifiques.
Prêt à utiliser Dify + MCP en production ?
MCP est plus puissant quand Dify et les serveurs MCP sont hébergés ensemble — sur le même serveur privé, sans que les données ne quittent votre infrastructure. Hetzner offre des VPS à partir de 3,79 €/mois avec les performances pour faire tourner Dify et plusieurs serveurs MCP simultanément. Ou utilisez Elestio pour un déploiement Dify entièrement géré en un clic.