AI News
Alle Meldungen
Offiziell

Model Context Protocol entwirft Erweiterung für Datei-Upload und -Download für KI-Agenten

Das MCP-Projekt hat den Entwurf einer Erweiterung veröffentlicht, die Dateiübertragungen aus dem Kontext des Modells herausnimmt. Sie ist allerdings experimentell und noch nicht stabil.

Open Source · · 4 Min. Lesezeit

Das Projekt hinter dem Model Context Protocol hat den Entwurf einer Erweiterung veröffentlicht, die Dateiübertragungen aus dem Kontext des Modells herausnimmt. Damit kann ein MCP-Tool eine Datei zu einem Speicherdienst hochladen oder von dort herunterladen, ohne dass die Bytes oder die URLs das Modell passieren. Die Erweiterung mit der Kennung io.modelcontextprotocol/files funktioniert ab der Protokollrevision 2026-07-28. Der Beitrag bezeichnet sie als experimentell.

Der Anlass ist praktischer Natur. Ein PDF aus einer Konversation im Cloud-Speicher ablegen oder eine CSV-Datei in eine Code-Sandbox holen: Das sind häufige Wünsche von Entwicklern, die MCP einsetzen. Laut dem Beitrag braucht es dafür heute jeweils eigene Tool-Konventionen und Übertragungsmechanismen. Der Entwurf beruht auf einer Beobachtung: Der Agent muss bestimmte Dinge über eine Datei wissen, etwa Name, Typ und Größe, aber das Modell muss nicht jedes Byte lesen. Die Datei soll direkt an ihr Ziel gelangen.

Der Mechanismus beginnt beim Input-Schema des Tools. Ein Server kennzeichnet ein Dateiargument mit x-mcp-file, nach demselben Muster, das das Projekt bereits für x-mcp-header verwendet. Damit weiß der Client, dass er das Argument selbst befüllen soll, sodass das Modell die Datei nie erzeugen muss. Kleine Dateien lassen sich inline als Base64 in einem data-Feld senden, sofern die gesamten Inline-Daten einer Anfrage den Wert maxInlineBytes nicht überschreiten, den der Server angibt. Der Beispielserver nennt 1048576 Bytes, also 1 MiB. Jede Datei ist zudem durch maxSize begrenzt, das beim Beispiel-Tool für PDFs auf 157286400 Bytes, also 150 MiB, gesetzt ist. Clients, die die Erweiterung nicht unterstützen, ignorieren das Schlüsselwort und behandeln das Argument als gewöhnliches Objekt. Erklärt ein Client keine Unterstützung, soll der Server das Tool entweder weglassen oder eine Alternative anbieten, etwa die Übergabe einer URL zu einer bereits hochgeladenen Datei.

Bei größeren Dateien enthält der erste Tool-Aufruf nur Metadaten, nachdem der Host die Zustimmung des Nutzers eingeholt oder, wenn kein Nutzer anwesend ist, die Richtlinien des Betreibers angewendet hat. Im Beispiel wird ein PDF mit 41204133 Bytes gesendet, das der Beitrag auf 40 MB rundet. Der Server kann Berechtigungen und Speicherkontingent prüfen, bevor auch nur ein Byte übertragen wird. Ein schreibgeschützter Zielordner fällt also vor dem Upload auf, nicht erst nach einer Übertragung von 40 MB. Sind die Prüfungen erfolgreich, antwortet der Server mit einem neuen Ergebnistyp, upload_required. Dieser enthält die Upload-URL, Header, eine credentials-Einstellung, eine unverbindliche Ablaufzeit und einen requestState-Wert. Der requestState ist für den Client opak. Der Server verpackt darin, was er zum Abschluss der Aufgabe braucht, und schützt den Zustand vor Manipulation; der Client gibt ihn unverändert zurück. Da der Zustand seinen eigenen Kontext mitbringt, statt auf eine Session angewiesen zu sein, kann jede Serverinstanz, die ihn verifizieren und die hochgeladene Datei erreichen kann, die Aufgabe abschließen. Bei Tools, die nicht zweimal laufen dürfen, markiert der Server den requestState in einem von allen Instanzen geteilten Datensatz als verbraucht, und ein zweiter Versuch mit demselben Wert wird abgelehnt.

Anschließend sendet der Client die Bytes über HTTPS, standardmäßig per PUT oder per POST bei Speicherdiensten, die ein Multipart-Formular verlangen. Liefert der Upload einen 2xx-Status, wiederholt der Client den Tool-Aufruf mit denselben Argumenten und dem zurückgegebenen requestState. Der Server prüft den Zustand, lässt sich vom Speicherdienst bestätigen, dass die Datei angekommen ist, kontrolliert Größe und Typ und führt erst dann das Tool aus. Schlägt der Upload fehl, sendet der Client keinen erneuten Aufruf, und das Tool läuft nicht. Laut dem Beitrag ist das Modell an keinem dieser Schritte beteiligt. Weder die Bytes noch die Upload-URL gelangen in seinen Kontext.

Downloads kehren den Ablauf um, mit einem Unterschied: Das Tool liefert die Download-Details im _meta-Feld seines abgeschlossenen Ergebnisses, sodass der Client keinen erneuten Aufruf braucht. Der Client holt die Datei dann per HTTPS GET. Der Beitrag begründet die Aufteilung so: Ein Upload braucht ein Signal, das den Client zur Übertragung und zum erneuten Aufruf auffordert, bevor das Tool laufen kann, während ein Download Teil eines fertigen Ergebnisses ist. Das Format für Downloads ist noch offen. Laut dem Beitrag nutzt das Team vorerst _meta und wünscht sich Feedback dazu, wie sich das in der Praxis bewährt. Nach dem Download vergleicht der Client die Byteanzahl mit der angegebenen Größe. Hat der Server einen SHA-256-Digest mitgeliefert, vergleicht der Client den Hash; bei einer Abweichung muss die Datei verworfen werden. Ein passender Digest belegt laut dem Beitrag nur, dass die Bytes dem gelieferten Hash entsprechen, nicht aber, dass die Datei sicher ist. Clients müssen heruntergeladene Dateien daher weiterhin als nicht vertrauenswürdig behandeln.

Die credentials-Einstellung zielt auf ein bestimmtes Risiko: Eine Datei kann an einen Speicherdienst statt an den MCP-Server gehen, und würde der Client sein MCP-Token an einen fremden Host schicken, wäre es preisgegeben. Jedes Ziel gibt deshalb entweder omit oder include an. Bei omit hängt der Client weder sein MCP-Token noch Cookies oder andere Zugangsdaten an, und das Ziel verlässt sich auf seine eigene Autorisierung, etwa eine Signatur in einer vorsignierten URL. Bei include hängt der Client seine MCP-Zugangsdaten nur an einen Pfad unterhalb seiner MCP-Adresse oder an eine URL auf dem eigenen Origin des Servers an, was sich für Gateways eignet. Außerdem muss der Client Weiterleitungen verweigern und Ziele ablehnen, die einen eigenen Authorization-Header mitbringen. Der Beitrag räumt ein, dass diese Regeln zwar steuern, wohin die Zugangsdaten gehen, nicht aber, wohin die Datei geht. Bei omit könnte ein bösartiger Server einen Upload an einen öffentlichen Endpunkt unter seiner Kontrolle umleiten, und die Zustimmung des Nutzers wurde erteilt, bevor der Host das Ziel kannte.

Die Erweiterung ist optional: Clients und Server, die sie nicht nutzen wollen, müssen nichts tun. Laut dem Beitrag gibt es noch keine Referenzimplementierung, und die inneren Abläufe dürften sich ändern, sobald das Experiment an Dateidienste von Drittanbietern angebunden wird, etwa Cloud-Speicher sowie Datenbank-Import und -Export. Das Projekt rechnet damit, die Erweiterung vor Jahresende fertigzustellen und als stabil einzustufen. Die README des Repositorys ergänzt, dass sie nicht Teil der MCP-Spezifikation ist, nicht als SEP vorgeschlagen wurde und dass mit Breaking Changes zu rechnen ist, solange die Arbeitsgruppe daran weiterarbeitet.

Was sich ändert

Art: Neue Funktion · Betrifft: io.modelcontextprotocol/files

Originalquelle

Wo wir es gesehen haben

1 Quelle

Model Context Protocol

KI hat diese Zusammenfassung aus den genannten Quellen geschrieben und ins Deutsche übersetzt. Niemand hat sie vor der Veröffentlichung einzeln geprüft. Bitte prüfen Sie die Originalquelle, bevor Sie sich darauf verlassen. So funktioniert es