اتصال رسمی MCP پوشفا

پوشفا را به دستیار هوش مصنوعی‌تان وصل کنید

در یک گفت‌وگو از دستیار بخواهید پوشفا را در پروژه‌تان راه بیندازد، وضعیت یک اعلان را بررسی کند یا پیامی را برای ارسال آماده کند.

  • وب‌سایت
  • اندروید
  • iOS
پوشفا و دستیار شما نمونه گفت‌وگو
شما

وقتی کار پروژه تمام شد، یک اعلان برای من آماده کن.

دستیار

پیش‌نمایش آماده است. گیرنده و متن را بررسی کنید.

کار تمام شد

نتیجه آمادهٔ بررسی است.

در انتظار تأیید
کارهایی که می‌توانید بسپارید

از راه‌اندازی پوشفا تا پیگیری یک پیام

MCP یک اتصال است که به دستیار اجازه می‌دهد راهنماهای رسمی پوشفا را بخواند و با اجازهٔ شما روی سرویس‌تان کار کند.

نصب در پروژه

دستیار راهنمای به‌روز وب‌سایت، اندروید یا iOS را از پوشفا می‌خواند و نصب را با ساختار پروژه‌تان هماهنگ می‌کند.

پیگیری اعلان

شناسهٔ یک اعلان را بدهید و وضعیت ارسال، تحویل و کلیک‌های ثبت‌شده را بپرسید.

ارسال به مخاطب یا گروه

متن پیام و گیرنده را مشخص کنید. دستیار قبل از ارسال، پیش‌نمایش را برای تأیید نشان می‌دهد.

راه‌اندازی

از دانلود تا اولین درخواست

اتصال را یک بار روی کامپیوترتان اضافه کنید. پس از آن می‌توانید درخواستتان را در گفت‌وگو بنویسید.

قبل از شروع

  • یک دستیار برنامه‌نویسی مثل Codex که بتواند فایل اتصال MCP را روی کامپیوتر شما اجرا کند.
  • Node.js نسخهٔ ۲۲ یا بالاتر برای اجرای فایل اتصال.
  • برای نصب پوشفا، دسترسی دستیار به پوشهٔ پروژه و کلید عمومی سرویس همان پلتفرم.
  1. فایل اتصال را ذخیره کنید

    فایل pushfa-mcp.mjs را دانلود و در پوشه‌ای ثابت نگه دارید. در مرحلهٔ بعد به مسیر همین فایل نیاز دارید.

  2. پوشفا را به دستیار اضافه کنید

    در Codex، در تنظیمات به بخش MCP servers بروید و Add server را انتخاب کنید. در دستیارهای دیگر دنبال بخش اتصال‌های MCP بگردید.

    نام اتصال
    pushfa
    نوع اتصال
    STDIO (محلی)
    فرمان اجرا
    node
    آرگومان یا مسیر فایل
    مسیر کامل فایل دانلودشده

    راهنمای رسمی افزودن MCP در Codex

  3. ذخیره کنید و درخواستتان را بنویسید

    اتصال را ذخیره و دستیار را دوباره راه‌اندازی کنید. در Codex با نوشتن /mcp در کادر گفت‌وگو می‌توانید اتصال را ببینید. برای نصب، پوشهٔ پروژه را باز کنید و یکی از نمونه‌های پایین را بفرستید.

تنظیمات برای استعلام و ارسال پیام

در پنل پوشفا، سرویس موردنظر را باز کنید و کلید عمومی و خصوصی آن را بردارید. آن‌ها را در بخش متغیرهای محیطی اتصال (Environment variables) وارد کنید. کلید خصوصی را در تنظیمات محلی اتصال نگه دارید.

کلید عمومی سرویس
PUSHFA_API_PUBLIC_KEY
کلید خصوصی سرویس
PUSHFA_API_PRIVATE_KEY
فعال‌کردن ارسال
PUSHFA_MCP_ENABLE_SEND با مقدار true

تنظیمات را ذخیره و اتصال را دوباره راه‌اندازی کنید. برای نام دقیق گزینه‌های مدیریت مخاطب و تاپیک، راهنمای فنی MCP را ببینید.

نمونه‌های آماده

در گفت‌وگو چه بنویسید؟

یک نمونه را بردارید و شناسه یا متن آن را با اطلاعات خودتان جایگزین کنید.

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

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

ببینید چه اتفاقی برای پیام افتاده

وضعیت اعلان با شناسهٔ [شناسهٔ اعلان] را در پوشفا بررسی کن. بگو پیام تحویل شده، کلیک خورده یا مشکلی در ارسال داشته است.

پایان کار را با یک اعلان خبر بدهید

وقتی این کار با موفقیت تمام شد، یک اعلان با عنوان «کار تمام شد» و متن «نتیجه آمادهٔ بررسی است» برای آخرین دستگاهِ کاربری با Alias [شناسهٔ کاربری] آماده کن. بعد از تأیید پیش‌نمایش، آن را بفرست و شناسهٔ اعلان را بگو.

پرسش‌های متداول

پیش از اولین استفاده

آیا برای شروع به حساب پوشفا نیاز دارم؟

دانلود فایل و خواندن راهنماهای نصب برای همه در دسترس است. برای اتصال اعلان‌های پروژه، کلید عمومی سرویس مربوط به همان پلتفرم را از پنل پوشفا بگیرید. استعلام و ارسال به هر دو کلید سرویس نیاز دارند.

برای سایتم روی آیفون، راهنمای وب را بخواهم یا iOS؟

برای وب‌سایت و وب‌اپی که روی صفحهٔ اصلی آیفون نصب می‌شود، راهنمای وب‌سایت را بخواهید. راهنمای iOS مخصوص اپ آیفون است.

آیا دستیار می‌تواند پیام را برای فقط یک دستگاه بفرستد؟

بله، می‌توانید شناسهٔ همان مخاطب را بدهید. اگر از شناسهٔ کاربری (Alias) استفاده می‌کنید، ممکن است چند دستگاه به آن متصل باشند. برای انتخاب آخرین دستگاه، ثبت آخرین بازدید باید در سرویس روشن باشد.

ارسال اعلان از داخل دستیار چطور حساب می‌شود؟

هزینهٔ ارسال و گزارش‌هایی که فعال کرده‌اید براساس تعرفهٔ همان سرویس محاسبه می‌شود. برای دیدن نتیجهٔ پیام، شناسهٔ اعلان را بعد از ارسال از دستیار بگیرید.

پوشفا را به دستیار خود اضافه کنید

فایل را دریافت کنید و با خواندن راهنمای نصب پروژه‌تان شروع کنید.

دانلود MCP پوشفا