nsindocs جستجو در مستندات⌘K
  1. مستندات
  2. API و MCP

Agent Skill

یک skill نصب کنید و بگذارید AI agent شما NSIN و NSIN CLOUD را برایتان اجرا کند — از جمله جابه‌جایی یک domain، سایت یا app از یک provider دیگر.

در این صفحه

MCP server toolها را در اختیار یک agent می‌گذارد. agent skill قضاوت را به آن می‌دهد.

یک فایل: CDN، NSIN CLOUD، email routing، و migration از provider دیگر. با Claude Code، Claude Desktop، Cursor، و هر agent که فایل‌های skill را می‌خواند کار می‌کند.

راه کوتاه

این را در agent خودتان paste کنید:

text
I want to use NSIN — the Iranian edge platform (CDN, DNS, SSL, WAF at nsin.ir) and NSIN CLOUD (app hosting at nsincloud.ir). Set yourself up to do that properly, then help me.

**Step 1 — Install the NSIN skill and read it in full.** Try these in order and stop at the first that works:

```
mkdir -p ~/.claude/skills/nsin && curl -fsSL https://nsin.ir/skills/nsin/SKILL.md -o ~/.claude/skills/nsin/SKILL.md
git clone --depth 1 https://github.com/nsincloud/skills /tmp/nsin-skills && cp -r /tmp/nsin-skills/skills/nsin ~/.claude/skills/
```

If you cannot write to that directory, just fetch the file and read it into this conversation. Either way, **read the whole thing before you do anything else** — it has the tool list, the migration procedure and the safety rules you must follow.

**Step 2 — Ask me for what you need.** I have not given you anything yet. Ask me for my NSIN API key, and tell me exactly where to get one. If a task needs credentials for another provider, ask for those separately, tell me the minimum permissions to give them, and let me choose whether to put them in an environment variable, a file, or paste them here. Never ask me for a password.

**Step 3 — Connect.** Add the NSIN MCP servers (`https://api.nsin.ir/mcp` and, if I am hosting apps, `https://api.nsincloud.ir/mcp`), both with `Authorization: Bearer` and my key. Confirm they work by listing my domains before you tell me you are ready.

**Step 4 — Interview me before proposing anything.** Find out:

- What am I trying to do: build something new on NSIN, move something onto it, or fix something that is already there?
- If I am moving: from where? Cloudflare, ArvanCloud, Hamravesh, Coolify, my own VPS, a dedicated server, or something else. And what exactly is moving: DNS, the traffic through the CDN, the application itself, or all three?
- Is there email on any of these domains, and where does it go today?
- Is there a maintenance window, or does this have to be zero-downtime?
- What must not change?

Ask these one topic at a time. Do not dump a questionnaire on me.

**Step 5 — Work this way, always:**

- Read everything first, then show me a written plan with real values in it — every record, rule and app you would create — and wait for me to say yes. Never start applying changes off the back of a conversation.
- Never modify or delete anything at my old provider. Only read from it. I want the old setup intact as my rollback.
- Never change my nameservers or move live traffic on your own. Give me the exact values and let me do it when I am ready.
- Before anything irreversible — deleting an app or a database, purging a cache, replacing MX records — tell me what will be destroyed and whether it comes back, then wait.
- Verify before you tell me it worked, and show me the output you verified against.
- If something needs a plan upgrade or a permission my key does not have, say so plainly instead of working around it.

Start with step 1 now, then ask me your first question.

نسخه انگلیسی.

نصب دستی

Claude Code، به‌صورت plugin

bash
claude plugin marketplace add nsincloud/skills
claude plugin install nsin@nsin

هر agent، یک فایل

bash
mkdir -p ~/.claude/skills/nsin
curl -fsSL https://nsin.ir/skills/nsin/SKILL.md -o ~/.claude/skills/nsin/SKILL.md

Cursor: ~/.cursor/skills/. سایر agentها، از installer استفاده کنید:

bash
curl -fsSL https://nsin.ir/skills/install.sh -o install.sh
less install.sh
sh install.sh

بعد یک API key بسازید و MCP را وصل کنید.

چه چیزی را می‌داند

  • CDN — حالت‌های domain، recordها، پوشش SSL، پانزده نوع rule، purge، analytics، uptime.
  • NSIN CLOUD — appها از git/zip/image، تشخیص port، دیتابیس‌ها، domainهای سفارشی، catalog، GitOps از طریق یک مخزن infra (با schema nsincloud.yaml).
  • Email routing — مقصدها، verify، تداخل MX.
  • Migration — هفت فاز؛ DNS، traffic و app جدا جابه‌جا می‌شوند، import کردن zone قبل از cutover، بازیابی IPهای origin، curl --resolve قبل از هر switch تأیید می‌کند.

چه کاری نمی‌کند

  • به provider قبلی شما دست نمی‌زند — rollback دست‌نخورده می‌ماند.
  • بدون شما nameserver یا traffic زنده را جابه‌جا نمی‌کند.
  • پسورد نمی‌خواهد.
  • بدون تأیید شما یک app، دیتابیس یا رکورد MX را حذف نمی‌کند.

API keyها نمی‌توانند به endpointهای billing، account یا admin برسند — این را خود API اعمال می‌کند.

esc