Zur Dokumentation springen
MCP-Server

Dateien

Jeder Anhang, den das Postfach enthält.

Datei-Tools

ToolWas es tut
listFilesJeder Anhang, den das Postfach enthält, gesendet und empfangen, nach Name durchsuchbar, nach Art gefiltert und sortiert nach neueste, älteste, größte oder Name. Seitenweise zurückgegeben.
getFileEine Datei, mit jedem Download-Link, als der sie verschickt wurde, und wie oft jeder abgerufen wurde.
deleteFileLöscht eine Datei endgültig: Ihre Bytes verschwinden, und jeder Download-Link funktioniert nicht mehr. Ein Chat fragt immer zuerst.

Eine Datei gehört zu der Mail, mit der sie kam, deshalb braucht das Lesen threads:read und das Löschen threads:write. Wer auf bestimmte Adressen beschränkt ist, sieht nur die Dateien, die an diese kamen, und nur der Eigentümer des Postfachs kann eine löschen.

Die Tools lesen den Dateiindex, nicht die Bytes. Eine Datei herunterladen geht mit GET /files/{id}/content in der REST-API oder files.download im SDK.