سرور MCP کلودی

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

آدرس سرور MCP:

https://mcp.kloude.ir

MCP چیست؟

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

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

پیش‌نیازها

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

Claude Desktop روی سیستم شما نصب شده باشد
یک کلید API کلودی معتبر (در تنظیمات ← کلیدهای API ایجاد کنید)
دسترسی به فایل پیکربندی Claude Desktop

کلید API مورد نیاز است:

برای احراز هویت با سرور MCP باید یک کلید API معتبر کلودی داشته باشید. کلید API خود را امن نگه دارید و هرگز به صورت عمومی به اشتراک نگذارید.

پیکربندی

برای اتصال Claude Desktop به سرور MCP کلودی، پیکربندی زیر را به تنظیمات Claude Desktop اضافه کنید:

پیکربندی Claude Desktop

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

مکان پیکربندی:

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

{YOUR_API_KEY} را با کلید API واقعی کلودی خود از پنل تنظیمات جایگزین کنید.

Claude Code CLI

اگر از Claude Code CLI استفاده می‌کنید، می‌توانید مستقیماً از خط فرمان به سرور MCP کلودی متصل شوید:

# اضافه کردن سرور MCP کلودی
claude mcp add --transport http kloude https://mcp.kloude.ir --header "X-API-KEY: {api-key}"

# تأیید اتصال
claude mcp list

{api-key} را با کلید API واقعی کلودی خود جایگزین کنید. CLI به طور خودکار سرور MCP را برای شما پیکربندی می‌کند.

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

پیکربندی زیر به صورت جهانی در تمام عوامل هوش مصنوعی سازگار با MCP از جمله Cursor، Codex، Claude، OpenCode و سایر ابزارهای توسعه هوش مصنوعی کار می‌کند:

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

{YOUR_API_KEY} را با کلید API واقعی کلودی خود از پنل تنظیمات جایگزین کنید.

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

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 بررسی کنید.

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

ایجاد کلید API

به تنظیمات ← کلیدهای API در داشبورد کلودی خود بروید و یک کلید API جدید ایجاد کنید. کلید را فوراً کپی کنید زیرا دوباره نمایش داده نخواهد شد.

یافتن فایل پیکربندی

فایل پیکربندی Claude Desktop را بر اساس سیستم عامل خود پیدا کنید (مسیرهای بالا را ببینید). اگر فایل وجود ندارد، آن را ایجاد کنید.

افزودن پیکربندی سرور MCP

فایل پیکربندی را در یک ویرایشگر متن باز کنید و پیکربندی سرور MCP کلودی را اضافه کنید. {YOUR_API_KEY} را با کلید API واقعی خود جایگزین کنید.

راه‌اندازی مجدد Claude Desktop

Claude Desktop را ببندید و دوباره راه‌اندازی کنید تا پیکربندی سرور MCP جدید بارگذاری شود.

تأیید اتصال

یک مکالمه جدید در Claude Desktop شروع کنید و یک دستور ساده مانند "لیست سرورهای کلودی من را بررسی کن" را امتحان کنید تا اتصال را تأیید کنید.

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

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

مدیریت سرور

PROMPT: check my kloude servers list

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

PROMPT: show details of server {server-name}

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

PROMPT: what clusters are running in my kloude account?

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

جستجوی منابع

PROMPT: show my disk usage across all servers

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

PROMPT: list all networking resources

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

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

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

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

مجوزها:

دسترسی سرور MCP تابع همان مجوزهای کلید API شما است. اطمینان حاصل کنید که کلید API شما دامنه‌های لازم برای عملیاتی که می‌خواهید انجام دهید را دارد.

عیب‌یابی

مشکلات اتصال

اگر Claude Desktop نمی‌تواند به سرور MCP متصل شود:

تأیید کلید API: اطمینان حاصل کنید که کلید API شما معتبر است و در تنظیمات منقضی نشده است
بررسی پیکربندی: تأیید کنید که نحو فایل پیکربندی صحیح است (JSON معتبر)
راه‌اندازی مجدد Claude: Claude Desktop را به طور کامل ببندید و دوباره راه‌اندازی کنید
دسترسی شبکه: اطمینان حاصل کنید که https://mcp.kloude.ir از شبکه شما قابل دسترسی است

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

اگر خطاهای احراز هویت دریافت می‌کنید:

تأیید کنید که کلید API در پیکربندی شما با کلید کلودی مطابقت دارد
بررسی کنید که کلید API شما لغو نشده باشد
تأیید کنید که هدر X-API-KEY به درستی قالب‌بندی شده است

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

اگر دستورات هیچ نتیجه‌ای برنمی‌گردانند:

اطمینان حاصل کنید که منابعی در حساب کلودی خود ایجاد کرده‌اید
بررسی کنید که کلید API شما مجوزهای صحیح را دارد
ابتدا یک جستجوی ساده مانند "لیست سرورهای کلودی من را بررسی کن" را امتحان کنید

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

امنیت کلید API:

کلید API شما دسترسی کامل به حساب کلودی شما را فراهم می‌کند. این شیوه‌های امنیتی را دنبال کنید:

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

منابع مرتبط

مرجع API - دسترسی مستقیم API برای یکپارچه‌سازی برنامه‌ای
تنظیمات - مدیریت کلیدهای API و دسترسی سازمان
شروع کار - راه‌اندازی اولیه و عملیات پایه
بهترین شیوه‌های امنیتی - راهنمای امنیت حساب

پشتیبانی

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

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

پروتکل Model Context:

درباره پروتکل Model Context بیشتر بیاموزید در modelcontextprotocol.io

پشتیبانی