شروع سریع با MCP Server

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

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

توجه داشته باشید که ماشین یوزر باید دسترسی‌های لازم به سرویس‌های موردنظرتان را داشته باشد، وگرنه MCP نمی‌تواند Toolهای آن سرویس را اجرا کند. پس از ساخت ماشین یوزر، UUID کلید دسترسی را کپی کنید تا در تنظیمات MCP به‌شکل <apikey <UUID استفاده کنید.

انتخاب Toolset

Toolset مشخص می‌کند کدام ابزارها در کلاینت شما دیده می‌شوند و نام هر Toolset با نام سرویس مربوط به آن یکی است. در حال حاضر فقط Toolset مربوط به Logs دردسترس است، بنابراین برای شروع کافی است از مقدار زیر در هدر X-Mcp-Toolsets استفاده کنید.

X-Mcp-Toolsets: logs

وقتی سرویس‌های بیش‌تری به MCP Server اضافه شوند، می‌توانید چند Toolset را با کاما از هم جدا کنید، مثلن logs,cdn.

فهرست کامل Toolsetها و وضعیت هر یک در راهنمای معرفی MCP Server آمده است.

افزودن MCP Server در کلاینت

آدرس سرور و هدرهای لازم را در تنظیمات کلاینت هوش مصنوعی‌تان وارد کنید. برای نمونه، پیکربندی حداقلی در Cursor به شکل زیر است:

{
  "mcpServers": {
    "arvancloud": {
      "url": "https://mcp.arvancloud.ir",
      "headers": {
        "Arvancloud-Api-Key": "apikey YOUR-MACHINE-USER-UUID",
        "X-Mcp-Toolsets": "logs"
      }
    }
  }
}

جزییات پیکربندی هر کلاینت، از جمله Claude و OpenCode، در تنظیم کلاینت‌ها آمده است.

بررسی اتصال

پس از ذخیره‌ی تنظیمات و راه‌اندازی مجدد کلاینت، وضعیت MCP را در Cursor ،Claude یا OpenCode بررسی کنید. سرور arvancloud باید Connected باشد. سپس برای نمونه در چت بنویسید:

• لیست Spaceهای Logs من را نشان بده.

مدل باید ابزار logs_space_list را فراخوانی کند و نتیجه را خلاصه کند. اگر با خطای ۴۰۱ یا ۴۰۰ روبه‌رو شدید، وضعیت احراز هویت و Toolset انتخابی‌تان را در تنظیم کلاینت‌ها بررسی کنید.

نمونه استفاده

برای ساخت یک Space جدید می‌توانید بنویسید:

• یک Space به نام prod-logs در region ir-thr با retention ۳۰ روز بساز.

یا برای مسیریابی لاگ‌های یک دامنه به این Space می‌توانید بنویسید:

• لاگ‌های دامنه‌ی api.example.com را به Space prod-logs هدایت کن.

مدل می‌تواند برای این کار از پرامپت logs_route_domain_logs یا ابزارهای *_logs_space و *_logs_sink استفاده کند.

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