راهنمای استفاده از MCP Server باسلام

MCP Server چیست؟

MCP (Model Context Protocol) Server باسلام به شما امکان می‌دهد تا از طریق دستیارهای هوش مصنوعی مانند Claude Desktop، Cursor، Claude Terminal و ...، مستقیماً به سرویس‌ها و ریسورس‌های باسلام دسترسی پیدا کنید. با این ابزار نه‌تنها می‌توانید سوالات خود را درباره APIها، SDKها و مستندات باسلام مطرح کنید، بلکه درخواست‌های عملی مثل ثبت یا ویرایش محصول، دریافت اطلاعات غرفه، جست‌وجوی محصولات، بررسی سفارش‌ها و بسیاری عملیات دیگر را هم انجام دهید. AI به‌صورت خودکار این درخواست‌ها را پردازش کرده و پاسخ یا نتیجه موردنظر را از سرویس‌های باسلام برای شما آماده می‌کند.

آدرس سرور: mcp.basalam.com/mcp

اتصال در Cursor AI

گام ۱: اضافه کردن سرور MCP باسلام

• به Settings برنامه رفته و از منوی سمت چپ Tools & Integrations را انتخاب کنید.
• بخش MCP Tools را پیدا کنید.
• روی New MCP Server کلیک کنید.

گام ۲: پیکربندی سرور

در فایل mcp.json باز شده، کانفیگ زیر را وارد کنید:

{
  "mcpServers": {
    "basalam-mcp": {
      "url": "https://mcp.basalam.com/mcp/"
    }
  }
}

گام ۳: تست و ذخیره

پس از ذخیره کانفیگ، لیست ابزارهای موجود در سرور MCP باسلام، نمایش داده می‌شود.

اتصال در Claude Code (Terminal)

گام ۱: اضافه کردن سرور MCP باسلام

برای اضافه کردن سرور MCP باسلام به Claude Code، دستور زیر را اجرا کنید:

claude mcp add --transport http basalam-mcp https://mcp.basalam.com/mcp/

• --transport http : به Claude می‌گوید که این یک سرور MCP مبتنی بر HTTP است.
• basalam-mcp: نام سرور که در کانفیگ ذخیره می‌شود.(می‌توانید هر نامی انتخاب کنید).
• https://mcp.basalam.com/mcp/: آدرس سرور

گام ۲: بررسی اتصال

برای اطمینان از اضافه شدن سرور، می‌توانید لیست سرورهای MCP را مشاهده کنید:

claude mcp list

گام ۳: استفاده از سرور

حالا می‌توانید در Claude Code از دستورات و ابزارهای باسلام استفاده کنید. کافی است Claude Code را اجرا کرده و سوالات یا درخواست‌های خود را مطرح کنید:

claude How do I install the Basalam Python SDK?

محدودیت توکن‌های خروجی Claude

هنگام استفاده از سرور MCP باسلام، توجه داشته باشید که Claude محدودیت‌هایی در تعداد توکن‌های خروجی دارد:

• حداکثر توکن خروجی در هر پاسخ: 25,000 توکن (معادل تقریباً 18,000 کلمه فارسی یا 20,000 کلمه انگلیسی)
• اگر محتوای درخواستی از API باسلام بیش از این حد باشد، Claude خطای exceeds maximum allowed tokens نمایش می‌دهد.

برای اطلاعات بیشتر به این سند (opens in a new tab) مراجعه کنید.