ذكاء اصطناعيmcpمطورالأمان

دع الذكاء الاصطناعي يرسل الأسرار دون قراءتها.

كيف يقوم PrivateNote MCP بتسليم الملفات عبر البريد الإلكتروني، وSlack، وDiscord، وWhatsApp — دون أن يقرأها النموذج

تم التحديث 11 سبتمبر 2026قراءة 7 دقائقPrivateNote.ai

يمكن لمساعدك إرسال عقد، أو كلمة مرور، أو ملف CSV اليوم. لا ينبغي له قراءة تلك الملفات للقيام بذلك. قم بتمرير المسارات المحلية إلى PrivateNote MCP وضع رابطاً ذاتي التدمير فقط في القناة التي تستخدمها بالفعل.

أهم النقاط

  • Pass file paths, not file bytes—the local MCP encrypts so the model never needs the payload.
  • You approve a preview that binds exact bytes, options, and destination. Creating a note is not permission to send it.
  • Email, Slack, Discord, and WhatsApp should carry only the PrivateNote URL after sendAuthorized — never the file. Leave one-shot off if the agent can also send messages.
  • The decryptable URL is a bearer capability the agent can see after confirm. Do not log it. After delivery, poll open status or revoke an unopened note.

الجزء المفيد من المساعد الذكي ليس قدرته على قراءة عقد، أو ملف كلمات مرور، أو تصدير بيانات عملاء. الجزء المفيد هو قدرته على إيصال تلك الحمولة إلى الشخص المناسب، عبر القناة التي يتواجد فيها بالفعل، دون تحويل المساعد إلى نسخة من السر.

هذه هي المهمة اليومية: إرسال PDF إلى عميل عبر البريد الإلكتروني، أو إرسال كلمة مرور بيئة تجريبية لزميل في Slack، أو تسليم رمز bot لمشرف في Discord، أو وضع بيانات تسجيل دخول لمرة واحدة في سلسلة رسائل WhatsApp. يقوم الأشخاص بالفعل بذلك عن طريق اللصق. لكن الوكلاء (Agents) يجعلون عملية اللصق أسرع — ويجعلون التسريب أكبر، لأن السر أصبح الآن موجوداً أيضاً في سياق النموذج، وفي سجل الدردشة، وفي كل سجل يحتفظ به المضيف.

خادم MCP الخاص بـ PrivateNote مصمم لتقسيم عكسي. الوكيل يقوم بالتنسيق. عملية محلية تتعامل مع السر. أنت توافق على الملف والوجهة بدقة. البريد الإلكتروني، وSlack، وDiscord، وWhatsApp تحمل رابطاً فقط. يتم إخبار النموذج بتمرير مسارات الملفات، وليس بايتات الملف. تتم عملية التشفير على جهازك بعد تأكيدك. ما يعود هو URL يحتوي جزء منه على المفتاح — وهو نفس نموذج رابط السر لمرة واحدة المستخدم في تطبيق الويب. إنشاء ملاحظة لا يعني الإذن بإرسالها.


المهمة هي الإرسال، وليس المعرفة

لا تزال معظم نصائح "الذكاء الاصطناعي + الأسرار" تفترض أنه يجب على النموذج رؤية بيانات الاعتماد لكي يتمكن من المساعدة. هذا صحيح إذا كنت تريد من النموذج أن يشرح الملف، أو يعيد كتابة العقد، أو يصلح أخطاء المفتاح. لكنه ليس صحيحاً إذا كنت تريد من النموذج أن يسلمها.

التسليم هو مشكلة لوجستية: أي ملف، أي شخص، أي قناة، مدة صلاحية الوصول، وما إذا كان يجب أن يحترق (يُحذف) بعد أول عرض. لا تتطلب أي من هذه القرارات النص الصريح. بل تتطلب أداة يمكنها قراءة مسار محلي، وتشفير البيانات، وإرجاع معرف (handle) يُسمح لبقية النظام برؤيته.

هذا هو الغرض من privatenote-mcp. المضيفون الذين يحترمون تعليمات MCP يتم إخبارهم بالترتيب التالي: إذا سمى المستخدم ملفاً محلياً، قم بتمرير المسار المطلق؛ لا تفتح الملف، أو تعرض محتواه (cat)، أو تلخصه؛ استدعِ create_private_note (للمعاينة)؛ انتظر موافقتك؛ ثم استدعِ confirm_private_note. فقط بعد ذلك يمكن لأداة أخرى إرسال URL — وإلى الوجهة التي وافقت عليها فقط.

القاعدة

إذا كان بإمكان المساعد إكمال المهمة باستخدام مسار، فلا يجب عليه إكمالها باستخدام المحتويات. اللصق في المطالبة (prompt) هو الملاذ الأخير — بعد أن يكون السر قد أصبح بالفعل في الدردشة.

لماذا تحتفظ القنوات التي تستخدمها بالفعل بالنسخة الخاطئة

البريد الإلكتروني، وSlack، وDiscord، وWhatsApp بارعة في المحادثة. لكنها مخازن سيئة. التشفير أثناء النقل، أو حتى التشفير من طرف إلى طرف، لا يحدد المدة التي تظل فيها نسخة قابلة للبحث على الأجهزة، أو في تصديرات مساحة العمل، أو في النسخ الاحتياطية السحابية، أو في معاينات الإشعارات. هذا هو نفس التمييز بين لماذا يعد البريد الإلكتروني أسوأ مكان للأسرار ولماذا لا ينبغي أبداً لصق الأسرار في الدردشة.

  • البريد الإلكتروني يخزن المرفقات في كلا صندوقي البريد، وعلى خوادم البريد، وفي الحجز القانوني، وفي "البحث في كل البريد". إعادة التوجيه تضاعف النسخ التي لا يمكنك إلغاؤها لاحقاً.
  • Slack يتم فهرسته بواسطة مساحة العمل. يمكن للمسؤولين، وتصديرات الامتثال، وميزات الذكاء الاصطناعي التي تلخص القنوات، أن يعيدوا اكتشاف كلمة مرور بعد أشهر.
  • Discord يبدو عابراً في خادم مزدحم. لكنه ليس كذلك. التثبيت (Pins)، والبحث، والرسائل المباشرة (DMs) تحتفظ برموز الـ bot وأسرار إدارة الدعوات بجانب الصور الساخرة (memes).
  • WhatsApp غالباً ما يكون القناة الوحيدة التي سيفتحها المتعاقد أو العميل فعلياً. كما أنه صندوق وارد عائلي: لقطات الشاشة تنتقل، والأجهزة المرتبطة تتزامن، والنسخ الاحتياطية تعيش لفترة أطول من المهمة.

الهدف ليس التخلي عن تلك الأدوات. الهدف هو التوقف عن وضع الحمولة (payload) فيها. يجب أن تظل هي المغلف. الملاحظة هي الرسالة. لا يزال المستلمون لا يحتاجون إلى حساب PrivateNote: يفتحون الرابط في المتصفح، بنفس الطريقة التي يفتحون بها أي URL آخر ترسله لهم بالفعل.


التقسيم الثلاثي

الدورما قد يراهما يجب ألا يراه
وكيل الذكاء الاصطناعي (Cursor, Claude, Codex)من، أي مسار، أي قناة، تاريخ الانتهاء، الحرق بعد القراءة. بعد تأكيدك: URL القابل لفك التشفيربايتات الملف، كلمات المرور، نص الملاحظة. يجب ألا يرسل URL حتى توافق على تلك الوجهة
PrivateNote MCP (عملية Node محلية)الملفات الموجودة على القرص، للتشفير فقطلا شيء يعيده كنص صريح
البريد الإلكتروني / Slack / Discord / WhatsAppPrivateNote URL (وموضوع قابل للقراءة من قبل البشر)المرفق، بيانات الاعتماد، عبارة المرور

لا يقوم MCP بإرسال البريد الإلكتروني أو رسالة Slack نيابة عنك. إنشاء ملاحظة لا يعد تفويضاً لإرسالها. بعد موافقتك على معاينة تحدد قناة ومستلمًا بدقة، قد تتضمن النتيجة sendAuthorized: true — حينها قد تقوم أداة البريد أو الدردشة بإرسال URL فقط إلى تلك الوجهة. إذا لم تتم الموافقة على وجهة، فإن sendAuthorized تكون خاطئة ويجب على الوكيل تزويدك بـ URL للصقه، وليس تشغيل أداة أخرى.

يعتبر URL بمثابة قدرة حامل: أي شخص يمتلكه يمكنه فتح الملاحظة. يقوم مضيف MCP الحالي بإرجاع secureUrl في نتيجة الأداة، لذا يمكن للوكيل ملاحظة الرابط على الرغم من عدم قدرته على ملاحظة بايتات الملف. لا تقم بتسجيله، أو تثبيته، أو نسخه إلى أدوات غير ذات صلة. تعامل معه كسرّ.

بقية الحمولة المسترجعة صغيرة: noteId، وexpiresAt، وburnAfterReading، وعند الاقتضاء passwordProtected وattachedFileNames. أسماء الملفات هي بيانات وصفية وليست محتويات — ومع ذلك تجنب وضع سر في اسم الملف.


ما يفعله MCP فعليًا على جهازك

عندما يستدعي الوكيل create_private_note، تقوم عملية Node.js محلية — وليس النموذج — بتوحيد المسار، والتحقق منه مقابل القائمة البيضاء لمساحة العمل، وتجزئة الملف، وعرض معاينة لك. هي لا تعيد URL قابلاً لفك التشفير بعد. بعد موافقتك، يقوم confirm_private_note بإعادة فتح نفس الملف، والتحقق من الجهاز، وinode، والحجم، وSHA-256، وتشفير تلك البايتات. إذا تغير الملف، تفشل عملية التأكيد؛ ويجب على الوكيل البدء من جديد. يتم إرسال النص المشفر AES-256-GCM عبر POST إلى PrivateNote. يتم وضع مفتاح فك التشفير في جزء URL (#…). المتصفحات لا ترسل الأجزاء إلى الخوادم. يقوم API بتخزين كتلة مشفرة. بدون الجزء، تكون تلك الكتلة مجرد ضجيج.

يفضل استخدام معاملات المسار حتى لا يضطر المضيف أبدًا إلى وضع السر في وسائط استدعاء الأداة التي أنشأها النموذج:

  • contentFilePath — ملف UTF-8 يصبح متن الملاحظة (كلمة مرور، رمز استرداد، تعليمات قصيرة).
  • filePath / filePaths — مرفقات محلية (PDF، CSV، صور). تتطلب sign_in. الحد الأقصى المشترك هو 20 ملفات.
  • passwordFilePath — السطر الأول من ملف محلي يصبح عبارة مرور الكشف (Argon2id wrap). أرسل عبارة المرور هذه خارج النطاق، ولا ترسلها أبدًا في نفس الرسالة التي تحتوي على الرابط.
  • content وpassword — الملاذ الأخير، فقط إذا كان المستخدم قد لصق السر بالفعل في الدردشة ولم يكن هناك ملف موجود.

تتطابق السياسة الافتراضية مع عملية تسليم، وليس أرشيفًا: burnAfterReading تكون صحيحة، وexpiresIn تضبط افتراضيًا على 24 ساعة. المدة الأقصر هي الأفضل عندما يكون المستلم في انتظار الطرف الآخر من Slack. تتطلب العرض المتعدد (burnAfterReading: false) حسابًا مميزًا (Premium). يتطلب إرفاق الملف، والتحقق من المستلم، وإشعارات الفتح، والقائمة/الإلغاء جلسة تسجيل دخول؛ كما تتطلب البوابات والتنبيهات خطة مدفوعة.

المسارات مقيدة. افتراضيًا، يمكن فقط قراءة الملفات الموجودة تحت مساحة العمل (دليل عمل عملية MCP). قم بتعيين PRIVATENOTE_MCP_ALLOWED_ROOTS إذا كنت مضطرًا لإضافة مجلدات. مفاتيح SSH، وأدلة بيانات اعتماد السحابة، وملف جلسة MCP هي محظورة دائمًا، حتى لو سمحت بـ $HOME أو /.


أنت توافق على عملية التسليم الدقيقة — وليس على مسار ملف

الوكيل الذي يمكنه إنشاء رابط قابل لفك التشفير و إرسال بريد إلكتروني أو Slack هو وكيل مرتبك: قد يقوم بتشفير الملف الخطأ، أو إرسال الرابط الصحيح إلى الشخص الخطأ، في دورة واحدة. الافتراضي في PrivateNote هو أنك أنت من يفوض ثلاثة أشياء معًا: بايتات الملف الدقيقة، وخيارات الملاحظة الدقيقة (تاريخ الانتهاء، الحرق بعد القراءة)، والوجهة الدقيقة.

يجب أن تعرض المعاينة الوجهة عند طلب الإرسال، على سبيل المثال “الإرسال عبر: البريد الإلكتروني / المستلم: alice@example.com”. الموافقة على ذلك يجب ألا تفوض أبدًا عنوانًا أو قناة Slack مختلفة. لا تقبل confirm_private_note سوى confirmationId. لا يمكن للوكيل تجاوز المسار، أو المستلم، أو القناة، أو تاريخ الانتهاء، أو سياسة التدمير عند التأكيد.

إنشاء ملاحظة بدون وجهة يعيد sendAuthorized: false. هذا أمر مقصود. الرابط في الدردشة لا يزال حساسًا — لكنه ليس إذنًا لإرساله عبر البريد.

لا تقم بتفعيل خيار الخطوة الواحدة (one-shot) إذا كان بإمكان الوكيل الإرسال

PRIVATENOTE_MCP_ALLOW_ONE_SHOT يتخطى المعاينة البشرية. لا يمكن للوكيل تشغيل هذا كمعامل للأداة، وتغيير البيئة لاحقًا ليس له تأثير حتى تعيد تشغيل خادم MCP. اتركه مغلقًا. تشغيله بينما يمكن لنفس المضيف إرسال بريد إلكتروني، أو Slack، أو Discord، أو ملفات، يسمح للنموذج بإنشاء رابط قابل لفك التشفير وإرساله في خطوة واحدة — بما في ذلك الملف الخطأ أو المستلم الخطأ. لا تزال قائمة السماح بالمسارات سارية؛ فهي ليست بديلًا لموافقتك.

قم بتوصيله مرة واحدة

يتطلب Node.js 18+. بعد الحفظ، أعد تشغيل عميل MCP ليتم تحميل مخططات وأوامر الأدوات الحالية. تتوفر ملاحظات التثبيت الكاملة في صفحة تكامل MCP.

~/.cursor/mcp.json · يستخدم Claude Desktop نفس الكتلة
{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}

Codex CLI: codex mcp add privatenote -- npx -y privatenote-mcp. هذا يكتب ~/.codex/config.toml. الملاحظات الخاصة بـ Codex موجودة في استخدام PrivateNote مع OpenAI Codex.

الاستضافة الذاتية: قم بتعيين PRIVATENOTE_API_BASE_URL و PRIVATENOTE_WEB_ORIGIN في كتلة MCP env لضمان عدم خروج النص المشفر من بنيتك التحتية أبدًا. يمكنك اختيارياً تعيين PRIVATENOTE_MCP_ALLOWED_ROOTS. لا تقم بإضافة PRIVATENOTE_MCP_ALLOW_ONE_SHOT إلا إذا كان لديك مضيف أتمتة محدد النطاق للغاية ولا يحتوي على أدوات إرسال.


الاستخدام اليومي: البريد الإلكتروني

لا يزال البريد الإلكتروني هو الوسيلة التي تستخدمها الشركات لإرسال العقود، واتفاقيات عدم الإفصاح (NDAs)، والفواتير التي تحتوي على تفاصيل بنكية، وتصديرات بيانات العملاء. نمط الفشل هو إرفاق الملف؛ حيث يحتفظ صندوق البريد بعد ذلك بنسخة قابلة لفك التشفير لسنوات، بما في ذلك لدى المستلم، وسجلات BCC، وعمليات الكشف الإلكتروني (e-discovery).

نمط MCP: يعرف الوكيل بالفعل عنوان Alice وملفي PDF المحليين. يجب ألا يفتح ملفات PDF هذه. يقوم بتسجيل الدخول إذا لزم الأمر، ويستدعي create_private_note مع filePaths، sendChannel، و sendRecipient بحيث يظهر اسم Alice في المعاينة، ثم ينتظر موافقتك، ثم confirm_private_note. عندها فقط يمكن لأداة البريد وضع فقط secureUrl في نص البريد الإلكتروني. إذا كنت تستخدم التحقق من المستلم، يجب على القارئ إثبات ملكيته للعنوان قبل فتح الملاحظة — هذه البوابة لا ترسل البريد؛ بل تقوم أداة البريد الخاصة بك بذلك.

ما تقوله
Send these two files to Alice by email.
Protect them with the password in /absolute/path/client-password.txt.
Don't expose the files or password to the model:
/absolute/path/contract.pdf
/absolute/path/nda.pdf
  • يستدعي الوكيل sign_in إذا لم تكن هناك جلسة إضافة (plugin session)، ثم create_private_note مع filePaths، passwordFilePath، sendChannel: "email"، و sendRecipient. أنت توافق على المعاينة. ثم confirm_private_note.
  • يمكن أن يكون موضوع البريد الإلكتروني “حزمة العقود” — لا ينبغي أن يقتبس بنوداً من PDF.
  • أرسل عبارة المرور في رسالة ثانية، أو مكالمة، أو عبر مشاركة مدير كلمات المرور — لا ترسلها أبداً في نفس البريد الذي يحتوي على الرابط. راجع كيفية مشاركة كلمة مرور بشكل آمن.
  • لمستلم محدد في خطة مدفوعة: requireRecipientVerification: true و recipientEmail: "alice@example.com".

هذا هو نفس نموذج التسليم المستخدم في إرسال المستندات الحساسة بشكل آمن، باستثناء أنه يُسمح للمساعد بتشغيلها دون أن يصبح قارئاً للحزمة.


الاستخدام اليومي: Slack

Slack هو المكان الذي تحدث فيه المناوبات (on-call). يتم إلقاء كلمات مرور قواعد بيانات البيئة التجريبية (staging)، ورموز النشر (deploy tokens)، و

اطلب تسليماً قائماً على المسار (path-based) ومدة صلاحية قصيرة. خمس عشرة دقيقة كافية إذا كان زميلك متصلاً بالإنترنت. احرق المعلومات بعد القراءة حتى لا يتحول أي بحث لاحق إلى رابط نشط بدلاً من كونه رابطاً معطلاً. تعامل مع URL كأنه سر: لا تنشره في قناة عامة؛ استخدم رسالة مباشرة أو قناة خاصة مخصصة.

ما تقوله
Send Mark the database password from /absolute/path/secrets/db-password.txt in Slack.
Make it read-once and expire in 15 minutes.
Don't read the file into the chat.
  • create_private_note مع contentFilePath، expiresIn: "15m"، burnAfterReading: true، ووجهة Slack المرتبطة عند المعاينة. وافق، ثم confirm_private_note.
  • إذا تم توصيل Slack كأداة MCP أخرى، فقد ينشر الوكيل secureUrl فقط إلى الوجهة المعتمدة بعد أن تصبح sendAuthorized صحيحة. خلاف ذلك، سيعطيك URL لتقوم بلصقها.
  • بعد أن يفتح Mark الملف، قم بتدوير كلمة المرور إذا كانت سراً مشتركاً للبيئة التجريبية — الملاحظة قللت النسخ المتبقية؛ لكنها لم تجعل الاعتماد المشترك فريداً.

الاستخدام اليومي: Discord

Discord هو قناة العمليات الافتراضية للعديد من مجتمعات المنتجات والفرق المرتبطة بالألعاب. يتم لصق رموز البوت (Bot tokens)، ومفاتيح Cloudflare، و"إليك جدول بيانات المستخدمين المبلغ عنهم" في الرسائل الخاصة للمشرفين لأن Discord هو المكان الذي يتواجد فيه المشرفون.

رسالة Discord لا تزال رسالة مخزنة. سيحتفظ بها أعضاء الخادم الذين لديهم الدور المناسب، والنسخ الاحتياطية للأجهزة، وبحث Discord الخاص. نمط MCP مطابق لـ Slack: قم بتشفير الملف أو الرمز محلياً، وضع الرابط في الرسالة الخاصة، وحدد مدة انتهاء قصيرة. إذا تم لصق الرمز مسبقاً في نفس الخادم، فقم بتدويره — تغليف سر مسرب لا يمنع تسربه.

ما تقوله
DM the community lead the bot token in /absolute/path/secrets/discord-bot.txt
and the moderation export at /absolute/path/reports/export.csv.
Read-once, 1 hour, don't open those files.
  • المرفقات تتطلب sign_in. يمكن للملاحظة التي تحتوي على رمز فقط استخدام contentFilePath بدون جلسة.
  • قم بربط وجهة Discord عند المعاينة، ووافق عليها، ثم confirm_private_note. عندها فقط يمكن لأداة Discord إرسال URL.
  • فضل الرسائل الخاصة للمستخدم على اللصق في قناة المشرفين. "القناة الخاصة" لا تزال عبارة عن سجل نصي.
  • إذا تضمن التصدير بيانات شخصية، فأضف ملف عبارة مرور وأخبر المسؤول بعبارة المرور عبر مكالمة صوتية.

الاستخدام اليومي: WhatsApp

WhatsApp هي القناة التي تستخدمها عندما لا يرغب الطرف الآخر في الانضمام إلى Slack ولن يتحقق من البريد الإلكتروني حتى يوم الاثنين. مقاول، مساعد مكتب عائلي، أو عميل عبر الهاتف. التشفير من طرف إلى طرف حقيقي. الاستمرارية حقيقية أيضًا: الدردشة هي سجل، غالبًا ما يكون متاحًا على عدة أجهزة، وغالبًا ما يتم نسخها احتياطيًا.

لا تحتاج منهم تثبيت PrivateNote. بل تحتاج منهم النقر على رابط. مهمة المساعد هي إعداد هذا الرابط من ملف محلي تملكه بالفعل — فاتورة PDF، كلمة مرور Wi-Fi، أو رمز بوابة لمرة واحدة — دون قراءته في Cursor أو سلسلة Claude أولاً. لا تزال أنت من يوافق على المعاينة (الملف المحدد ووجهة WhatsApp) قبل أن يقوم confirm_private_note بإنشاء URL.

ما تقوله
Send the onboarding pack at /absolute/path/client/onboarding.pdf
to Ana on WhatsApp. Burn after reading, expire tomorrow.
Don't read the PDF.

سيقوم WhatsApp بمعاينة روابط URL. هذه المعاينة هي صفحة الهبوط لـ PrivateNote، وليست الملف المفكوك تشفيره. ومع ذلك: لا تضع كلمة المرور في نفس الدردشة. إذا كان الرقم قد يكون خاطئًا، فقم بإنشاء الملاحظة، وأرسل الرابط، ثم قم بالإلغاء إذا لم تفتحها أبدًا. يجب على المستشارين وغيرهم من المرسلين المهنيين الذين يحتاجون إلى صفحة كشف ذات علامة تجارية بدلاً من فقاعة خضراء قراءة تسليم العملاء الآمن للمحامين.


تسجيل الدخول عندما تكون الحمولة ملفًا

يمكن إنشاء ملاحظات نصية فقط من contentFilePath بدون حساب، وتخضع لنفس حدود المعدل العامة للموقع الإلكتروني. إرفاق الملف مختلف. يجب أن يستدعي MCP الـ sign_in أولاً. سيؤدي ذلك إلى فتح صفحة موافقة في المتصفح (المنح موجود بالفعل في URL — لا يوجد رمز لكتابته). بعد النقر على موافق، يستدعي الوكيل sign_in مرة أخرى مع pollDeviceCode. يتم تخزين الجلسة في ~/.config/privatenote/mcp-session.json وتُرسل كـ Authorization: Bearer. وهي لا تحل محل جلسة ملف تعريف الارتباط لموقعك الإلكتروني.

  • الوكيل يشغل ()sign_in — يفتح المتصفح
  • تنقر على موافق في صفحة PrivateNote
  • الوكيل يستعلم باستخدام pollDeviceCode، ثم ()whoami
  • الوكيل يستدعي create_private_note مع مسارات الملفات (معاينة — لا يوجد URL بعد)
  • أنت توافق على الملفات المحددة، وتاريخ الانتهاء، والوجهة
  • الوكيل يستدعي confirm_private_note، ثم تقوم أنت (أو أداة أخرى) بإرسال secureUrl فقط عبر القناة البشرية

whoami يعرض الحساب المسجل دخوله. يقوم sign_out بحذف ملف جلسة المكون الإضافي. تعامل مع هذا الملف كأنه بيانات اعتماد لهذا الجهاز.

قم بتثبيت privatenote-mcp في Cursor، أو Claude Desktop، أو Codex. يحافظ الوكيل على سير العمل؛ وتحافظ العملية المحلية على السر.

افتح دليل إعداد MCP

بعد إرسال الرابط

التسليم الجيد لا ينتهي بمجرد مغادرة الرسالة لـ Slack. يمكن للجلسات المدفوعة والمسجلة التعامل مع التسليم كـ أحداث، وليس محتويات: تم الإنشاء، تم الفتح، انتهت الصلاحية، تم الإلغاء. يعيد list_sent_notes المعرفات، والحالة، و openedAt — ولا يعيد أبدًا النص الصريح. يقوم revoke_sent_note بإبطال ملاحظة لم تُفتح. يقوم notifyOnOpen بإرسال بريد إلكتروني إلى حساب PrivateNote الخاص بك عند فتح الملاحظة لأول مرة؛ ويتعرف الوكيل على الفتح عن طريق الاستعلام من list_sent_notes. لا يوجد webhook دفع إلى Cursor.

سير عمل الأعمال المدفوع بالوكيل
sign_in()
create_private_note({
  filePaths: [
    "/absolute/path/signed-contract.pdf",
    "/absolute/path/customer-export.csv"
  ],
  expiresIn: "24h",
  burnAfterReading: true,
  requireRecipientVerification: true,
  recipientEmail: "john@example.com",
  notifyOnOpen: true,
  label: "contract-for-john",
  sendChannel: "email",
  sendRecipient: "john@example.com"
})
# wait for user approval of that exact destination
confirm_private_note({ confirmationId: "<from preview>" })
# email or Slack only secureUrl to John
# later: list_sent_notes() and look for openedAt on that noteId

التحقق من المستلم هو بوابة فتح في PrivateNote، وليس بديلًا لإرسال الرسالة. تتطلب تنبيهات الفتح بريدًا إلكترونيًا تم التحقق منه للمرسل في الحساب. يتم شرح إيصالات الحالة فقط في معرفة متى تم فتح رابط سري. لا تزال الوكلاء الذين لديهم وصول واسع للأدوات بحاجة إلى نموذج الأذونات في تأمين وكلاء الذكاء الاصطناعي مثل الموظفين.


تنبيه الخصوصية الصادق

الادعاء القوي — "لم يرَ الذكاء الاصطناعي أبدًا بايتات الملف" — يظل قائمًا عندما يحترم المضيف تعليمات المسار أولاً ولا تقوم أبدًا بلصق الحمولة في المطالبة. هذا لا يعني أن الوكيل لا يمكنه رؤية secureUrl بعد التأكيد. لا تزال استدعاءات أدوات MCP العادية يمكن أن تكشف الوسائط للمضيف. لهذا السبب تفضل الأدوات المسارات: الوسيط هو /Users/you/secrets/db-password.txt، وليس كلمة المرور.

إذا كتبت create a PrivateNote for sk_live_abc123، فيمكن لمزود نموذج سحابي معالجة تلك السلسلة قبل تشغيل MCP. سيظل PrivateNote يخزن فقط النص المشفر، وسيحصل Slack فقط على رابط. لقد قمت بتحسين التسريب في المراحل اللاحقة. لكنك لم تبعد السر عن النموذج. لأقصى قدر من الخصوصية، احتفظ بالأسرار في ملفات (أو استخدم إضافة VS Code / Cursor بحيث يقوم المحرر بالتشفير دون الوكيل)، وأخبر المساعد بالمسار.

  • لا تطلب من النموذج "التحقق من PDF أولاً" أو تلخيصه. ذلك يفرض القراءة باستخدام أداة أخرى.
  • لا تضع كلمة المرور في نفس Slack/WhatsApp/البريد الإلكتروني الخاص بـ URL.
  • عامل secureUrl كسرّ. يمكن للوكيل رؤيته في نتيجة الأداة. لا تقم بتثبيته، أو تسجيله، أو لصقه في قناة Discord عامة.
  • أعد تحميل عميل MCP بعد ترقية privatenote-mcp لتبقى التعليمات والمخططات محدثة. اترك خيار one-shot مغلقاً.

أسئلة شائعة

هل يقوم PrivateNote MCP بإرسال Slack، أو Discord، أو WhatsApp، أو البريد الإلكتروني بنفسه؟

لا. يقوم بتشفير البيانات محلياً ويعيد URL بالإضافة إلى البيانات الوصفية. يتم التسليم باستخدام ما تستخدمه بالفعل — خادم MCP آخر (Gmail، Slack، ...)، أو عبر لصقك للرابط. إنشاء ملاحظة لا يعني الإذن بإرسالها. تكون قيمة sendAuthorized صحيحة فقط إذا وافقت على تلك القناة والمستلم بدقة في المعاينة.

لماذا يجب عليّ التأكيد قبل إنشاء الرابط؟

التأكيد يربط بايتات الملف الدقيقة، وخيارات الملاحظة، والوجهة. بدون ذلك، يمكن لوكيل يمتلك أيضاً أدوات بريد أو دردشة أن يشفر الملف الخطأ أو يرسل الرابط الصحيح للشخص الخطأ في دورة واحدة. يتخطى وضع one-shot هذه المعاينة. اتركه مغلقاً، خاصة إذا كان المضيف نفسه يمكنه إرسال رسائل أو ملفات.

هل يمكن للوكيل رؤية الـ URL القابل لفك التشفير؟

نعم، في مضيف MCP الحالي. يتم إرجاع secureUrl في نتيجة الأداة حتى تتمكن أداة التسليم من إرساله. ومع ذلك، يجب ألا يرى الوكيل بايتات الملف. حيازة الـ URL قد تفتح الملاحظة — عاملها كقدرة حامل للسر، وليس كـ "النموذج لا يمكنه الوصول إلى السر".

هل يجب على المستلم تثبيت أي شيء؟

لا. يفتحون الرابط الكامل في متصفح عادي. لا يلزم وجود حساب PrivateNote للكشف عن الملاحظة. قد لا يزالون بحاجة إلى كلمة مرور أو تحقق عبر البريد الإلكتروني إذا قمت بتفعيل تلك البوابات.

هل يمكنني إرفاق ملفات دون تسجيل الدخول؟

لا. يتطلب إرفاق الملفات، والقائمة/الإلغاء، والتحقق من المستلم، وإشعارات الفتح استخدام sign_in. يمكن إنشاء ملاحظة نصية فقط من contentFilePath بدون جلسة، ضمن الحدود العامة.

ماذا لو قرأ المساعد الملف على أي حال؟

إذن فإن حدود الخصوصية قد كُسرت بالفعل في تلك الدورة. تخبر تعليمات MCP المضيفين بعدم فعل ذلك. إذا تجاهل عميلك هذه التعليمات، فاستمر في استخدام إضافة المحرر أو تطبيق الويب، ولا توجه الوكيل نحو الملف. لا يزال بإمكانك إرسال الـ URL الذي أنتجته الإضافة.

هل خاصية الحرق بعد القراءة (burn-after-read) تمنع لقطات الشاشة؟

لا. بمجرد أن يقوم مستلم قانوني بفك تشفير الملاحظة، يمكنه نسخها، أو أخذ لقطة شاشة لها، أو إعادة رفعها. تعمل خاصية الحرق بعد القراءة وانتهاء الصلاحية على تقليل النسخ المتبقية في الخدمة وفي سجل الدردشة. لا يمكنهما حذف ما التقطه شخص ما عن بُعد. بالنسبة للمستندات، فإن الوصول إلى الملف للعرض فقط على Business يقلل من التحميل العرضي؛ لكنه ليس حظراً على التصوير الفوتوغرافي.

دع الوكيل يرسل الرابط. أبقِ الملف بعيداً عن النموذج.

قم بتثبيت privatenote-mcp، ووجهه إلى المسارات المحلية، واستمر في استخدام البريد الإلكتروني، و Slack، و Discord، و WhatsApp كأظرفة — وليس كخزائن. اترك خيار one-shot مغلقاً إذا كان المضيف نفسه يمكنه إرسال رسائل أو ملفات.

الصورة: Léna Le Roy · Unsplash.