اتصال پوشفا به دستیار هوش مصنوعی با MCP
از دستیار برنامه‌نویسی بخواهید پوشفا را در پروژه Web، Android یا iOS نصب کند. از همین اتصال می‌توانید برای استعلام، ارسال و مدیریت سرویس هم استفاده کنید.
راه‌اندازی MCP
به Node.js نسخه ۲۲ یا بالاتر و کلاینت MCP با پشتیبانی از stdio نیاز دارید. فایل را دریافت کنید و مسیر کامل آن را در تنظیمات MCP کلاینت وارد کنید. در ویندوز می‌توانید از مسیری مثل C:/Users/YourName/pushfa-mcp.mjs استفاده کنید.
{
"mcpServers": {
"pushfa": {
"command": "node",
"args": ["/absolute/path/pushfa-mcp.mjs"]
}
}
}نصب یا ارتقای پوشفا در پروژه
دستیار برنامه‌نویسی با ابزار pushfa_read_installation_guide متن راهنمای پلتفرم را از فایل Markdown رسمی پوشفا می‌خواند. ابزار فهرست بخش‌ها و متن را در چند قسمت برمی‌گرداند. بعد از انتشار تغییرات راهنما روی سایت، درخواست بعدی همان نسخهٔ منتشرشده را می‌خواند.
web برای سایت و PWA، از جمله Web Push روی iOS، و گزینه ios برای اپ Native iOS است.پوشفا را در این پروژه نصب کن. ابتدا ساختار پروژه و اتصال فعلی اعلان‌ها را بررسی کن، سپس راهنمای رسمی پلتفرم را با MCP پوشفا بخوان و مراحل مربوط به نصب را پیاده کن. تنظیمات باقی‌ماندهٔ پنل یا Firebase و APNs را در پایان بگو.اتصال سرویس و فعال‌کردن ابزارهای عملیاتی
برای استعلام و عملیات روی یک سرویس، کلید عمومی و خصوصی همان سرویس را به‌ترتیب در PUSHFA_API_PUBLIC_KEY و PUSHFA_API_PRIVATE_KEY در بخش env تنظیمات محلی MCP قرار دهید. برای فعال‌کردن هر دسته از عملیات، متغیر مربوط را با مقدار رشته‌ای "true" اضافه کنید و اتصال را دوباره راه‌اندازی کنید.
| تنظیمات | امکانات |
|---|---|
| با تنظیم کلیدهای سرویس | استعلام وضعیت مخاطب و اعلان، دریافت Alias و Custom Alias، براکت‌ها، تاپیک‌های مخاطب و اعضای تاپیک. |
| PUSHFA_MCP_ENABLE_SEND | ارسال تکی و گروهی عادی و Lite، ارسال با Subscriber ID، Alias، Custom Alias و تاپیک. |
| PUSHFA_MCP_ENABLE_MANAGEMENT | تنظیم و حذف Alias، Custom Alias و براکت، ساخت تاپیک، تغییر عضویت، مدیریت کاربر آزمایشی و ثبت پروفایل و رویداد RetenX. |
| PUSHFA_MCP_ENABLE_IDENTITY | اتصال و لغو اتصال مخاطب به پوش‌باکس و عملیات Auth Push شامل اتصال دستگاه، ساخت چالش و مصرف Grant. |
انتخاب گیرنده و نوع ارسال
مثلاً بگویید «برای مخاطبانی که Custom Alias با برچسب customer_id و مقدار 1001 یا 1002 دارند، پیام آماده‌شدن سفارش را آماده کن.» برای زمان‌بندی، تاریخ و ساعت تهران را مشخص کنید. در ارسال گروهی، مقدار all برای topic کل مخاطبان قابل ارسال سرویس را هدف می‌گیرد.
| نوع ارسال | ورودی گیرنده |
|---|---|
| تکی عادی یا Lite |
subscriber_id یا fcm_token
|
| گروهی عادی یا Lite |
subscriber_ids، fcm_tokens یا topic
|
| ارسال با شناسه مخاطب |
subscriber_ids با نتیجه جداگانه برای هر شناسه
|
| Alias اصلی |
alias مانند شناسه کاربر در سامانه شما
|
| Custom Alias |
label و آرایه values، مثلاً برچسب customer_id و شناسه‌های 1001 و 1002
|
| ارسال سریع به تاپیک |
topic
|
تأیید عملیات و پیگیری نتیجه
برای ارسال یا تغییر اطلاعات، دستیار ابتدا یکی از ابزارهای pushfa_prepare_* را فراخوانی می‌کند و پیش‌نمایش را برای تأیید نشان می‌دهد. پس از تأیید شما، ارسال با pushfa_send_notification و تغییرات مدیریتی یا هویتی با pushfa_confirm_operation انجام می‌شوند. هر پیش‌نمایش تا پنج دقیقه در همان اتصال معتبر است و یک بار قابل استفاده است. اگر کلاینت تأیید جداگانه برای هر ابزار دارد، آن را برای این دو ابزار فعال کنید.
pushfa_get_notification_status نگه دارید. در ارسال‌هایی که وب‌سرویس نتیجه جداگانه دارد، rejected_recipients مشخص می‌کند کدام گیرنده یا مقدار Alias رد شده و چرا. گزارش تحویل و کلیک در ارسال‌های پشتیبانی‌شده به‌صورت پیش‌فرض غیرفعال‌اند و در صورت فعال‌سازی طبق تعرفه محاسبه می‌شوند. اگر نتیجه ارسال نامشخص بود، پیش از ارسال دوباره گزارش‌ها را در پنل بررسی کنید.