Gepubliceerd:
Bestanden uploaden via MCP: conceptextensie houdt pdf's en exports buiten het model
Kort: Het MCP-project presenteerde op 10 november 2026 een conceptextensie, io.modelcontextprotocol/files, waarmee AI-apps bestanden naar MCP-tools kunnen sturen en terugkrijgen zonder dat de bytes door het model gaan. De server keurt eerst de metadata goed, daarna volgt een aparte HTTPS-upload. De extensie is experimenteel; stabiel is gepland vóór eind 2026.
Bestanden zijn een van de praktische gaten in MCP. Wie een contract, een factuurbatch of een export via een MCP-tool wil verwerken, heeft nu vooral noodoplossingen: het bestand als base64-tekst in de toolaanroep stoppen, of een eigen uploadlink buiten het protocol om bouwen. In een blogpost van 10 november beschrijven Den Delimarsky (lead maintainer van MCP) en Wil St. Charles (Google) een standaardaanpak. De werkgroep File Uploads, opgericht in april met leden van Anthropic en OpenAI, nam op 21 oktober ook downloads op in haar opdracht.
Hoe werkt de bestandsextensie?
De extensie werkt met protocolversie 2026-07-28 en later, de stateless versie van de specificatie. Het verloop in vijf stappen:
- Aankondigen. De server meldt in zijn
server/discover-antwoord dat hij de extensie ondersteunt, metmaxInlineBytesals hij kleine bestanden inline accepteert enuploadals hij losse uploads accepteert. De client meldt per verzoek wat hij kan. - Markeren. In het invoerschema van een tool krijgt een bestandsargument de markering
x-mcp-file, met toegestane bestandstypen en een maximale grootte. De client vult dat argument, niet het model. Clients zonder de extensie negeren de markering. - Eerst metadata. Na goedkeuring door de gebruiker (of het agentbeleid als er geen gebruiker is) roept de client de tool aan met alleen naam, type en grootte. De server controleert rechten en opslagquotum voordat er bytes bewegen.
- Uploaden en opnieuw aanroepen. Is het bestand te groot voor inline, dan antwoordt de server met
upload_required: een uploadadres per bestand, een vervaltijd en een tegen manipulatie beschermderequestState. De client uploadt via HTTPS en roept de tool opnieuw aan met dezelfde argumenten en dierequestState. Pas dan draait de tool. - Downloaden. Een tool kan bestanden teruggeven via downloaddoelen in het resultaat. De client controleert de grootte en, als die is meegegeven, een SHA-256-hash.
Hoe ver is de extensie?
Nog niet ver genoeg voor productie. De repository experimental-ext-file-uploads zegt het zelf: de extensie is geen onderdeel van de MCP-specificatie, is nog niet als SEP voorgesteld en brekende wijzigingen zijn te verwachten. Er is nog geen referentie-implementatie. De blog noemt de definitie "rough" en verwacht een stabiele versie vóór eind 2026.
Buiten het project wordt er al mee gewerkt. Het Python-SDK van holon-sh voegde op 10 november een prototype toe voor client en server, met de kanttekening dat de interfaces de concepten volgen en kunnen veranderen. In de GitHub-organisatie nmi-agro staat sinds dezelfde dag een voorstel om labrapporten (pdf) en RVO-perceelbestanden via een MCP-server te laten importeren. Dat voorstel kiest bewust eerst voor een tijdelijke uploadlink en wil de extensie later toevoegen, omdat die nog niet is goedgekeurd.
Los hiervan kondigden de maintainers op 11 november een vaste halfjaarlijkse releasecyclus aan. De volgende specificatieversie staat gepland voor 30 maart 2027.
Welke risico's blijven open?
De blog en een onafhankelijke analyse op dev.to benoemen dezelfde punten:
- Waar gaat het bestand heen? Bij
credentials: "omit"regelt het uploadadres zijn eigen autorisatie, bijvoorbeeld met een vooraf ondertekende URL. Een kwaadwillende server kan zo een upload naar een eigen adres sturen; de goedkeuring van de gebruiker dekt die bestemming niet. Het concept raadt een allowlist van toegestane domeinen aan, maar of die verplicht wordt, is nog open. - Integriteit is geen veiligheid. Een kloppende hash bewijst dat de bytes compleet zijn, niet dat het bestand onschadelijk is. Gedownloade bestanden blijven onvertrouwd.
- Vaste regels voor clients. Clients moeten redirects weigeren en uploaddoelen afwijzen die zelf een
Authorization-header meesturen.
Ons advies
(1) Bouwt u nu een MCP-server die documenten verwerkt: kies een eenvoudige tussenoplossing (een tijdelijke, eenmalige uploadlink of een verwijzing naar een bestand dat al in uw eigen opslag staat) en houd de interface zo dat de extensie later als tweede route kan worden toegevoegd. Base64 in de toolaanroep is alleen geschikt voor kleine bestanden. (2) Neem voor elke MCP-integratie met bestanden in de verwerkingsafspraken op wáár die bestanden terechtkomen, hoe lang ze blijven staan en wie de opslag beheert; de upload loopt buiten het model om, maar wel naar opslag van de serverleverancier. Zie MCP & wetgeving. (3) Stel bij adoptie een allowlist van uploaddomeinen in, ook als de specificatie die uiteindelijk niet verplicht. Meer over risico's: veiligheid & watchouts.
De grotere lijn: MCP verschuift van tekst-in-tekst-uit naar echte bedrijfsprocessen: offertes, schadedossiers, exports. Dat het bestand níét door het model gaat, is daarbij winst voor kosten en voor gegevensbescherming. Maar het verplaatst de vraag naar de opslaglaag: wie zelf een MCP-server bouwt, moet straks naast tools en autorisatie ook uploadopslag, bewaartermijnen en het verwijderen van bestanden ontwerpen.
Bronnen
- MCP Blog — Exploring File Uploads and Downloads in MCP (10 november 2026)
- GitHub — modelcontextprotocol/experimental-ext-file-uploads (README en conceptspecificatie)
- MCP — charter werkgroep File Uploads (initieel 23 april 2026, downloads toegevoegd 21 oktober 2026)
- MCP Blog — A More Predictable Release Cycle for MCP (11 november 2026)
- dev.to — MCP's file transfer draft keeps bytes out of your model's context (12 november 2026)
- GitHub — holon-sh/sdk-py PR #38, prototype van de bestandsextensie (10 november 2026)
- GitHub — nmi-agro/fdm issue #944, import van labrapporten en RVO-shapefiles via MCP (10 november 2026)
Veelgestelde vragen
Kan ik de MCP-bestandsextensie al in productie gebruiken?
Nee, nog niet verstandig. De extensie io.modelcontextprotocol/files is volgens de eigen repository experimenteel, geen onderdeel van de MCP-specificatie en nog niet als SEP voorgesteld; brekende wijzigingen worden verwacht. Er is nog geen referentie-implementatie. De maintainers mikken op een stabiele versie vóór eind 2026. Prototypen kan wel.
Gaat een geüpload bestand via het AI-model?
Nee, dat is juist het doel. De client (de AI-app) vult het bestandsargument, niet het model. Kleine bestanden gaan inline mee in de toolaanroep, grotere worden apart via HTTPS naar een uploadadres van de server gestuurd. De bytes komen daardoor niet in de modelcontext en niet in de JSON-RPC-berichten.
Welke vereisten gelden er voor een server die de extensie wil ondersteunen?
De extensie werkt met protocolversie 2026-07-28 en later. De server kondigt haar aan in zijn server/discover-antwoord, markeert bestandsargumenten met x-mcp-file in het invoerschema en geeft bij grote bestanden een upload_required-resultaat terug met uploaddoelen en een beveiligde requestState.
Laatst bijgewerkt: