تنظیم کلاینت‌ها برای MCP Server

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

هدر	توضیح
Arvancloud-Api-Key	برای احراز هویت درخواست‌های MCP استفاده می‌شود. مقدار آن به‌شکل <apikey <UUID ماشین یوزر است.
X-Mcp-Toolsets	مشخص می‌کند کدام Toolsetها فعال باشند. برای نمونه logs یا all یا فهرستی جدا شده با کاما مانند logs,cdn.

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

توجه داشته باشید که ماشین یوزری که برای MCP Server آروان‌کلاد ساخته‌اید باید دسترسی‌های لازم به محصولات موردنظرتان را داشته باشد، وگرنه MCP نمی‌تواند Toolهای آن سرویس را اجرا کند.

در حال حاضر فقط Toolset مربوط به Logs در دسترس است. فهرست کامل Toolsetها، کلید هر یک و وضعیت فعلی‌شان در راهنمای معرفی MCP Server آمده است.

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

https://mcp.arvancloud.ir

Cursor

فایل تنظیمات Cursor در سطح سراسری در مسیر cursor/mcp.json./~ و در سطح پروژه در مسیر cursor/mcp.json. قرار دارد.

{
  "mcpServers": {
    "arvancloud": {
      "url": "https://mcp.arvancloud.ir",
      "headers": {
        "Arvancloud-Api-Key": "apikey <your-machine-user-uuid>",
        "X-Mcp-Toolsets": "logs"
      }
    }
  }
}

پس از ذخیره، Cursor را دوباره بارگذاری کنید یا از بخش Settings گزینه‌ی MCP را انتخاب کنید تا وضعیت اتصال را ببینید. برای پروژه‌ای که فقط Logs لازم دارد، فایل cursor/mcp.json. را در روت repo قرار دهید تا اعضای تیم همان تنظیم را داشته باشند؛ در این حالت بهتر است UUID واقعی را commit نکنید و به‌جای آن از env یا secret manager استفاده کنید.

Claude Desktop و Claude CLI

فایل تنظیمات Claude Desktop در سطح پروژه در مسیر mcp.json. و در سطح کاربر در مسیر claude.json./~ قرار دارد.

{
  "mcpServers": {
    "arvancloud": {
      "type": "http",
      "url": "https://mcp.arvancloud.ir",
      "headers": {
        "Arvancloud-Api-Key": "apikey <your-machine-user-uuid>",
        "X-Mcp-Toolsets": "logs"
      }
    }
  }
}

برای Claude CLI می‌توانید به‌جای ویرایش فایل، از دستور زیر استفاده کنید:

claude mcp add --transport http arvancloud https://mcp.arvancloud.ir \
  --header "Arvancloud-Api-Key: apikey <your-machine-user-uuid>" \
  --header "X-Mcp-Toolsets: logs"

OpenCode

فایل تنظیمات OpenCode در سطح پروژه در مسیر opencode.json یا opencode.jsonc و در سطح سراسری در مسیر config/opencode/opencode.json./~ قرار دارد.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "arvancloud": {
      "type": "remote",
      "url": "https://mcp.arvancloud.ir",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Arvancloud-Api-Key": "apikey <your-machine-user-uuid>",
        "X-Mcp-Toolsets": "logs"
      }
    }
  }
}

سایر کلاینت‌ها

هر کلاینتی که از MCP over HTTP پشتیبانی کند، برای اتصال به MCP Server آروان‌کلاد باید آدرس سرور را تنظیم کند، هدرهای Arvancloud-Api-Key و X-Mcp-Toolsets را در هر درخواست MCP بفرستد و Toolset را متناسب با نیاز محدود کند. برای نمونه استفاده از logs به‌جای all امنیت بهتری فراهم می‌کند.

جدول زیر محل فایل تنظیمات هر یک از کلاینت‌های بالا را خلاصه می‌کند.

کلاینت	فایل در سطح پروژه	فایل Global
Cursor	cursor/mcp.json.	cursor/mcp.json./‍~
Claude	mcp.json.	claude.json./‍~
OpenCode	opencode.json	config/opencode/opencode.json./‍~