توسعه‌دهندهmcpیکپارچه‌سازیامنیت

استفاده از PrivateNote با OpenAI Codex

به‌روزرسانی شده ۳۱ اردیبهشت ۱۴۰۵مطالعه 5 دقیقه‌ایPrivateNote.ai

با یک دستور، PrivateNote MCP را به هر نشست Codex متصل کنید. مراحل راه‌اندازی، قابلیت‌های Codex و نحوه دور نگه داشتن اسرار از پرامپت عامل هوش مصنوعی.

نکات کلیدی

  • 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 یک عامل کدنویسی هوش مصنوعی است. شما آنچه را که می‌خواهید توصیف می‌کنید — رفع یک باگ، افزودن یک ویژگی، نوشتن یک تست — و او آن را به‌طور خودکار در یک محیط ایزوله (sandboxed) انجام می‌دهد.

اما عامل‌ها به اطلاعات حساس (secrets) نیاز دارند. آن‌ها باید مخازن را از طریق SSH کلون کنند، از ریجستری‌های بسته پکیج دریافت کنند، به پایگاه‌های داده محیط staging متصل شوند و APIهای داخلی را فراخوانی کنند. این یعنی انتقال اعتبارها (credentials) به آن‌ها.

چسباندن یک کلید API در پرامپت یک عامل، تفاوت بنیادی با چسباندن آن در Slack ندارد — در نهایت در تاریخچه متن (context history)، احتمالاً در لاگ‌ها و احتمالاً در حافظه‌ای که بین جلسات باقی می‌ماند، ذخیره می‌شود. PrivateNote مسیر تمیزتری را به شما ارائه می‌دهد: رمز حساس را قبل از اینکه عامل آن را ببیند رمزگذاری کنید، لینکی را به اشتراک بگذارید که پس از یک بار خوانده شدن خودتخریبی می‌شود، و هیچ اثری از آن باقی نگذارید.

در اینجا نحوه اتصال این دو آورده شده است.

MCP چیست؟

MCP (پروتکل کانتکست مدل) یک پروتکل باز است که به اپلیکیشن‌های هوش مصنوعی اجازه می‌دهد از طریق سرورهای استاندارد، به ابزارها، منابع داده و سرویس‌ها متصل شوند. هر کلاینت سازگار با 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)

اگر از Codex CLI استفاده می‌کنید، افزودن 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: ورودی مشابه را در مسیر Settings → 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 برای اطلاعات ورود محیط staging تولید کن و لینک را به من بده"

آنچه ابزار در واقع انجام می‌دهد

وقتی هوش مصنوعی create_private_note را فراخوانی می‌کند، سرور MCP یک فرآیند محلی Node.js را روی سیستم شما اجرا می‌کند. رمزنگاری در همان‌جا انجام می‌شود — پیش از آنکه چیزی با شبکه تماس پیدا کند.

سرور یک کلید AES با 256 بیت تصادفی تولید می‌کند، محتوا را با AES-256-GCM رمزنگاری می‌کند و فقط متن رمزنگاری‌شده (ciphertext) را به privatenote.ai ارسال (POST) می‌کند. کلید در درخواست وجود ندارد.

کلید رمزگشایی فقط در قطعه (fragment) URL قرار دارد — همان بخش #this-part که مرورگرها هرگز به سرورها نمی‌فرستند. آنچه بازمی‌گردد یک لینک است. هر کسی لینک را باز کند، آن را در مرورگر خود رمزگشایی می‌کند. یادداشت بلافاصله پس از آن خود را حذف می‌کند.

سایت privatenote.ai داده‌های رمزنگاری‌شده (blobs) را ذخیره می‌کند. بدون آن قطعه (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، ایمیل یا تاریخچه چت باقی نماند — اما این با این که هوش مصنوعی هرگز آن را نبیند، متفاوت است.

دو راه برای پر کردن این شکاف:

  • هنگام استفاده از Codex IDE از افزونه VS Code استفاده کنید — متن محرمانه را در ویرایشگر خود انتخاب کنید، راست‌کلیک کرده و سپس Share as PrivateNote را بزنید. متن محرمانه مستقیماً از ویرایشگر شما به لینک رمزگذاری‌شده می‌رود. Codex هرگز در این فرآیند دخالتی ندارد
  • برای نشستِ (session) عامل، از یک مدل محلی استفاده کنید. هیچ داده‌ای از دستگاه شما خارج نمی‌شود مگر اینکه قبلاً رمزگذاری شده باشد

استفاده از افزونه VS Code در Codex IDE

Codex درون یک ویرایشگر سازگار با VS Code اجرا می‌شود. افزونه PrivateNote VS Code در آنجا دقیقاً همان‌گونه که در VS Code استاندارد کار می‌کند، نصب و اجرا می‌شود.

ترمینال
code --install-extension PrivateNote.privatenote-vscode
  • پس از نصب، یک آیکون پاکت نامه در نوار فعالیت (activity bar) ظاهر می‌شود — برای باز کردن پنل PrivateNote روی آن کلیک کنید
  • برای یک اشتراک‌گذاری سریع و یک‌باره، هر متنی را در ویرایشگر انتخاب کنید، راست‌کلیک کرده و Share as PrivateNote را بزنید
  • هر زمان که متنی را انتخاب کنید، آیکون قفل در نوار عنوان ویرایشگر ظاهر می‌شود
  • با این مسیر، Codex هرگز با متن خام برخورد نمی‌کند — افزونه به‌صورت محلی در فرآیند میزبانِ VS Code عملیات رمزگذاری را انجام می‌دهد

اگر فایل تنظیمات (config) را ترجیح می‌دهید

همچنین می‌توانید سرور MCP را به‌صورت دستی اضافه کنید. دستور codex mcp add در فایل ~/.codex/config.toml نوشته می‌شود — اگر ترجیح می‌دهید می‌توانید مستقیماً آن فایل را ویرایش کنید:

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

اشاره به یک نمونه خودمیزبانی‌شده (self-hosted)

اگر تیم شما یک سرور خصوصی 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 خود است. با آن همان دقتِ خودِ اعتبار (credential) را داشته باشید — آن را commit نکنید، در لاگ‌ها ثبت نکنید و در کانال‌های عمومی منتشر نکنید.

قابلیت Burn-after-reading دقیقاً به همین معناست. به محض باز شدن لینک، از بین می‌رود. نه شما و نه گیرنده نمی‌توانید دوباره آن را باز کنید.

پس از اشتراک‌گذاری، اعتبار را تغییر دهید (Rotate). اگر یک اعتبار در یک پرامپت هوش مصنوعی ظاهر شد — حتی برای مدت کوتاه — با آن مانند چیزی که احتمالاً دیده شده برخورد کنید. مقدار فعلی را از طریق PrivateNote به اشتراک بگذارید، سپس آن را به یک مقدار جدید تغییر دهید.

PrivateNote برای تحویل دادن است، نه ذخیره‌سازی. اگر نیاز دارید یک اطلاعات محرمانه بیش از چند روز در دسترس باشد، از یک مدیریت‌کننده اعتبار (secrets manager) مناسب استفاده کنید. PrivateNote مرحله انتقال امن است، نه خزانه.

از بازه‌های انقضای کوتاه استفاده کنید. برای اطلاعات محرمانه یک‌باره، 15m یا 1h تقریباً همیشه کافی است. از کوتاه‌ترین بازه‌ای که برای گیرنده شما کار می‌کند، استفاده کنید.

دستیار هوش مصنوعی خود را به PrivateNote متصل کنید

با یک دستور یا یک بلوک JSON، سرور MCP ثبت می‌شود. از آن پس، هر نشست دارای یک ابزار داخلی امن برای اشتراک‌گذاری اسرار است.

امتحان کردن PrivateNote ←
عکس: Léna Le Roy · Unsplash.