سرور MCP

NSIN یک سرور Model Context Protocol (MCP) از راه دور میزبانی می‌کند تا دستیارهای هوش مصنوعی بتوانند دامنه‌ها، رکوردهای دی‌ان‌اس و کش شما را با زبان طبیعی مدیریت کنند — «یک رکورد A برای staging به 203.0.113.7 اضافه کن»، «کش example.com را پاک کن»، «این هفته چقدر ترافیک داشتم؟».

• آدرس: https://api.nsin.cloud/mcp (Streamable HTTP)
• احراز هویت: کلید API شما به‌صورت Authorization: Bearer nsin_…
• چیزی برای نصب نیست — NSIN آن را میزبانی می‌کند.

اتصال

Claude Code

claude mcp add --transport http nsin https://api.nsin.cloud/mcp \
  --header "Authorization: Bearer nsin_your_key_here"

Claude.ai / Claude Desktop

در Settings → Connectors یک custom connector با آدرس https://api.nsin.cloud/mcp اضافه کنید و هدر Authorization: Bearer nsin_… را هنگام درخواست وارد کنید.

Cursor

به .cursor/mcp.json (یا ~/.cursor/mcp.json سراسری) اضافه کنید:

{
  "mcpServers": {
    "nsin": {
      "url": "https://api.nsin.cloud/mcp",
      "headers": { "Authorization": "Bearer nsin_your_key_here" }
    }
  }
}

ابزارها

ابزار	کلید فقط‌خواندنی	توضیح
list_domains	✓	همه‌ی دامنه‌های در دسترس، با وضعیت و نقش شما
get_domain	✓	جزئیات و تنظیمات کامل یک دامنه
list_dns_records	✓	رکوردهای دی‌ان‌اس با شناسه، وضعیت پراکسی و TTL
get_analytics_summary	✓	ترافیک، پهنای باند، بازدیدکننده و نسبت کش در یک بازه
run_analytics_query	✓	اجرای کوئری فقط‌خواندنی روی لاگ درخواست‌های شما
get_ssl_status	✓	اعتبار، انقضا، صادرکننده و SANهای گواهی
list_cache_rules	✓	قوانین کش لبه
create_dns_record	—	ساخت رکورد دی‌ان‌اس
update_dns_record	—	تغییر فیلدهای یک رکورد
delete_dns_record	—	حذف رکورد
purge_cache	—	پاک‌سازی کل کش یک دامنه

یادداشت

کلید فقط‌خواندنی تنها هفت ابزار خواندنی را در معرض دستیار می‌گذارد — دستیار حتی ابزارهای نوشتن را نمی‌بیند، چه رسد به فراخوانی. وقتی می‌خواهید هوش مصنوعی فقط بررسی و گزارش کند، از کلید فقط‌خواندنی استفاده کنید.

کوئری‌های دلخواه آمار

run_analytics_query به دستیار اجازه می‌دهد به پرسش‌هایی پاسخ دهد که ابزار اختصاصی ندارند — «۲۰ آدرس برتر بر اساس تعداد 5xx در ۷ روز گذشته»، «پهنای باند ساعتی یک زیردامنه»، «کدام ASNها بیشترین ترافیک bypass را فرستاده‌اند». شما (یا هوش مصنوعی) یک SELECT روی جدول requests می‌فرستید و ستون‌ها و سطرها را به‌صورت JSON می‌گیرید (تا سقف ۱۰٬۰۰۰ سطر).

این قابلیت به‌شدت محدود شده است:

• فقط خواندن. تنها یک SELECT (یا WITH … SELECT) پذیرفته می‌شود. نوشتن، DDL، تغییر تنظیمات، INTO OUTFILE/FORMAT و توابع جدولی (url، file، remote، s3، …) رد می‌شوند.
• فقط داده‌ی خودتان. هر کوئری توسط موتور به دامنه‌هایی که کلید شما به آن‌ها دسترسی دارد محدود می‌شود؛ حتی داخل زیرکوئری هم راهی برای خواندن داده‌ی دیگران نیست.
• محدود. زمان اجرا و تعداد سطرهای خوانده‌شده و بازگشتی سقف دارند تا کوئری سنگین از کنترل خارج نشود.

ستون‌های مفید requests: ‏event_time، domain_id، hostname، method، uri، status، bytesIn، bytesOut، duration (میلی‌ثانیه)، remoteAddr، country، asn، asnOrg، userAgent، cacheStatus (‏hit/miss/bypass)، reqStatus (‏cache/proxied/direct)، isWS، protocol، referer، originStatus، originAddr، error. برای دسته‌بندی زمانی از toStartOfHour(event_time) یا toStartOfDay(event_time) استفاده کنید.

مجوزها و ایمنی

• سرور MCP دقیقاً با مجوزهای حساب شما عمل می‌کند. نقش‌های اشتراک‌گذاری اعمال می‌شوند: با دسترسی Viewer روی یک دامنه‌ی اشتراکی، ابزارهای نوشتن روی آن دامنه حتی با کلید کامل شکست می‌خورند.
• هر عمل MCP از همان مسیر اعتبارسنجی، ثبت وقایع و شمارش مصرف REST API عبور می‌کند و در محدودیت نرخ کلید (۳۰۰ درخواست در دقیقه) حساب می‌شود.
• ابطال کلید در پنل، دستیار را بلافاصله قطع می‌کند.

احتیاط

کلید با دسترسی کامل به دستیار متصل اجازه می‌دهد دی‌ان‌اس زنده را تغییر دهد. پیش از تأیید عملیات نوشتن، کاری را که ابزار هوش مصنوعی قصد دارد انجام دهد مرور کنید و برای کاوش، کلید فقط‌خواندنی را ترجیح دهید.