رایبان CRM

MCP · Model Context Protocol

راهنمای اتصال رایبان CRM به ChatGPT، Claude، Grok و Cursor (MCP)

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

MCP چیست؟

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

سرور MCP رایبان داخل خود رایبان اجرا می‌شود و چیزی نصب نمی‌کنید. هر توکن فقط به داده‌های همان میزکار دسترسی دارد و می‌تواند فقط‌خواندنی یا خواندن‌ونوشتنی باشد.

نشانی سرور: https://raybancrm.ir/api/mcp · انتقال Streamable HTTP · احراز هویت با هدر Authorization: Bearer

شروع در ۴ قدم

  1. در میزکار از منوی «اتصال به هوش مصنوعی» (فقط مالک و مدیر میزکار) یک توکن بسازید. برای شروع «فقط خواندن» را انتخاب کنید.
  2. توکن فقط یک بار نمایش داده می‌شود. همان‌جا تنظیمات آماده هر برنامه با توکن شما نمایش داده می‌شود؛ آن را کپی کنید.
  3. تنظیمات را در برنامه هوش مصنوعی خود وارد کنید (راهنمای هر برنامه پایین‌تر است) و یک گفتگوی تازه باز کنید.
  4. بپرسید «ابزارهای رایبان را فهرست کن» یا یکی از نمونه درخواست‌ها را امتحان کنید.

راه‌اندازی

اتصال هر برنامه، قدم‌به‌قدم

نام منوها در نسخه‌های جدید برنامه‌ها ممکن است کمی فرق کند؛ مسیر کلی همین است.

Claude Desktop

  1. Node.js نسخه ۱۸ یا بالاتر را نصب کنید (برای پل mcp-remote لازم است).
  2. در Claude Desktop به Settings ← Developer ← Edit Config بروید تا فایل claude_desktop_config.json باز شود.
  3. تنظیمات زیر را در آن بگذارید و به جای YOUR_TOKEN توکن خود را بنویسید.
  4. Claude Desktop را کامل ببندید و دوباره باز کنید؛ ابزارهای raybancrm در فهرست ابزارها دیده می‌شوند.
{
  "mcpServers": {
    "raybancrm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://raybancrm.ir/api/mcp",
        "--header",
        "Authorization:${RAYBAN_AUTH}"
      ],
      "env": {
        "RAYBAN_AUTH": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude.ai (Connectors)

  1. در Claude به Settings ← Connectors بروید و «Add custom connector» را بزنید (این امکان به پلن حساب Claude شما بستگی دارد).
  2. یک نام مثل «رایبان» بنویسید و نشانی زیر را که توکن در آن است وارد کنید؛ احراز هویت لازم نیست.
  3. در گفتگو از دکمه + یا منوی ابزارها، کانکتور رایبان را فعال کنید.
https://raybancrm.ir/api/mcp/YOUR_TOKEN

Claude Code

  1. در ترمینال دستور زیر را اجرا کنید.
  2. با claude mcp list یا دستور ‎/mcp‎ داخل Claude Code اتصال را بررسی کنید.
claude mcp add --transport http raybancrm https://raybancrm.ir/api/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor

  1. فایل ‎~/.cursor/mcp.json‎ (برای همه پروژه‌ها) یا ‎.cursor/mcp.json‎ (فقط یک پروژه) را باز یا ایجاد کنید.
  2. تنظیمات زیر را بگذارید و توکن را جایگزین کنید.
  3. در تنظیمات Cursor بخش MCP، سرور raybancrm باید سبز و فعال باشد؛ Agent هر وقت لازم باشد ابزارها را صدا می‌زند.
{
  "mcpServers": {
    "raybancrm": {
      "url": "https://raybancrm.ir/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

ChatGPT

  1. در ChatGPT وب به Settings ← Apps (یا Connectors) ← Advanced بروید و Developer mode را روشن کنید. این امکان به پلن حساب ChatGPT بستگی دارد و در حساب‌های سازمانی باید مدیر آن را فعال کرده باشد.
  2. «Create» یا + را بزنید، نام «رایبان» بنویسید و در MCP Server URL نشانی زیر را بگذارید.
  3. Authentication را روی «No authentication» بگذارید (توکن داخل نشانی است) و ذخیره کنید.
  4. در گفتگوی تازه، از منوی + یا با تایپ @ اتصال رایبان را انتخاب کنید. ChatGPT پیش از اجرای ابزارهای نوشتن از شما تأیید می‌گیرد.
https://raybancrm.ir/api/mcp/YOUR_TOKEN

گروک بات (Grok Bot)

  1. توکن را در «اتصال به هوش مصنوعی» بسازید و نشانی دارای توکن زیر را کپی کنید.
  2. از گروک بات بخواهید این سرور MCP را اضافه کند؛ مثلاً بنویسید: «این سرور MCP را با نام رایبان اضافه کن» و نشانی را بفرستید. اگر گروک بات هدر جداگانه بپذیرد، می‌توانید نشانی ‎/api/mcp‎ را با هدر Authorization: Bearer و توکن بدهید.
  3. بعد بپرسید: «مشتری‌های امروزم رو نشون بده» یا «خلاصه فروش این ماه را بگو».
https://raybancrm.ir/api/mcp/YOUR_TOKEN

# یا با هدر:
URL: https://raybancrm.ir/api/mcp
Authorization: Bearer YOUR_TOKEN

Grok (grok.com و اپ Grok)

  1. در grok.com به صفحه grok.com/connectors بروید (در اپ موبایل: Settings ← Connectors).
  2. «New Connector» و سپس «Custom» را بزنید و نشانی دارای توکن زیر را به‌عنوان MCP server URL وارد کنید.
  3. Grok ابزارهای رایبان را خودش پیدا می‌کند. در حساب‌های Grok Business یا Enterprise، مدیر تیم باید اول کانکتور را در console.x.ai (Grok Business ← Connectors ← Add Connector ← Other) اضافه کند.
https://raybancrm.ir/api/mcp/YOUR_TOKEN

xAI API (Grok برای برنامه‌نویسان)

  1. در API شرکت xAI (Responses API یا xai-sdk)، سرور رایبان را به‌عنوان ابزار mcp با server_url و authorization تعریف کنید؛ xAI توکن را در هدر Authorization به سرور رایبان می‌فرستد.
  2. با allowed_tools می‌توانید فقط ابزارهای خواندنی را مجاز کنید. کلید XAI_API_KEY را از console.x.ai بگیرید.
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [{"role": "user", "content": "خلاصه فروش این ماه را بگو"}],
  "tools": [{
    "type": "mcp",
    "server_url": "https://raybancrm.ir/api/mcp",
    "server_label": "raybancrm",
    "authorization": "YOUR_TOKEN"
  }]
}'

برنامه‌های دیگر

  1. هر برنامه‌ای که از Remote MCP با انتقال Streamable HTTP پشتیبانی کند وصل می‌شود (مثلاً Windsurf، VS Code، Codex یا Responses API شرکت OpenAI).
  2. نشانی سرور را وارد کنید و هدر Authorization را با مقدار Bearer و توکن بفرستید. اگر برنامه فقط نشانی می‌گیرد، نشانی دارای توکن را بدهید.
URL: https://raybancrm.ir/api/mcp
Header: Authorization: Bearer YOUR_TOKEN

ابزارها

15 ابزار رایبان برای دستیار

ابزارهای نوشتن فقط با توکن «خواندن و نوشتن» اجرا می‌شوند.
  • جستجوی مشتریخواندن
    search_customers

    جستجو با نام، شرکت، شماره یا برچسب.

  • پرونده مشتریخواندن
    get_customer

    اطلاعات مشتری با فرصت‌ها، پیگیری‌های باز و تیکت‌های اخیرش.

  • فهرست فرصت‌های فروشخواندن
    list_deals

    فرصت‌ها با فیلتر مشتری یا مرحله.

  • فهرست پیگیری‌هاخواندن
    list_follow_ups

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

  • فهرست تیکت‌هاخواندن
    list_tickets

    تیکت‌های پشتیبانی با وضعیت و اولویت؛ یادداشت داخلی برگردانده نمی‌شود.

  • فهرست قراردادهاخواندن
    list_contracts

    قراردادهای فروش با تاریخ پایان و مبلغ، مثلاً قراردادهای نزدیک به تمدید.

  • امتیاز باشگاه مشتریانخواندن
    get_loyalty_points

    امتیاز و سطح یک مشتری در باشگاه مشتریان (پلن نقره‌ای و طلایی).

  • خلاصه فروشخواندن
    sales_summary

    تعداد و مبلغ فرصت‌ها در هر مرحله، موفق و ناموفق، قیف باز، پیش‌فاکتورها و پیگیری‌های باز.

  • ثبت مشترینوشتن
    create_customer

    مشتری تازه؛ اگر شماره تکراری باشد همان مشتری موجود برمی‌گردد.

  • ویرایش مشترینوشتن
    update_customer

    تغییر نام، شماره، شرکت، یادداشت، منبع یا برچسب.

  • ثبت فرصت فروشنوشتن
    create_deal

    فرصت تازه برای یک مشتری با مبلغ به تومان.

  • تغییر مرحله فرصتنوشتن
    move_deal_stage

    بردن فرصت به مرحله بعد، موفق یا ناموفق (با دلیل).

  • ثبت پیگیرینوشتن
    create_follow_up

    پیگیری یا کار تازه برای یک مشتری با تاریخ سررسید.

  • صدور پیش‌فاکتورنوشتن
    create_pre_invoice

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

  • ثبت تیکت پشتیبانینوشتن
    create_ticket

    تیکت تازه برای مشتری؛ متن به‌صورت یادداشت داخلی ثبت می‌شود.

نمونه

چه چیزهایی بپرسم؟

  • «کدام مشتری‌ها پیگیری عقب‌افتاده دارند؟ فهرستشان را با تاریخ بده.»
  • «خلاصه فروش این ماه را بگو: چند فرصت باز داریم و مبلغ کل قیف چقدر است؟»
  • «مشتری «سارا محمدی» را پیدا کن و بگو آخرین فرصت و تیکتش در چه وضعیتی است.»
  • «برای شرکت نوآوران یک پیش‌فاکتور با ۲ ردیف «نصب» به قیمت ۱٬۵۰۰٬۰۰۰ تومان و ۱۰٪ مالیات بساز.»
  • «فرصت «نصب سامانه انبار» را به مرحله پیش‌فاکتور ببر و برای سه‌شنبه آینده پیگیری تماس بگذار.»
  • «قراردادهایی که تا ۳۰ روز آینده تمام می‌شوند را نشان بده.»

نکات امنیتی

  • هر توکن فقط به داده‌های یک میزکار دسترسی دارد؛ ما فقط اثر SHA-256 توکن را نگه می‌داریم و خود توکن یک بار نمایش داده می‌شود.
  • تا وقتی لازم نیست، توکن «فقط خواندن» بدهید. توکن فقط‌خواندنی هیچ ابزار ثبت یا ویرایشی را اجرا نمی‌کند. ابزار حذف هم وجود ندارد.
  • نشانی دارای توکن (برای ChatGPT و Claude.ai) مثل رمز عبور است؛ آن را جایی منتشر نکنید. اگر لو رفت، توکن را در همان صفحه باطل کنید؛ اثرش فوری است.
  • سقف هر توکن ۱۲۰ درخواست و ۶۰ فراخوانی ابزار در دقیقه است. نام ابزار، زمان و موفق یا ناموفق بودن هر فراخوانی ۹۰ روز در «آخرین فراخوانی‌ها» دیده می‌شود؛ ورودی و خروجی ابزارها ذخیره نمی‌شود.
  • اطلاعاتی که دستیار می‌خواند به سرویس هوش مصنوعی همان شرکت (OpenAI، Anthropic، xAI یا Cursor) فرستاده می‌شود و طبق سیاست حریم خصوصی همان شرکت پردازش می‌شود. پیش از اتصال، سیاست آن سرویس را بخوانید.
  • دستیار ممکن است اشتباه کند یا متن یک صفحه یا پیام او را فریب دهد. پیش از تأیید ثبت یا تغییر، درخواست دستیار را بخوانید.
  • اگر سازنده توکن از میزکار حذف یا مسدود شود، یا میزکار معلق شود، توکن‌هایش دیگر کار نمی‌کنند.

برای اتصال برنامه‌نویسی بدون هوش مصنوعی، REST API و وب‌هوک را ببینید.

سوالات اتصال به هوش مصنوعی

برای اتصال به MCP کدام پلن رایبان لازم است؟+

سرور MCP در همه پلن‌ها و در ۳۰ روز آزمایش رایگان فعال است. ابزار امتیاز باشگاه مشتریان فقط در پلن‌هایی دیده می‌شود که باشگاه مشتریان دارند (نقره‌ای و طلایی).

آیا دستیار می‌تواند اطلاعات را پاک کند؟+

نه. هیچ ابزار حذفی وجود ندارد و توکن فقط‌خواندنی اجازه ثبت یا ویرایش هم ندارد.

آیا یک توکن به همه میزکارهای من دسترسی دارد؟+

نه. هر توکن به یک میزکار بسته است. اگر در چند میزکار عضو هستید، برای هر کدام جدا توکن بسازید.

اتصال قطع شد یا ابزارها دیده نمی‌شوند، چه کنم؟+

بررسی کنید توکن باطل نشده باشد و نشانی دقیقاً همانی باشد که در صفحه «اتصال به هوش مصنوعی» آمده است. بعد برنامه را کامل ببندید و دوباره باز کنید. خطای ۴۰۱ یعنی توکن نامعتبر و ۴۲۹ یعنی سقف درخواست پر شده است.

مبالغ و تاریخ‌ها به چه شکل است؟+

مبالغ به تومان و تاریخ‌ها در ابزارها میلادی (YYYY-MM-DD) است؛ دستیار می‌تواند آن‌ها را برایتان شمسی کند. میزکار همان تاریخ‌ها را شمسی نشان می‌دهد.