سرور MCP

معرفی و قابلیت‌ها

سرور MCP داده‌لند رابطی دوگانه (هیبرید) برای اتصال مدل‌های هوش مصنوعی به این پلتفرم است. این سرور از دو بخش کلی تشکیل شده است:

• راهنماها و مستندات: هوش مصنوعی بدون نیاز به دسترسی فضا، به مستندات و استانداردهای رسمی داده‌لند دسترسی دارد.
• ابزارهای فضا: امکان تعامل مستقیم با داده‌ها و منابع یک فضای کاری را فراهم می‌سازد:
  • دریافت اطلاعات: دریافت متادیتای جداول، مشاهده نمونه داده‌ها، استخراج ساختار داشبوردها و استوری‌ها، بررسی فیلترهای فعال، و مشاهده مقاصد و فرآیندهای توزیع داده (Reverse ETL) امکان‌پذیر است.
  • انجام عملیات: امکان اجرای کوئری‌های تحلیلی (SELECT) و ایجاد دیتاست و جداول جدید فراهم شده است. انجام این عملیات‌ها وابسته به داشتن دسترسی مرتبط در فضای مورد نظر است.

دریافت توکن

برای اتصال کلاینت‌های هوش مصنوعی به سرور MCP، توکن اختصاصی خود را از مسیر حساب کاربری > مشخصات حساب دریافت کنید. اعتبار هر توکن ۹۰ روز است و با ایجاد توکن جدید، اعتبار توکن قبلی به صورت خودکار باطل می‌شود.

سطح دسترسی

توکن اولیه به صورت پیش‌فرض دسترسی به فایل‌های راهنما را فراهم می‌کند. برای استفاده از ابزارهای یک فضا، باید گزینه «دسترسی به سرور MCP» از مسیر مدیریت کاربران > دسترسی صفحات و قابلیت‌ها برای شما فعال گردد.

اتصال به کلاینت

قطعه‌کد زیر را در فایل تنظیمات کلاینت هوش مصنوعی خود (مانند Cursor، Claude Desktop یا Antigravity) قرار دهید و توکن اختصاصی خود را جایگزین <YOUR_TOKEN> نمایید:

{
  "mcpServers": {
    "dadeland": {
      "serverUrl": "https://api.dadeland.ir/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "dadeland": {
      "url": "https://api.dadeland.ir/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

کسر اعتبار و محدودیت‌ها

• کسر اعتبار: اجرای هر کوئری تحلیلی مشمول کسر اعتبار پردازشی از فضا است و فراخوانی سایر ابزارها اعتباری کسر نمی‌کند.
• سقف خروجی کوئری: حداکثر خروجی هر اجرای کوئری ۵۰ ردیف است.
• محدودیت دستورات: مشابه با صفحه کوئری در پنل، سرور MCP نیز تنها از دستورات خواندنی SELECT پشتیبانی می‌کند.