دستیار هوش مصنوعی‌تون رو با پروتکل MCP (Model Context Protocol) به noc724 وصل کنید. بعد از اتصال می‌تونید وضعیت مانیتورها رو ببینید، رخدادها رو بررسی کنید و تنظیمات مانیتورینگ رو به‌جای داشبورد، با زبان عادی مدیریت کنید.
MCP یه استاندارد بازه که به دستیارهای هوش مصنوعی اجازه می‌ده با سرویس‌های دیگه حرف بزنن. سرور MCP در noc724 دستیارتون رو مستقیم به مانیتورها، رخدادها، صفحه‌های وضعیت و پنجره‌های تعمیرات‌تون وصل می‌کنه.
شروع کار
قدم ۱: روش احراز هویت رو انتخاب کنید
OAuth (پیشنهادی)
تنظیم خاصی لازم نیست. کلاینت MCP ازتون می‌خواد وارد noc724 بشید و اتصال رو تأیید کنید. شناسه یا رمز کلاینت (Client ID/Secret) لازم نیست.
نکته: همه‌ی برنامه‌هایی که تأیید کردید رو توی «یکپارچه‌سازی و API»، بخش «برنامه‌های متصل» می‌بینید و می‌تونید قطعشون کنید. حذف یا عوض کردن کلید API روی اتصال‌های OAuth اثری نداره، چون این دوتا روش جدا از هم هستن.
با تغییر رمز حساب noc724، همه‌ی برنامه‌های MCP که با OAuth وصل شدن قطع می‌شن و باید دوباره تأییدشون کنید. برای دسترسی نوشتن، نقش شما توی تیم باید مالک، ادمین یا ویرایشگر باشه.
کلید API
اگه کلاینتتون OAuth رو پشتیبانی نمی‌کنه، از کلید API در noc724 استفاده کنید.
برای گرفتن کلید API:
- وارد noc724 بشید
- برید به یکپارچه‌سازی و API
- کلید اصلی API رو کپی کنید. اگه فقط دسترسی خوندن لازم دارید، کلید فقط‌خواندنی API رو کپی کنید.
قدم ۲: کلاینت MCP رو تنظیم کنید
سرور MCP در noc724 یه سرور HTTP راه‌دوره. یکی از این تنظیمات رو به کلاینت MCP اضافه کنید:
گزینه‌ی الف — OAuth (پیشنهادی)
{
"mcpServers": {
"noc724": {
"url": "https://mcp.noc724.ir/mcp"
}
}
}کلاینت خودش احراز هویت رو با OAuth انجام می‌ده. با همین روش می‌تونید noc724 رو به‌عنوان کانکتور سفارشی (Custom connector) به ChatGPT، Claude.ai یا Claude دسکتاپ اضافه کنید، با این آدرس: https://mcp.noc724.ir/mcp
گزینه‌ی ب — کلید API (Bearer token)
{
"mcpServers": {
"noc724": {
"type": "http",
"url": "https://mcp.noc724.ir/mcp",
"headers": {
"Authorization": "Bearer <your-api-key>"
}
}
}
}این روش برای Cursor، VS Code و کلاینت‌های دیگه‌ایه که OAuth ندارن. کلید اصلی هم می‌خونه هم می‌نویسه؛ کلید فقط‌خواندنی و کلیدهای مخصوص یه مانیتور فقط می‌تونن بخونن.
قدم ۳: اتصال رو امتحان کنید
بعد از تنظیم، از دستیارتون چیزی شبیه این‌ها بپرسید:
- «همه‌ی مانیتورهایی که الان قطعن رو نشون بده»
- «آپتایم مانیتور سایتم توی ۳۰ روز گذشته چقدر بوده؟»
- «دیروز چه رخدادهایی پیش اومد؟»
چه کارهایی می‌شه کرد
مانیتورها
| کار | نمونه‌ی درخواست |
|---|---|
| فهرست همه‌ی مانیتورها | «همه‌ی مانیتورهام رو نشون بده» |
| فیلتر با وضعیت، نوع یا برچسب | «مانیتورهایی که قطعن رو لیست کن» |
| جستجو با نام یا آدرس | «مانیتورهای shop.example.ir رو پیدا کن» |
| جزئیات یه مانیتور | «جزئیات مانیتور صفحه‌ی اصلی رو نشون بده» |
| آمار آپتایم | «آپتایم مانیتور API توی ۷ روز گذشته چقدر بوده؟» |
| زمان پاسخ | «زمان پاسخ مانیتور صفحه‌ی پرداخت رو توی ۳۰ روز گذشته نشون بده» |
| توقف یه مانیتور | «مانیتور staging رو برای تعمیرات متوقف کن» |
| ادامه‌ی یه مانیتور | «مانیتور staging رو دوباره راه بنداز» |
| تغییر یه مانیتور | «مانیتور صفحه‌ی اصلی رو کن هر ۵ دقیقه یه بار» |
| ساخت مانیتور | «یه مانیتور HTTP برای https://api.example.ir بساز که هر ۵ دقیقه چک کنه» |
پنجره‌های تعمیرات
پلنی لازمه که پنجره‌ی تعمیرات داشته باشه.
| کار | نمونه‌ی درخواست |
|---|---|
| فهرست پنجره‌های تعمیرات | «همه‌ی پنجره‌های تعمیراتم رو لیست کن» |
| جزئیات یه پنجره | «جزئیات پنجره‌ی تعمیرات شنبه رو نشون بده» |
| ساخت پنجره‌ی تعمیرات | «برای مانیتور صفحه‌ی پرداخت این جمعه ساعت ۲ تا ۴ صبح تعمیرات بذار» |
| تغییر پنجره‌ی تعمیرات | «پنجره‌ی تعمیرات صفحه‌ی پرداخت رو بنداز ساعت ۳ صبح» |
رخدادها
| کار | نمونه‌ی درخواست |
|---|---|
| فهرست رخدادها | «آخرین رخدادها رو لیست کن» |
| فیلتر با مانیتور | «رخدادهای مانیتور صفحه‌ی پرداخت رو نشون بده» |
| فقط رخدادهای جاری | «کدوم رخدادها هنوز بازن؟» |
| جزئیات یه رخداد | «علت آخرین رخداد مانیتور API چی بود؟» |
صفحه‌های وضعیت عمومی
| کار | نمونه‌ی درخواست |
|---|---|
| فهرست صفحه‌های وضعیت | «همه‌ی صفحه‌های وضعیتم رو لیست کن» |
| جزئیات صفحه‌ی وضعیت | «کدوم مانیتورها روی صفحه‌ی وضعیت عمومیم هستن؟» |
| ساخت صفحه‌ی وضعیت | «یه صفحه‌ی وضعیت به اسم «وضعیت فروشگاه» با مانیتورهای پرداخت و API بساز» |
| تغییر صفحه‌ی وضعیت | «مانیتور صفحه‌ی اصلی رو به صفحه‌ی «وضعیت فروشگاه» اضافه کن» |
حساب، مخاطبین هشدار و برچسب‌ها
| کار | نمونه‌ی درخواست |
|---|---|
| خلاصه‌ی حساب | «چندتا مانیتور فعال، قطع و متوقف دارم؟» |
| فهرست مخاطبین هشدار | «چه مخاطبین هشداری دارم؟» |
| فهرست برچسب‌ها | «برچسب‌های مانیتورهام رو لیست کن» |
رفع اشکال
کانکتور می‌گه به سرور وصل نمی‌شه
مطمئن بشید آدرس دقیقاً https://mcp.noc724.ir/mcp باشه و /mcp آخرش باشه.
احراز هویت با کلید API انجام نمی‌شه
مطمئن بشید هدر دقیقاً «Authorization: Bearer <your-api-key>» باشه و کلید هنوز توی «یکپارچه‌سازی و API» وجود داشته باشه.
ورود با OAuth تموم نمی‌شه
توی همون مرورگر وارد داشبورد noc724 بشید، بعد دوباره اتصال رو امتحان کنید و صفحه‌ی تأیید رو قبول کنید. کلاینت‌هایی که آدرس برگشت غیر از https یا localhost دارن نمی‌تونن از OAuth استفاده کنن؛ اونجا از کلید API استفاده کنید.
بعد از اینکه کار می‌کرد خطای 401 می‌گیرم
اتصال قطع شده، رمزتون عوض شده یا کلید API حذف شده. دوباره وصل بشید.
ابزار جواب می‌ده «This connection is read-only»
از کلید اصلی API استفاده کنید، یا با OAuth دوباره وصل بشید و تیک دسترسی نوشتن رو نگه دارید. نقش شما توی تیم باید مالک، ادمین یا ویرایشگر باشه.
ابزار جواب می‌ده «Not available on your plan»
اون امکان، مثل داشبورد، پلن بالاتری می‌خواد.
امنیت
- کلید اصلی API همون دسترسی‌های تیمتون در noc724 رو داره. اگه فقط می‌خواید داده بخونید، از کلید فقط‌خواندنی استفاده کنید.
- فراخوانی ابزارهای MCP و درخواست‌های API با کلید از یه سهمیه‌ی مشترک برای هر تیم استفاده می‌کنن که هر ۶۰ ثانیه‌ی گذشته حساب می‌شه.
- شماره‌تلفن‌ها، آدرس کانال‌ها، آدرس وب‌هوک‌ها، توکن‌ها و رمز صفحه‌های وضعیت هیچ‌وقت برای دستیار هوش مصنوعی فرستاده نمی‌شن.
محدودیت‌ها
- کلید فقط‌خواندنی نمی‌تونه مانیتور بسازه، تغییر بده یا متوقف کنه.
- آمار آپتایم برای ۱ ساعت، ۶ ساعت، ۲۴ ساعت، ۷ روز، ۳۰ روز و ۹۰ روز گذشته در دسترسه.
- تاریخچه‌ی زمان پاسخ تا ۳۰ روز گذشته در دسترسه.
- فهرست مانیتورها صفحه‌ای ۱۰۰ تاست.
- سقف درخواست‌ها برای هر تیم ۱۲۰ درخواست در دقیقه‌ست و با API مشترکه. بیشتر از این، درخواست‌ها با خطای HTTP 429 و هدر Retry-After رد می‌شن.
- محدودیت‌های پلن دقیقاً مثل داشبورد اعمال می‌شن. اگه امکانی توی پلنتون نباشه، درخواست با خطای پلن رد می‌شه.
- مانیتورهای API چندمرحله‌ای و رمز صفحه‌های وضعیت فقط توی داشبورد noc724 تنظیم می‌شن.
- از طریق MCP چیزی حذف نمی‌شه.
جواب سؤالتون رو گرفتید؟