- مستندات
- 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 کنید:
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
claude plugin marketplace add nsincloud/skills
claude plugin install nsin@nsinهر agent، یک فایل
mkdir -p ~/.claude/skills/nsin
curl -fsSL https://nsin.ir/skills/nsin/SKILL.md -o ~/.claude/skills/nsin/SKILL.mdCursor: ~/.cursor/skills/. سایر agentها، از installer استفاده کنید:
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 اعمال میکند.