MCP Server

NSIN یک Model Context Protocol (MCP) server از راه دور میزبانی می‌کند — به AI assistant خودتان بگویید "purge /assets on example.com" یا چیزی شبیه آن، با زبان عادی.

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

اتصال

Claude Code

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

Claude Desktop

این را به claude_desktop_config.json اضافه کنید (Settings → Developer → Edit Config). با mcp-remote کلید شما به‌صورت header فرستاده می‌شود:

{
  "mcpServers": {
    "nsin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.nsin.ir/mcp",
               "--header", "Authorization: Bearer nsin_your_key_here"]
    }
  }
}

Cursor

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

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

Toolها

علامت ✓ یعنی یک key read-only می‌تواند از آن tool استفاده کند. کلیدهای read-only فهرست کوچک‌تری می‌بینند — toolهای write هرگز به assistant نشان داده نمی‌شوند. هر tool به client هم می‌گوید که فقط می‌خواند یا چیزی را حذف یا جایگزین می‌کند، تا Claude و clientهای دیگر قبل از یک call پرخطر از شما بپرسند.

Domain و recordهای DNS

Import و export ناحیه (zone)

یک export از انسین همان‌طور که بود import می‌شود: recordهای proxied همچنان proxied می‌مانند و alias روی apex به‌صورت ANAME برمی‌گردد.

SSL

اشتراک‌گذاری و gatewayها

Rules

kind: cache، waf، drop، rate_limit، captcha، bot_route، fingerprint، redirect، rewrite، header، origin_pool، origin_route، basic_auth، error_page یا optimize. ruleها فقط روی hostnameهای proxied اثر دارند. نوعی که در plan شما نیست خاموش ذخیره می‌شود و روشن نمی‌شود.

Cache

Traffic و logها

Uptime

Email Routing

یک مقصد تا وقتی صاحبش روی لینک تأیید کلیک نکند چیزی forward نمی‌کند.

Account

نوشتن ruleها

اول get_rule_schema را با نوع rule صدا بزنید: همهٔ فیلدهای body آن نوع را با type، مقدارهای مجاز، پیش‌فرض‌ها و محدودیت‌ها، به‌علاوهٔ bodyهای نمونه فهرست می‌کند. بعد create_rule را با kind و body در rule صدا بزنید. فیلدی که آن نوع ندارد قبل از ذخیره رد می‌شود.

update_rule یک body جزئی می‌گیرد: فیلدهایی که نفرستید مقدارشان می‌ماند، و فهرستی که بفرستید جای فهرست قبلی را می‌گیرد. برای متوقف کردن یک rule بدون حذف، {"enabled": false} بفرستید. priority کمتر زودتر اجرا می‌شود؛ reorder_rules ترتیب یک نوع را در یک call تعیین می‌کند.

Purge کردن cache

سه tool برای purge، از دقیق‌ترین به کلی‌ترین. همه به permission cache.edit و یک plan با cache purge نیاز دارند.

purge_cache_by_path — tool روزمره، بعد از یک deploy. path: "/assets/*" (یک دایرکتوری)، path: "/" (صفحه اصلی)، path: "/blog/post-1" (یک صفحه). * یک wildcard است، نه regex.

• بدون * یعنی substring match — /logo.png با /img/logo.png?v=2 هم match می‌شود — وقتی مهم است با /assets/* آن را anchor کنید.
• hostname/node اختیاری دامنه را محدود می‌کند؛ اگر هیچ‌کدام ندهید یعنی هر hostname، هر node.
• همه variantهای cache key (query string، mobile، WebP/AVIF، CORS) هم purge می‌شوند.
• در هر call تا 10,000 آبجکت؛ truncated: true یعنی دوباره تکرار کنید. با list_cache_entries پیش‌نمایش بگیرید.

purge_cache_entries دقیقاً همان سطرهایی را purge می‌کند که list_cache_entries برگردانده — برای الگوهایی که بیش از حد match می‌کنند.

purge_cache هر چیز cache‌شده را روی هر node می‌اندازد — گزینه‌ی خشن، origin تا پر شدن دوباره تمام traffic را می‌گیرد.

toolهای هدفمند mode: "refresh" را هم می‌پذیرند: کپی cache‌شده را حذف می‌کند اما entry در فهرست می‌ماند؛ بازدیدکننده بعدی دوباره از origin می‌گیرد. در حال deploy هستید؟ از set_developer_mode استفاده کنید، نه یک حلقه purge.

Queryهای دلخواه analytics

run_analytics_query کارهایی را پوشش می‌دهد که هیچ tool اختصاصی انجام نمی‌دهد — "20 URI برتر بر اساس تعداد 5xx، 7 روز اخیر". یک SELECT از ClickHouse روی جدول requests بدهید، ستون‌ها و ردیف‌ها را به‌صورت JSON پس بگیرید، با سقف 10,000 ردیف.

Sandboxed است:

• فقط خواندن. فقط یک SELECT/WITH … SELECT. write، DDL، تغییر تنظیمات، INTO OUTFILE/FORMAT، توابع table (url، file، remote، s3، …) رد می‌شوند.
• فقط داده‌های خودتان — محدود به domainهایی که key شما به آن‌ها دسترسی دارد، حتی در یک subquery.
• زمان اجرا و تعداد ردیف محدود است.

ستون‌های مفید requests: event_time، domain_id، hostname، method، uri، status، bytesIn، bytesOut، duration (میلی‌ثانیه)، remoteAddr، country، asn، asnOrg، userAgent، cacheStatus (hit/miss/bypass)، bypassReason، cacheAge، reqStatus (cache/proxied/direct)، isWS، protocol، referer، rayId، node، originStatus، originAddr، error، errFault (origin/edge/client)، errReason، upstreamDuration (میلی‌ثانیه)، originConnReused، originDialMs، originTlsMs، originTtfbMs، originTlsVersion، ja4، botKind، wafScore، mdConverted، optKind. با toStartOfHour(event_time) یا toStartOfDay(event_time) bucket بسازید.

errFault = 'origin' outageهایی را می‌گیرد که status 5xx ندارند — timeout، refused connection، قطع ناگهانی — چیزهایی که status >= 500 از قلم می‌اندازد.

دسترسی‌ها و ایمنی

• MCP از دسترسی‌های خود account شما استفاده می‌کند — نقش Viewer روی یک domain share‌شده، حتی با یک key با دسترسی کامل، toolهای write را روی آن domain مسدود می‌کند.
• featureهای plan هم gate می‌کنند: monitoring، logها، WAF، cache purge؛ یک tool که به یکی از این‌ها نیاز دارد با دلیل شکست می‌خورد.
• هر اقدام همان validation، audit logging و metering مصرف REST API را می‌گیرد، و در rate limit 300 request در دقیقه حساب می‌شود.
• toolهایی که چیزی را برای همیشه حذف می‌کنند confirm: true می‌گیرند؛ assistant باید اول از شما بپرسد.
• هیچ keyای نمی‌تواند پول جابه‌جا کند: شارژ کیف پول، خرید plan و انتخاب عضو پرداخت‌کنندهٔ یک domain فقط در پنل انجام می‌شود.
• Revoke کردن key در پنل، assistant را قطع می‌کند.