Dify + MCP Anleitung 2026: KI-Agenten mit beliebigen Tools verbinden
Das Model Context Protocol (MCP) ist der neue universelle Standard, um KI-Modelle mit externen Tools zu verbinden. Diese Anleitung zeigt dir, wie du MCP-Server in Dify einbindest — und deinen Agenten Zugriff auf Dateisysteme, GitHub, Slack, Datenbanken und beliebige APIs gibst.
Was ist MCP (Model Context Protocol)?
Das Model Context Protocol (MCP) ist ein offener Standard, den Anthropic Ende 2024 veröffentlicht hat. Er definiert, wie KI-Sprachmodelle sich mit externen Tools und Datenquellen verbinden. Bisher brauchte jede KI-Plattform eigene Integrationen für jedes Tool — einen GitHub-Connector, einen Datenbank-Adapter, einen Datei-Reader, alle separat entwickelt. MCP ändert das grundlegend.
Die beste Analogie: MCP ist wie USB-C für KI. So wie USB-C es erlaubt, jedes Gerät an jeden Computer anzuschließen, ermöglicht MCP jedem KI-Agenten die Verbindung mit jedem MCP-kompatiblen Tool-Server. Ein Standard, unbegrenzte Erweiterbarkeit.
Technischer Hintergrund: MCP nutzt eine Client-Server-Architektur über HTTP oder stdio. Der KI-Agent (Client) sendet Anfragen an MCP-Server, die "Tools" bereitstellen — Funktionen, die der Agent aufrufen kann. Das Protokoll ist sprachunabhängig: Server können in Node.js, Python, Go oder jeder anderen Sprache geschrieben sein.
Standardisiert
Ein Protokoll für alle Tools. Einmal bauen, überall verbinden.
Open Source
Apache-2.0-Lizenz. Community-getriebenes Ökosystem von Servern.
Sicher
Server laufen lokal oder im privaten Netzwerk. Deine Daten bleiben bei dir.
Erweiterbar
Baue eigene MCP-Server für jede API, Datenbank oder jeden Dienst.
Dify als MCP-Client
Dify unterstützt MCP nativ als Client. Das bedeutet: Deine Dify-Agenten können direkt mit jedem MCP-Server kommunizieren. Wenn du einen MCP-Server zu Dify hinzufügst, erkennt Dify automatisch alle bereitgestellten Tools und macht sie in deinen Agent-Apps verfügbar. Dein KI-Agent entscheidet eigenständig, wann er welche Tools aufruft.
Das ist ein erheblicher Fortschritt gegenüber klassischen API-Integrationen. Statt für jede API einen eigenen "Custom Tool"-Eintrag in Dify anzulegen, zeigst du Dify einfach auf einen MCP-Server — und der gesamte Tool-Katalog wird automatisch eingelesen. Füge einen GitHub-MCP-Server hinzu und dein Agent kann sofort Repos auflisten, Dateien lesen, Issues erstellen und Pull Requests reviewen.
Was du über MCP verbinden kannst
MCP-Server mit Dify verbinden — Schritt für Schritt
Einen MCP-Server als Tool in Dify hinzuzufügen dauert etwa 2 Minuten. Hier ist der vollständige Ablauf:
MCP-Server starten
Starte deinen MCP-Server lokal oder auf deinem Server. Beispiel für den offiziellen Anthropic Filesystem-Server: npx @modelcontextprotocol/server-filesystem /pfad/zu/deinen/dateien — startet einen HTTP-MCP-Server auf Port 3000.
Dify Tools öffnen
Klicke in Dify auf Tools in der oberen Navigation, dann im linken Bereich auf Custom Tools.
Neues MCP-Tool erstellen
Klicke auf "+ Erstellen". Wähle als Tool-Typ MCP Server aus (nicht OpenAPI).
MCP-Server-URL eingeben
Füge die URL deines MCP-Servers ein, z.B. http://localhost:3000/mcp oder http://deine-server-ip:3000/mcp. Falls dein Server eine Authentifizierung erfordert, trage den Auth-Token im Authorization-Header-Feld ein.
Auto-Discovery
Dify lädt automatisch das Tool-Manifest des Servers. Du siehst eine Liste aller bereitgestellten Tools — z.B. "read_file", "list_directory", "write_file" für einen Filesystem-Server.
Zu Agent-App hinzufügen
Öffne oder erstelle eine Agent-App in Dify. Im Abschnitt Tools klickst du auf Tool hinzufügen und wählst deinen MCP-Server aus. Dein Agent kann ab sofort alle erkannten Tools nutzen.
Self-Hosting-Hinweis: Wenn Dify und dein MCP-Server auf demselben Host laufen, verwende die interne IP oder den Hostnamen des Servers — nicht localhost, da Dify in Docker läuft. Nutze z.B.: http://172.17.0.1:3000/mcp oder http://host.docker.internal:3000/mcp auf macOS/Windows.
Beliebte MCP-Server für Dify
Anthropic und die Community pflegen ein wachsendes Ökosystem von MCP-Servern. Die nützlichsten für Dify:
| MCP-Server | Funktion | Wichtigste Tools | Installation |
|---|---|---|---|
| filesystem | Lokale Dateien lesen und schreiben | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | GitHub Repos, PRs, Issues | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Slack Nachrichten & Channels | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Read-only SQL-Datenbankzugriff | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Echtzeit-Websuche | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Browser-Automatisierung & Scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Windows-Dateisuche (Everything) | search, get_file_info | npx @modelcontextprotocol/server-everything |
MCP-Server einrichten: Schritt-für-Schritt-Beispiel
Vollständiges Beispiel: Den Anthropic Filesystem-MCP-Server aufsetzen, damit dein Dify-Agent Dateien auf deinem Server lesen und schreiben kann.
Schritt 1: Node.js 18+ installieren (überspringen, wenn bereits installiert)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Schritt 2: Filesystem-MCP-Server starten
npx @modelcontextprotocol/server-filesystem /home/user/dokumente
# Server läuft auf http://localhost:3000/mcp
Schritt 3: Als Hintergrunddienst betreiben (optional)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/dokumente" --name mcp-filesystem pm2 save && pm2 startup
Schritt 4: Server testen
curl http://localhost:3000/mcp
# Erwartete Ausgabe: {"name":"filesystem","version":"...","tools":[...]} Schritt 5: GitHub-MCP-Server (mit Authentifizierung)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_dein_token_hier \ npx @modelcontextprotocol/server-github
# GitHub PAT erstellen unter: github.com/settings/tokens
Praxisnahe Anwendungsfälle
Drei produktionsreife Dify-+MCP-Setups, die du heute nachbauen kannst:
Anwendungsfall 1: KI-Dokumentenassistent
Verbinde den Filesystem-MCP-Server mit einem Dify-Agenten. Der KI-Agent kann jetzt deine Dokumentenordner durchsuchen, Verträge lesen, wichtige Daten extrahieren, Versionen vergleichen und Zusammenfassungen zurückschreiben — alles per natürlicher Sprache. "Fasse alle PDF-Berichte in /berichte/Q1 zusammen und erstelle eine Management-Summary" — und es funktioniert.
Anwendungsfall 2: GitHub PR-Reviewer
Verbinde den GitHub-MCP-Server mit Dify. Baue einen Agenten, der Pull Requests automatisch reviewt: offene PRs auflisten, Diffs lesen, Code-Standards prüfen, potenzielle Bugs identifizieren und ein Review-Kommentar posten — alles innerhalb der Dify-Oberfläche. Via Dify-Workflows zeitgesteuert ausführen für automatisches Code-Review.
Anwendungsfall 3: Datenbank-Analyst
Verbinde den PostgreSQL-MCP-Server mit Dify und read-only-Zugangsdaten. Baue einen natürlichsprachlichen Datenanalysten: Nutzer stellen Geschäftsfragen auf Deutsch, der Agent schreibt SQL-Abfragen, führt sie gegen die Datenbank aus und gibt die Erkenntnisse in menschenlesbarer Form zurück. Kein SQL-Wissen auf Nutzerseite nötig.
Häufig gestellte Fragen
Was ist MCP (Model Context Protocol)?
MCP ist ein offener Standard von Anthropic, der definiert, wie KI-Modelle sich mit externen Tools und Datenquellen verbinden. Denk es als 'USB-C für KI' — statt individueller Integrationen für jedes Tool funktioniert ein Standard überall. Dify unterstützt MCP als Client.
Was kann ich über MCP mit Dify verbinden?
Über MCP kannst du Dify verbinden mit: lokalen Dateisystemen, GitHub (Repos, PRs, Issues), Slack (Nachrichten, Channels), PostgreSQL-Datenbanken, Webbrowsern (Puppeteer), Websuche (Brave, DuckDuckGo) und beliebigen Diensten mit MCP-Server.
Brauche ich Programmierkenntnisse für MCP mit Dify?
Für offizielle MCP-Server (Filesystem, GitHub usw.) reicht ein einziger npx-Befehl zum Starten, dann URL in Dify eintragen. Kein Coding nötig. Einen eigenen MCP-Server zu bauen erfordert grundlegende Node.js- oder Python-Kenntnisse.
Ist MCP für den Produktionseinsatz sicher?
MCP-Sicherheit hängt von deiner Server-Konfiguration ab. Betreibe MCP-Server immer auf localhost oder einem privaten Netzwerk — nie direkt im Internet. Nutze Auth-Tokens und schränke den Dateizugriff auf bestimmte Verzeichnisse ein.
Dify + MCP in der Produktion betreiben?
MCP entfaltet seine volle Stärke, wenn Dify und die MCP-Server gemeinsam self-hosted werden — auf demselben privaten Server, ohne dass Daten die eigene Infrastruktur verlassen. Hetzner bietet VPS ab €3,79/Monat mit der Performance für Dify und mehrere MCP-Server gleichzeitig. Oder nutze Elestio für ein vollständig gemanagtes, One-Click-Dify-Deployment.