راهنماها
در این صفحه

راهنمای محصول

سرور MCP کلودی

اتصال به زیرساخت کلودی با استفاده از پروتکل Model Context Protocol (MCP). مدیریت سرورها، کلاسترها و منابع به صورت مستقیم از Claude Desktop یا دیگر کلاینت‌های MCP.

سرور MCP کلودی امکان یکپارچه‌سازی یکپارچه بین Claude Desktop و زیرساخت کلودی شما را فراهم می‌کند. با استفاده از پروتکل Model Context Protocol (MCP)، می‌توانید سرورها را مدیریت کنید، منابع را جستجو کنید و عملیات را به صورت مستقیم از طریق مکالمات زبان طبیعی با Claude اجرا کنید.

MCP چیست؟

Model Context Protocol (MCP) یک پروتکل باز است که به دستیارهای هوش مصنوعی مانند Claude اجازه می‌دهد به صورت امن به منابع داده و ابزارهای خارجی متصل شوند. با اتصال Claude Desktop به سرور MCP کلودی، می‌توانید:

  • سرورها و منابع کلودی خود را جستجو کنید
  • وضعیت و پیکربندی کلاسترها را بررسی کنید
  • زیرساخت را از طریق زبان طبیعی مدیریت کنید
  • عملیات رایج را بدون خروج از مکالمه خود خودکار کنید

پیش‌نیازها

قبل از اتصال، اطمینان حاصل کنید که موارد زیر را دارید:

  1. یک کلاینت MCP با پشتیبانی از HTTP و OAuth (مثل Cursor، Claude Desktop، Claude Code)
  2. حساب کلودی که بتوانید در پنل وارد آن شوید

تأیید اول فقط‌خواندنی (پرسش) برای سازمانی است که انتخاب می‌کنید. «تغییر» را فقط وقتی بدهید که آن کلاینت باید راه‌اندازی دوباره، حذف، یا اعمال تغییر انجام دهد. توکن روی همان سازمان می‌ماند. Terraform و CI همچنان از کلید API در تنظیمات ← کلیدهای API استفاده می‌کنند. باز کردن خود آدرس MCP در مرورگر شما را به ورود پنل می‌برد.

پیکربندی

فقط آدرس MCP را بگذارید. برای کلاینت تعاملی هدر API key نگذارید.

Cursor

json
{ "mcpServers": { "kloude": { "url": "https://mcp.kloude.ir" } } }

Claude Desktop

json
{ "mcpServers": { "kloude": { "url": "https://mcp.kloude.ir" } } }

مکان فایل Claude Desktop:

  • macOS: ~/.claude/settings.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.claude/settings.json

Claude Code CLI

bash
claude mcp add --transport http kloude https://mcp.kloude.ir claude mcp list

CLI خودش را ثبت می‌کند، پنل را برای تأیید باز می‌کند و توکن را نگه می‌دارد.

پیکربندی جهانی برای تمام عوامل هوش مصنوعی

json
{ "mcpServers": { "kloude": { "url": "https://mcp.kloude.ir" } } }

مکان فایل‌های پیکربندی:

  • Cursor IDE:

    • macOS/Linux: ~/.cursor/mcp.json
    • Windows: %APPDATA%\Cursor\mcp.json
  • VS Code (Cody):

    • macOS/Linux: ~/.config/Code/User/settings.json
    • Windows: %APPDATA%\Code\User\settings.json
  • Windsurf:

    • macOS/Linux: ~/.windsurf/mcp_config.json
    • Windows: %APPDATA%\Windsurf\mcp_config.json
  • سایر عوامل هوش مصنوعی: مستندات ابزار خود را برای مکان فایل پیکربندی MCP بررسی کنید.

راهنمای راه‌اندازی

افزودن آدرس MCP

فقط https://mcp.kloude.ir را در پیکربندی کلاینت بگذارید (نمونه‌های بالا). برای استفاده تعاملی هدر X-API-KEY اضافه نکنید.

اتصال سرور

کلاینت را دوباره بارگذاری کنید تا سرور MCP را ببیند. کلاینت متادیتای OAuth را پیدا می‌کند و صفحه تأیید پنل را باز می‌کند.

ورود و تأیید

در صورت نیاز وارد کلودی شوید، سازمان را انتخاب کنید، مگر اینکه به «تغییر» نیاز دارید همان «پرسش» را بگذارید، سپس Allow را بزنید.

بازگشت به کلاینت

مرورگر به کلاینت برمی‌گردد. در تنظیمات ← کلیدهای API، بخش برنامه‌های متصل این تأیید را نشان می‌دهد و بعداً می‌توانید قطعش کنید.

بررسی

چیزی مثل «لیست سرورهای کلودی من را بررسی کن» بپرسید. ابزارها روی سازمانی که تأیید کردید اجرا می‌شوند.

اتوماسیون (کلید API)

Terraform، اسکریپت و CI همچنان از کلید API در تنظیمات ← کلیدهای API استفاده می‌کنند:

json
{ "mcpServers": { "kloude": { "url": "https://mcp.kloude.ir", "headers": { "X-API-KEY": "{YOUR_API_KEY}" } } } }

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

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

پس از پیکربندی، می‌توانید با زیرساخت کلودی خود با استفاده از زبان طبیعی تعامل کنید. در اینجا چند نمونه دستور وجود دارد:

مدیریت سرور

text
PROMPT: check my kloude servers list

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

text
PROMPT: show details of server {server-name}

اطلاعات دقیق درباره یک سرور خاص را نمایش می‌دهد.

text
PROMPT: what clusters are running in my kloude account?

تمام کلاسترهای فعال و پیکربندی‌های آنها را نشان می‌دهد.

جستجوی منابع

text
PROMPT: show my disk usage across all servers

یک نمای کلی از استفاده از دیسک ارائه می‌دهد.

text
PROMPT: list all networking resources

VPCها، زیرشبکه‌ها و پیکربندی‌های شبکه را نمایش می‌دهد.

عملیات‌های موجود

سرور MCP کلودی دسترسی به منابع زیر را فراهم می‌کند:

  • سرورها: لیست، جستجو و مدیریت ماشین‌های مجازی
  • کلاسترها: مشاهده و مدیریت کلاسترهای Kubernetes
  • دیسک‌ها: بررسی حجم‌های ذخیره‌سازی و استفاده
  • شبکه: جستجوی VPCها، زیرشبکه‌ها و قوانین فایروال
  • مانیتورینگ: دسترسی به معیارها و استفاده از منابع
  • رجیستری: جستجوی تصاویر رجیستری کانتینر

عیب‌یابی

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

  1. تأیید کنید پیکربندی فقط "url": "https://mcp.kloude.ir" دارد و هدر API key خالی یا اشتباه ندارد.
  2. سرور MCP را در کلاینت دوباره بارگذاری کنید.
  3. https://mcp.kloude.ir/.well-known/oauth-authorization-server را باز کنید و وجود registration_endpoint و authorization_endpoint را ببینید.
  4. از شبکه خود به https://mcp.kloude.ir دسترسی داشته باشید.

خطاهای احراز هویت

  • تأیید پنل را تمام کنید و بعد از Allow به کلاینت برگردید.
  • در تنظیمات ← کلیدهای API بخش برنامه‌های متصل را ببینید؛ در صورت لغو، قطع کنید و دوباره وصل شوید.
  • برای پیکربندی اتوماسیون، معتبر بودن کلید API را بررسی کنید.

عدم پاسخ از سرور MCP

  • در سازمانی که تأیید کرده‌اید منبع داشته باشید.
  • تأیید فقط‌پرسش نمی‌تواند راه‌اندازی دوباره یا حذف کند؛ برای آن‌ها «تغییر» را تأیید کنید.
  • ابتدا یک جستجوی ساده مثل «لیست سرورهای کلودی من را بررسی کن» را امتحان کنید.

بهترین شیوه‌های امنیتی

  • هرگز commit نکنید فایل‌های پیکربندی با کلیدهای API را در کنترل نسخه
  • تناوب کلیدها به صورت منظم از پنل تنظیمات
  • از کمترین امتیاز استفاده کنید: کلیدهای API جداگانه برای موارد استفاده مختلف ایجاد کنید
  • فوراً لغو کنید اگر کلیدی به خطر افتاده است
  • به صورت امن ذخیره کنید: فایل‌های پیکربندی را با مجوزهای مناسب فایل نگه دارید

منابع مرتبط

پشتیبانی

برای کمک با سرور MCP نیاز دارید؟ از صفحه پشتیبانی ما بازدید کنید یا با تیم کلودی تماس بگیرید برای کمک با:

  • پیکربندی سرور MCP
  • تأیید پنل و برنامه‌های متصل
  • عیب‌یابی یکپارچه‌سازی
  • درخواست‌های ویژگی