Dify + MCP Handleiding 2026: KI-Agenten verbinden met willekeurige tools
Het Model Context Protocol (MCP) is de nieuwe universele standaard om KI-modellen te verbinden met externe tools. Deze handleiding laat zien hoe je MCP-servers integreert in Dify en je agenten toegang geeft tot bestandssystemen, GitHub, Slack, databases en willekeurige APIs.
Wat is MCP (Model Context Protocol)?
Het Model Context Protocol (MCP) is een open standaard die Anthropic eind 2024 heeft gepubliceerd. Het definieert hoe KI-taalmodellen verbinding maken met externe tools en gegevensbronnen. Tot nu toe had elk KI-platform eigen integraties nodig voor elke tool. MCP verandert dat fundamenteel.
De beste analogie: MCP is als USB-C voor KI. Net zoals USB-C elk apparaat aan elke computer laat aansluiten, stelt MCP elke KI-agent in staat verbinding te maken met elke MCP-compatibele tool-server. Één standaard, onbeperkte uitbreidbaarheid.
Technische achtergrond: MCP gebruikt een client-server-architectuur via HTTP of stdio. De KI-agent (client) stuurt verzoeken naar MCP-servers die "tools" aanbieden — functies die de agent kan aanroepen. Het protocol is taalonafhankelijk: servers kunnen worden geschreven in Node.js, Python, Go of elke andere taal.
Gestandaardiseerd
Één protocol voor alle tools. Eén keer bouwen, overal verbinden.
Open source
Apache-2.0-licentie. Community-gedreven ecosysteem van servers.
Veilig
Servers draaien lokaal of in een privénetwerk. Je gegevens blijven bij jou.
Uitbreidbaar
Bouw eigen MCP-servers voor elke API, database of dienst.
Dify als MCP-client
Dify ondersteunt MCP native als client. Dat betekent: je Dify-agenten kunnen rechtstreeks communiceren met elke MCP-server. Wanneer je een MCP-server toevoegt aan Dify, herkent Dify automatisch alle aangeboden tools en maakt ze beschikbaar in je agent-apps. Je KI-agent beslist zelfstandig wanneer hij welke tools aanroept.
Dit is een aanzienlijke vooruitgang ten opzichte van klassieke API-integraties. In plaats van voor elke API een aparte aangepaste tool in Dify aan te maken, wijs je Dify eenvoudig naar een MCP-server — en de volledige toolcatalogus wordt automatisch ingeladen.
Wat je via MCP kunt verbinden
MCP-server verbinden met Dify — stap voor stap
Een MCP-server als tool toevoegen in Dify duurt ongeveer 2 minuten. Dit is de volledige werkwijze:
MCP-server starten
Start je MCP-server lokaal of op je server. Voorbeeld voor de officiële Anthropic Filesystem-server: npx @modelcontextprotocol/server-filesystem /pad/naar/je/bestanden — start een HTTP-MCP-server op poort 3000.
Dify Tools openen
Klik in Dify op Tools in de bovenste navigatie, vervolgens op Aangepaste tools in het linkergedeelte.
Nieuwe MCP-tool aanmaken
Klik op Aanmaken. Kies als tooltype MCP-server (niet OpenAPI).
MCP-server-URL invoeren
Plak de URL van je MCP-server, bijv. http://localhost:3000/mcp of http://jouw-server-ip:3000/mcp. Als je server authenticatie vereist, voer dan het auth-token in het veld Authorization-header in.
Automatische detectie
Dify laadt automatisch het tool-manifest van de server. Je ziet een lijst van alle aangeboden tools — bijv. read_file, list_directory, write_file voor een Filesystem-server.
Toevoegen aan agent-app
Open of maak een agent-app in Dify. Klik in het gedeelte Tools op Tool toevoegen en selecteer je MCP-server. Je agent kan vanaf nu alle herkende tools gebruiken.
Opmerking bij zelfhosting: Als Dify en je MCP-server op dezelfde host draaien, gebruik dan het interne IP-adres of de hostnaam van de server — niet localhost, omdat Dify in Docker draait. Gebruik bijv.: http://172.17.0.1:3000/mcp of http://host.docker.internal:3000/mcp op macOS/Windows.
Populaire MCP-servers voor Dify
Anthropic en de community onderhouden een groeiend ecosysteem van MCP-servers. De nuttigste voor Dify:
| MCP-server | Functie | Belangrijkste tools | Installatie |
|---|---|---|---|
| filesystem | Lokale bestanden lezen en schrijven | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | GitHub repos, PR's, issues | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Slack berichten & kanalen | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Alleen-lezen SQL-databasetoegang | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Realtime webzoeken | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Browserautomatisering & scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Windows-bestandszoeken (Everything) | search, get_file_info | npx @modelcontextprotocol/server-everything |
MCP-server instellen: stap-voor-stap voorbeeld
Volledig voorbeeld: de Anthropic Filesystem-MCP-server opzetten zodat je Dify-agent bestanden op je server kan lezen en schrijven.
Stap 1: Node.js 18+ installeren (overslaan als al geinstalleerd)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Stap 2: Filesystem-MCP-server starten
npx @modelcontextprotocol/server-filesystem /home/user/documenten
# Server draait op http://localhost:3000/mcp
Stap 3: Als achtergrondservice draaien (optioneel)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documenten" --name mcp-filesystem pm2 save && pm2 startup
Stap 4: Server testen
curl http://localhost:3000/mcp
# Verwachte uitvoer: {"name":"filesystem","version":"...","tools":[...]} Stap 5: GitHub-MCP-server (met authenticatie)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_jouw_token_hier \ npx @modelcontextprotocol/server-github
# GitHub PAT aanmaken op: github.com/settings/tokens
Praktische gebruiksscenarios
Drie productierijpe Dify+MCP-setups die je vandaag nog kunt nabootsen:
Scenario 1: KI-documentassistent
Verbind de Filesystem-MCP-server met een Dify-agent. De KI-agent kan nu je documentmappen doorzoeken, contracten lezen, belangrijke gegevens extraheren, versies vergelijken en samenvattingen terugschrijven — alles via natuurlijke taal.
Scenario 2: GitHub PR-reviewer
Verbind de GitHub-MCP-server met Dify. Bouw een agent die pull requests automatisch reviewt: open PRs weergeven, diffs lezen, codestandaarden controleren, potentiële bugs identificeren en een reviewcommentaar plaatsen — alles binnen de Dify-interface.
Scenario 3: Database-analist
Verbind de PostgreSQL-MCP-server met Dify en alleen-lezen-inloggegevens. Bouw een analist in natuurlijke taal: gebruikers stellen zakelijke vragen in het Nederlands, de agent schrijft SQL-queries, voert ze uit op de database en geeft de inzichten terug in leesbare vorm.
Veelgestelde vragen
Wat is MCP (Model Context Protocol)?
MCP is een open standaard van Anthropic die definieert hoe KI-modellen verbinding maken met externe tools en gegevensbronnen. Beschouw het als 'USB-C voor KI' — in plaats van individuele integraties voor elke tool werkt één standaard overal. Dify ondersteunt MCP als client.
Wat kan ik via MCP met Dify verbinden?
Via MCP kun je Dify verbinden met: lokale bestandssystemen, GitHub (repos, PR's, issues), Slack (berichten, kanalen), PostgreSQL-databases, webbrowsers (Puppeteer), webzoekopdrachten (Brave, DuckDuckGo) en willekeurige diensten met een MCP-server.
Heb ik programmeerkennis nodig voor MCP met Dify?
Voor officiële MCP-servers (Filesystem, GitHub, enz.) volstaat één npx-commando om te starten, dan de URL in Dify invoeren. Geen codering nodig. Een eigen MCP-server bouwen vereist basiskennis van Node.js of Python.
Is MCP veilig voor productiegebruik?
MCP-beveiliging hangt af van je serverconfiguratie. Draai MCP-servers altijd op localhost of een privénetwerk — nooit rechtstreeks op het internet. Gebruik auth-tokens en beperk bestandstoegang tot specifieke mappen.
Dify + MCP in productie draaien?
MCP toont zijn volledige kracht wanneer Dify en de MCP-servers samen zelfgehost worden — op dezelfde privéserver, zonder dat gegevens de eigen infrastructuur verlaten. Hetzner biedt VPS vanaf €3,79/maand met de prestaties voor Dify en meerdere MCP-servers tegelijk. Of gebruik Elestio voor een volledig beheerde, één-klik-Dify-deployment.