راهنما

بدون ترمینال: اتصال ChatGPT یا Claude

ترمینال پنجره‌ای است که در آن دستور تایپ می‌کنید. اگر از ChatGPT، سایت claude.ai یا برنامه Claude استفاده می‌کنید، به ترمینال نیازی ندارید. لازم نیست چیزی نصب کنید یا فایل تنظیمات را دستی تغییر دهید. روتر MCP سرورهایی را که انتخاب می‌کنید در حساب شما نگه می‌دارد. برنامه‌تان فقط یک نشانی را به‌عنوان کانکتور (اتصال سفارشی) اضافه می‌کند.

1. با حساب GitHub وارد شوید و سرورهایی را که می‌خواهید انتخاب کنید.
2. نشانی روتر را در تنظیمات برنامه‌تان به‌عنوان کانکتور اضافه کنید و اجازه دسترسی بدهید.
3. به فارسی سؤال بپرسید. هر وقت خواستید، سرورها را از داشبورد اضافه یا حذف کنید.

شروع کنیداول در آزمایشگاه امتحان کنید

در صفحه شروع، مراحل اتصال هر برنامه را قدم‌به‌قدم می‌بینید. در آزمایشگاه هم می‌توانید بدون نصب، چند ابزار نمونه را در یک گفتگو امتحان کنید.

MCP و مهارت (Skill) چیست؟

MCP (Model Context Protocol) یک استاندارد باز است؛ یعنی زبان مشترکی که دستیارهای هوش مصنوعی مثل Claude، Cursor و Copilot با آن به سرویس‌ها و داده‌های بیرونی وصل می‌شوند. هر سرور MCP چند «ابزار» دارد؛ یعنی کارهایی که دستیار می‌تواند انجام دهد. مثلاً سرور دیجی‌کالا ابزار جستجوی کالا دارد و دستیار هر وقت لازم باشد از آن استفاده می‌کند.

مهارت (Agent Skill) یک راهنمای نوشته‌شده برای دستیار است: پوشه‌ای با فایل SKILL.md که Claude فقط وقتی لازم باشد آن را می‌خواند. مهارت کدی اجرا نمی‌کند و کلید یا اینترنت نمی‌خواهد. فقط روش درست انجام یک کار را به دستیار یاد می‌دهد؛ مثل قواعد نیم‌فاصله یا ذخیره درست تاریخ شمسی.

قبل از نصب

• سرورهایی که با npx اجرا می‌شوند به Node.js نسخه ۲۰ یا بالاتر نیاز دارند. برای اطمینان از نصب، node -v را در ترمینال بزنید؛ باید شماره نسخه را ببینید.
• سرورهای پایتونی که با uvx اجرا می‌شوند به uv نیاز دارند.
• Claude Desktop و Claude Code روی ویندوز فقط با cmd /c می‌توانند npx را اجرا کنند. صفحه هر ابزار برای این دو برنامه گزینه «سیستم‌عامل» دارد. روی ویندوز این گزینه خودبه‌خود «ویندوز» است و دستور را با cmd /c می‌سازد. اگر دستور را برای کامپیوتر دیگری می‌خواهید، آن را به «macOS / لینوکس» تغییر دهید.
• بعد از تغییر فایل تنظیمات، برنامه (Claude Desktop، Cursor و…) را کامل ببندید و دوباره باز کنید.

نکات مخصوص ایران

سرویس‌های ایرانی و فیلترشکن

بعضی سرویس‌های ایرانی به درخواست‌هایی که از IP خارج از ایران می‌آیند جواب نمی‌دهند. اگر فیلترشکن (VPN یا پراکسی) روشن است و سرور MCP خطای اتصال یا ۴۰۳ می‌دهد، سایت‌های ایرانی را در برنامه فیلترشکن «مستقیم» کنید (split tunneling). در v2ray و برنامه‌های مشابه، قانون geoip:ir یا فهرست آماده دامنه‌های ایرانی را در بخش Direct بگذارید. ابزارهایی که فقط با IP ایران کار می‌کنند، در صفحه‌شان برچسب «فقط از IP ایران» دارند.

سرویس‌های خارجی و پراکسی

برعکس، سرورهایی که به سرویس خارجی وصل می‌شوند ممکن است از ایران باز نشوند. در این حالت، متغیر HTTPS_PROXY را در بخش env تنظیمات همان سرور بگذارید:

"env": {
  "HTTPS_PROXY": "http://127.0.0.1:10809",
  "NODE_USE_ENV_PROXY": "1"
}

کتابخانه‌های پایتون مثل requests و httpx این متغیر را خودشان می‌خوانند. Node.js فقط وقتی از آن استفاده می‌کند که NODE_USE_ENV_PROXY=1 هم تنظیم شده باشد (در نسخه‌های جدید Node). عدد پورت را با پورت پراکسی خودتان عوض کنید.

دانلود بسته‌ها

اگر npx موقع دانلود بسته گیر می‌کند، پراکسی npm را با این دو دستور تنظیم کنید:npm config set proxy http://127.0.0.1:10809 و npm config set https-proxy http://127.0.0.1:10809. Docker Hub به IPهای ایران جواب نمی‌دهد. برای سرورهایی که با Docker اجرا می‌شوند، از پراکسی یا یک mirror (نسخه آینه) استفاده کنید.

APIهای غیررسمی

دیجی‌کالا و دیوار برای این کار راه رسمی (API عمومی مستند) ندارند. سرورهای ما از همان نشانی‌هایی استفاده می‌کنند که وب‌سایت خودشان استفاده می‌کند، و این نشانی‌ها ممکن است بی‌خبر تغییر کنند. این سرورها را برای کار شخصی و آزمایشی به کار ببرید، درخواست انبوه نفرستید و قوانین استفاده هر سرویس را رعایت کنید.

امنیت

• سرور MCP برنامه‌ای است که روی کامپیوتر شما و با همان دسترسی‌های شما اجرا می‌شود. فقط ابزاری را نصب کنید که کدش را دیده‌اید یا به سازنده‌اش اعتماد دارید.
• کلید API (رمزی که سرویس به شما می‌دهد) را در فایلی که در گیت ثبت (commit) می‌شود نگذارید. تنظیماتی که این سایت برای VS Code می‌سازد کلیدها را در فایل نمی‌نویسد؛ VS Code موقع اجرا آن‌ها را از شما می‌پرسد.
• کلیدهایی که در صفحه ابزارها وارد می‌کنید فقط در مرورگر خودتان داخل دستور قرار می‌گیرند و به جایی فرستاده نمی‌شوند.
• برای ابزارهایی که پول جابه‌جا می‌کنند یا پیامک می‌فرستند، از کلید آزمایشی (sandbox) شروع کنید.

برای سازندگان

ساده‌ترین راه ساخت سرور MCP، کیت‌های رسمی TypeScript و Python است.

1. سرور را در npm یا PyPI منتشر کنید تا با npx یا uvx نصب شود.
2. توضیح ابزارها را برای مدل دقیق و به انگلیسی بنویسید، ولی ورودی فارسی را هم بپذیرید.
3. در صفحه ثبت ابزار مشخصات را وارد کنید و فایل آماده‌شده را بفرستید.

API فهرست

کل فهرست به صورت JSON در /api/catalog.json در دسترس است. این فایل نام، خلاصه، دسته، ابزارها، تنظیمات نصب و توضیحات هر ابزار را دارد و با هر بار ساخت سایت به‌روز می‌شود. می‌توانید از آن برای ساخت افزونه یا برنامه خودتان استفاده کنید.

const res = await fetch('{SITE}/api/catalog.json');
const { items } = await res.json();
const persian = items.filter((i) => i.category === 'language');