مطورmcpتكاملالأمان

استخدام PrivateNote مع OpenAI Codex

تم التحديث 21 مايو 2026قراءة 5 دقائقPrivateNote.ai

أمر واحد يربط PrivateNote MCP بكل جلسة Codex. خطوات الإعداد، وما يمكن لـ Codex فعله، وكيفية إبقاء الأسرار بعيداً عن مطالبة الوكيل (agent prompt).

أهم النقاط

  • Wire PrivateNote MCP once so Codex can create encrypted notes safely.
  • Keep raw secrets out of the agent prompt and chat logs.
  • Use short-lived notes for handoffs between humans and tools.
  • Treat MCP output links as sensitive—same as the secret itself.

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

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

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

إليك كيفية الربط بينهما.

ما هو MCP؟

بروتوكول MCP (Model Context Protocol) هو بروتوكول مفتوح يتيح لتطبيقات الذاء الاصطناعي الاتصال بالأدوات ومصادر البيانات والخدمات من خلال خوادم معيارية. يمكن لأي عميل متوافق مع MCP — مثل Claude Desktop، أو Cursor، أو Codex، أو Windsurf، أو أي مساعد آخر — استدعاء الأدوات التي يوفرها خادم MCP.

يوفر خادم PrivateNote الخاص بـ MCP أداة واحدة فقط: create_private_note. عندما يستدعيها الذكاء الاصطناعي، تقوم عملية Node.js محلية بتشفير محتواك قبل أن يلمس أي شيء الشبكة. والنتيجة هي رابط آمن ومنتهي الصلاحية يمكنك مشاركته مع أي شخص.

المتطلبات

قبل التثبيت، تأكد من توفر ما يلي:

  • عميل متوافق مع MCP: مثل Claude Desktop، أو Cursor، أو Codex CLI، أو Windsurf، أو أي عميل يطبق مواصفات MCP
  • إصدار Node.js 18 أو أحدث — تحقق عبر: node --version
  • توفر npx — تحقق عبر: npx --version
  • وصول الشبكة إلى privatenote.ai (أو النسخة المستضافة ذاتياً الخاصة بك)

المسار الأسرع: أمر واحد (Codex)

إذا كنت تستخدم CLI الخاص بـ Codex، فإن إضافة PrivateNote كخادم MCP عالمي تتم بأمر واحد فقط:

الطرفية
codex mcp add privatenote -- npx -y privatenote-mcp
  • هذا كل شيء. يتم تسجيل الخادم عالمياً في ~/.codex/config.toml
  • كل جلسة Codex جديدة لديها صلاحية الوصول إلى أداة create_private_note
  • لا حاجة لإعدادات على مستوى المشروع — فهي تتبعك عبر جميع المستودعات

Claude Desktop وعملاء MCP الآخرون

تقبل معظم عملاء MCP ملف إعدادات JSON. بالنسبة لـ Claude Desktop، افتح ملف الإعدادات الخاص بنظام التشغيل لديك:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

أضف الإدخال التالي، ثم احفظ الملف وأعد تشغيل Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "privatenote": {
      "command": "npx",
      "args": ["-y", "privatenote-mcp"]
    }
  }
}
  • بعد إعادة التشغيل، سيتعرف Claude على الخادم ويقوم بإظهار أداة create_private_note في الدردشة تلقائيًا
  • Cursor: أضف الإدخال نفسه ضمن الإعدادات ← MCP
  • أي عميل آخر يتبع مواصفات MCP يستخدم نفس كتلة JSON

ما يمكنك الآن طلبه من مساعدك الذكي

بمجرد اتصال خادم MCP، يمكنك استخدام اللغة الطبيعية العادية:

مثال
# Example response from the assistant:

PrivateNote created:
https://privatenote.ai/note/xK9m2p...#A3f7...

Expires in 24 hours · Burns after reading
  • "أنشئ PrivateNote يقول: كلمة المرور المؤقتة هي X. اجعلها تنتهي صلاحيتها خلال 24 ساعة."
  • "ضع كلمة مرور قاعدة البيانات هذه في رابط ذاتي التدمير للمقاول"
  • "أرسل مفتاح SSH بشكل آمن — انتهاء الصلاحية خلال 15 دقيقة، يحرق بعد القراءة"
  • "أنشئ PrivateNote لبيانات اعتماد بيئة الاختبار وأعطني الرابط"

ما تفعله الأداة فعليًا

عندما يستدعي الذكاء الاصطناعي create_private_note، يقوم خادم MCP بتشغيل عملية Node.js محلية على جهازك. تتم عملية التشفير هناك — قبل أن يلمس أي شيء الشبكة.

يولد الخادم مفتاح AES عشوائيًا بحجم 256 بت، ويشفر المحتوى باستخدام AES-256-GCM، ويرسل النص المشفر فقط عبر طلب POST إلى privatenote.ai. المفتاح لا يكون موجودًا في الطلب.

يعيش مفتاح فك التشفير فقط في جزء URL — وهو الجزء الذي يبدأ بـ #this-part والذي لا ترسل المتصفحات أبدًا إلى الخوادم. ما يعود هو رابط فقط. ومن يفتح الرابط يقوم بفك تشفيره في متصفحه الخاص. ثم تُحذف الملاحظة فورًا بعد ذلك.

يقوم privatenote.ai بتخزين كتل بيانات مشفرة. وبدون الجزء الخاص (fragment)، لا معنى لهذه الكتل.

خيارات الأداة الشائعة

تقبل أداة create_private_note المعلمات التالية:

الطلب
# Structured example prompt:

Create a PrivateNote with:
content: "The deployment token is ghp_abc123"
expiresIn: "15m"
burnAfterReading: true
  • content — النص الحساس المراد تشفيره وتخزينه (مطلوب)
  • expiresIn — المدة التي تظل فيها الملاحظة متاحة: 15m، أو 1h، أو 24h، أو 7d (الافتراضي: 24h)
  • burnAfterReading — تدمير الملاحظة بعد أول عرض (الافتراضي: true)
  • title — تسمية اختيارية تضاف قبل المحتوى قبل التشفير

تنبيه الخصوصية الذي يجب أن تفهمه

إليك الجزء الصريح: عندما تكتب سرًا في مطالبة Codex، يقرأه Codex قبل تشغيل أداة MCP. تقوم خوادم OpenAI بمعالجة تلك الرسالة.

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

طريقتان لسد هذه الفجوة:

  • استخدم إضافة VS Code عند التواجد في Codex IDE — حدد السر في المحرر، انقر بزر الماوس الأيمن ← Share as PrivateNote. ينتقل السر مباشرة من المحرر الخاص بك إلى الرابط المشفر. Codex لا يتدخل مطلقاً
  • استخدم نموذجاً محلياً لجلسة الوكيل (agent session). لا يخرج أي شيء من جهازك إلا بعد تشفيره بالفعل

استخدام إضافة VS Code في Codex IDE

يعمل Codex داخل محرر متوافق مع VS Code. يتم تثبيت إضافة PrivateNote VS Code وتعمل هناك تماماً كما تعمل في VS Code القياسي.

الطرفية
code --install-extension PrivateNote.privatenote-vscode
  • بعد التثبيت، تظهر أيقونة مغلف في شريط النشاط — انقر عليها لفتح لوحة PrivateNote
  • حدد أي نص في المحرر، انقر بزر الماوس الأيمن ← Share as PrivateNote لإجراء سريع لمرة واحدة
  • تظهر أيقونة القفل في شريط عنوان المحرر كلما قمت بتحديد نص
  • من خلال هذا المسار، لا يلمس Codex النص الصريح أبداً — تقوم الإضافة بالتشفير محلياً في عملية استضافة VS Code

إذا كنت تفضل ملف الإعدادات

يمكنك أيضاً إضافة خادم MCP يدوياً. يقوم الأمر codex mcp add بالكتابة في ~/.codex/config.toml — يمكنك تحرير ذلك الملف مباشرة إذا كنت تفضل ذلك:

~/.codex/config.toml
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

الإشارة إلى نسخة مستضافة ذاتياً

إذا كان فريقك يدير خادم PrivateNote خاصاً، فقم بتعيين URL الأساسي عبر متغير بيئة في إعدادات MCP:

~/.codex/config.toml
[mcp_servers.privatenote]
command = "npx"
args = ["-y", "privatenote-mcp"]

[mcp_servers.privatenote.env]
PRIVATENOTE_API_BASE_URL = "https://notes.your-domain.com"
  • تبقى جميع الأسرار على بنيتك التحتية — لا يصل أي شيء إلى privatenote.ai
  • ينطبق نفس تشفير AES-256-GCM؛ يتغير فقط وجهة التخزين

استكشاف الأخطاء

إذا لم تظهر أداة PrivateNote في برنامجك بعد الإعداد:

  • أعد تشغيل عميل MCP الخاص بك — لا يتم التقاط تغييرات الإعداد أثناء تشغيل التطبيق
  • تأكد من تثبيت Node.js ووجوده في PATH الخاص بك: node --version
  • تأكد من عمل npx: npx --version
  • تحقق من صحة إعدادات JSON الخاصة بك — الفاصلة في نهاية السطر هي الخطأ النحوي الأكثر شيوعاً
  • تحقق من سجلات MCP أو سجلات الإضافة الخاصة بعميلك بحثاً عن أخطاء بدء التشغيل
  • تأكد من أن جهازك لديه وصول إلى الشبكة لـ privatenote.ai (أو المضيف المستضاف ذاتياً الخاص بك)

بعض الأشياء التي يجب تذكرها

الـ URL هو السر. يحتوي الرابط على مفتاح فك التشفير في الجزء المرجعي (fragment) الخاص به. تعامل معه بنفس العناية التي تتعامل بها مع بيانات الاعتماد نفسها — لا تقم بإرساله (commit)، لا تسجله في السجلات (log)، ولا تنشره في قناة عامة.

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

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

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

استخدم نوافذ انتهاء صلاحية قصيرة. بالنسبة للأسرار التي تستخدم لمرة واحدة، فإن 15m أو 1h كافٍ دائماً تقريباً. اعتمد أقصر نافذة زمنية لا تزال تعمل مع المستلم الخاص بك.

قم بتوصيل مساعد الذكاء الاصطناعي الخاص بك بـ PrivateNote

أمر واحد أو كتلة JSON واحدة تسجل خادم MCP. كل جلسة بعد ذلك تحتوي على أداة مدمجة لمشاركة الأسرار بشكل آمن.

جرب PrivateNote ←
الصورة: Léna Le Roy · Unsplash.