تخطَّ إلى المستندات
خادم MCP

الملفات

كل مرفق يحتفظ به صندوق البريد.

أدوات الملفات

الأداةما تفعله
listFilesكل مرفق يحتفظ به صندوق البريد، مُرسلًا ومُستلمًا، يمكن البحث فيه بالاسم وتصفيته حسب النوع وترتيبه من الأحدث أو الأقدم أو الأكبر أو بالاسم. يُعاد صفحةً صفحة.
getFileملف واحد، مع كل رابط تنزيل خرج به وعدد مرات جلب كل رابط.
deleteFileيحذف ملفًا نهائيًا: تزول بايتاته ويتوقف كل رابط تنزيل عن العمل. وتسأل المحادثة دائمًا أولًا.

الملف جزء من البريد الذي جاء معه، لذا تحتاج القراءة إلى threads:read ويحتاج الحذف إلى threads:write. ومن كان مقصورًا على بعض العناوين لا يرى إلا الملفات التي وصلت إليها، ولا يحذف الملف إلا مالك صندوق البريد.

تقرأ الأدوات فهرس الملفات لا البايتات. وتنزيل ملف هو GET /files/{id}/content في واجهة REST أو files.download في حزمة SDK.