MCP Server آروان‌کلاد

با MCP Server آروان‌کلاد می‌توانید سرویس‌های آروان‌کلاد را به‌شکل مستقیم از طریق کلاینت‌های هوش مصنوعی مانند Cursor ،Claude و OpenCode مدیریت کنید. به‌جای وارد شدن به پنل کاربری برای هر کاری یا فراخوانی دستی APIهای مختلف، کافی است کاری را که می‌خواهید انجام دهید با زبان طبیعی برای دستیار هوش مصنوعی توضیح دهید. دستیار ابزار مناسب را از MCP Server پیدا می‌کند و درخواست شما را اجرا می‌کند.

برای نمونه می‌توانید به دستیارتان بگویید «یک Space جدید برای لاگ‌های سرویس پرداخت ایجاد کن» یا «Forwarder این Space را طوری تنظیم کن که لاگ‌ها را به Object Storage ارسال کند».

MCP یا Model Context Protocol استانداردی برای اتصال دستیارهای هوش مصنوعی به ابزارها و سرویس‌های خارجی است. در MCP Server آروان‌کلاد، قابلیت‌های سرویس‌های آروان‌کلاد به شکل ابزارهایی در اختیار دستیار قرار می‌گیرند، به همین دلیل به‌جای پیدا کردن API مناسب، ساختن درخواست، وارد کردن پارامترها، ارسال درخواست و بررسی پاسخ، کافی است درخواست خود را به زبان طبیعی بیان کنید تا دستیار این مراحل را برای‌تان انجام دهد.

پیش‌نیازها

برای استفاده از MCP Server آروان‌کلاد به یک کلید API، یک کلاینت سازگار با MCP و انتخاب Toolset نیاز دارید.

کلید API

برای اتصال به حساب آروان‌کلاد یک ماشین یوزر بسازید و کلید دسترسی آن را دریافت کنید.

راهنمای ماشین یوزر به شما در این مسیر کمک می‌کند.

این کلید برای احراز هویت درخواست‌های MCP استفاده می‌شود و در هدر Arvancloud-Api-Key قرار می‌گیرد.

توجه داشته باشید که کلید API شما امکان دسترسی به سرویس‌های آروان‌کلاد را فراهم می‌کند. آن را مانند رمز عبور در نظر بگیرید و در Git، فایل‌های عمومی یا پروژه‌های اشتراکی قرار ندهید. هم‌چنین باید تمام دسترسی‌های لازم به ماشین یوزر مورد نظر داده شود، چون اگر کلید دسترسی‌های لازم را نداشته باشد، MCP نمی‌تواند تمام Toolهای یک سرویس را اجرا کند.

کلاینت MCP

MCP Server آروان‌کلاد با کلاینت‌هایی کار می‌کند که از Streamable HTTP MCP پشتیبانی کنند، مانند:

• Cursor
• Claude Desktop یا Claude CLI
• OpenCode
• سایر کلاینت‌های سازگار با MCP

Toolset

Toolset مشخص می‌کند MCP Server به کدام سرویس‌های آروان‌کلاد دسترسی داشته باشد. برای انتخاب Toolset از هدر X-Mcp-Toolsets استفاده می‌شود. برای نمونه مقدار logs فقط Toolset مربوط به Logs را فعال می‌کند و مقدار all همه‌ی Toolsetهای موجود را فعال می‌کند.

جدول زیر کلید هر Toolset و وضعیت فعلی آن را نشان می‌دهد.

سرویس	کلید Toolset	وضعیت
شبکه توزیع محتوا	cdn	به زودی
سرور ابری	iaas	به زودی
کانتینر ابری	paas	به زودی
فضای ابری	objectstorage	به زودی
پلتفرم ویدیو	video	به زودی
پشتیبانی	supporting	به زودی
پردازش لبه	ec	به زودی
لاگ ابری	logs	در دسترس
سرویس هوش مصنوعی	aiaas	به زودی
دیتابیس ابری	dbaas	به زودی
شبکه ابری خصوصی	vpc	به زودی

آدرس MCP Server

آدرس MCP Server آروان‌کلاد به شکل زیر است:

https://mcp.arvancloud.ir

نکات امنیتی

MCP به دستیار اجازه می‌دهد روی سرویس‌های واقعی شما عملیات انجام دهد؛ بنابراین هنگام استفاده از آن باید همان احتیاطی را داشته باشید که هنگام استفاده مستقیم از پنل یا API دارید. عملیاتی مانند حذف Space، Sink یا Forwarder ممکن است برگشت‌پذیر نباشد، به همین دلیل پیش از حذف این منابع باید تایید صریح شما گرفته شود؛ اگر دستیار برای حذف یک منبع تایید خواست و مطمین نیستید، عملیات را تایید نکنید.

برای محافظت از کلید API:

• کلید را در Git commit نکنید.
• آن را در فایل‌های عمومی قرار ندهید.
• کلید را با افراد غیرمجاز به اشتراک نگذارید.
• برای محیط‌های مختلف، در صورت امکان کلید‌های جداگانه بسازید.
• فقط دسترسی‌های موردنیاز را در اختیار هر کلید قرار دهید.

استفاده از MCP Server

اگر می‌خواهید برای اولین ‌بار از MCP Server آروان‌کلاد استفاده می‌کنید، ابتدا به‌کمک راهنمای شروع سریع با آدرس سرور، کلید API و شیوه‌ی اولین اتصال آشنا شوید. سپس، اگر از Cursor ،Claude یا OpenCode استفاده می‌کنید، شیوه‌ی اتصال کلاینت هوش مصنوعی‌تان را در تنظیم کلاینت‌ها ببینید. در پایان، نمونه‌هایی از درخواست‌هایی که می‌توانید مستقیم در چت بنویسید را در راهنمای نمونه درخواست‌ها بررسی کنید.