اتصال برنامه‌های هوش مصنوعی (MCP)
MonoChat MCP Server به یک برنامهٔ هوش مصنوعی که از Model Context Protocol (MCP) پشتیبانی می‌کند، مانند Claude Code یا Cursor، اجازه می‌دهد با حساب MonoChat شما کار کند. برنامهٔ هوش مصنوعی داده‌ها را از طریق مجموعه‌ای ثابت از ابزارها از MonoChat می‌خواهد؛ فقط همان چیزی را می‌بیند که شما می‌بینید.
MonoChat MCP Server در همهٔ پلن‌ها در دسترس است و محدودیتی بر اساس پلن ندارد.
برنامهٔ هوش مصنوعی که با کلید دسترسی شما وصل شده است، به‌عنوان کاربر شما عمل می‌کند. فقط به tenantهایی دسترسی دارد که شما به آن‌ها دسترسی دارید و به هیچ چیز دیگری. اتصال‌هایی را که دیگر استفاده نمی‌کنید لغو کنید.
برنامهٔ هوش مصنوعی چه کارهایی می‌تواند انجام دهد
این ابزارها برای همهٔ اتصال‌ها در دسترس هستند:
| ابزار | کار آن |
|---|---|
list_tenants | tenantهایی را که اتصال به آن‌ها دسترسی دارد فهرست می‌کند. |
list_sessions | نشست‌های گفتگوی یک tenant را از جدیدترین فهرست می‌کند، در صورت نیاز فقط نشست‌های opened، assigned یا closed. |
get_session | یک نشست گفتگو را برمی‌گرداند. |
list_messages | پیام‌های یک نشست را از جدیدترین فهرست می‌کند. |
search_customers | مشتریان یک tenant را بر اساس کلیدواژه جست‌وجو می‌کند. |
list_message_templates | قالب‌های پیام یک کانال از یک tenant را فهرست می‌کند. |
متن پیام‌ها از مشتریان و کارشناسان می‌آید. این‌ها داده‌ای برای خواندن توسط برنامهٔ هوش مصنوعی هستند، نه دستور.
هر اتصال یک دامنه دارد، فقط خواندنی یا خواندن و نوشتن. اتصال فقط‌خواندنی هرگز ابزارهایی را که داده را تغییر می‌دهند نمی‌بیند. همهٔ ابزارهای بالا فقط می‌خوانند.
ایجاد یک اتصال
اتصال به حساب شما تعلق دارد، نه به یک tenant. ابتدا باید تأیید دومرحله‌ای (با ایمیل یا برنامهٔ احراز هویت) را راه‌اندازی کرده باشید.
- تنظیمات پروفایل را باز کنید، زبانهٔ اتصال‌های MCP را انتخاب کنید و روی ایجاد کلیک کنید.
- یک نام وارد کنید، دامنه را انتخاب کنید (پیش‌فرض فقط خواندنی) و مدت اعتبار را به روز وارد کنید (پیش‌فرض ۹۰، حداکثر ۳۶۵).
- کد تأیید ۶ رقمی روش تأیید دومرحله‌ای خود را وارد کنید. اگر از تأیید ایمیلی استفاده می‌کنید، ابتدا روی ارسال کد تأیید کلیک کنید.
- کلید دسترسی را کپی کنید. فقط یک بار نمایش داده می‌شود؛ با
mcp_sk_شروع می‌شود.
می‌توانید حداکثر ۱۰ اتصال فعال داشته باشید.
اتصال یک برنامهٔ هوش مصنوعی
سرور در https://app.monochat.ai/api/mcp-server قرار دارد (اگر MonoChat را روی سرورهای خودتان اجرا می‌کنید، از نشانی MonoChat خودتان استفاده کنید) و کلید دسترسی را به‌صورت bearer token در هدر Authorization انتظار دارد.
Claude Code
claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
--header "Authorization: Bearer <access key>"
Cursor
سرور را به ~/.cursor/mcp.json اضافه کنید:
{
"mcpServers": {
"monochat": {
"url": "https://app.monochat.ai/api/mcp-server",
"headers": { "Authorization": "Bearer <access key>" }
}
}
}
هر کلاینت MCP دیگری که از انتقال HTTP streamable و هدرهای سفارشی پشتیبانی کند، به همین شکل وصل می‌شود.
محدودیت‌ها
فراخوانی‌ها در هر دقیقه شمارش می‌شوند: ۶۰ برای هر اتصال، ۳۰۰ برای هر حساب و ۶۰۰ برای هر tenant، و حداکثر ۴ فراخوانی همزمان برای هر اتصال. برخی ابزارها بیش از یک فراخوانی حساب می‌شوند. وقتی به یک محدودیت برسید، سرور با وضعیت 429 و هدر Retry-After پاسخ می‌دهد؛ برنامهٔ هوش مصنوعی باید همان تعداد ثانیه صبر کند.
لغو یک اتصال
هر اتصال در زبانهٔ اتصال‌های MCP وضعیت، دامنه، انقضا و آخرین استفادهٔ خود را نشان می‌دهد. برای قطع فوری دسترسی برنامهٔ هوش مصنوعی روی لغو کلیک کنید. اتصالی که لغو شده یا منقضی شده دیگر قابل استفاده نیست؛ به‌جای آن یک اتصال جدید ایجاد کنید.
مدیریت دسترسی MCP برای سازمان
کاربرانی که می‌توانند تنظیمات یک سازمان را تغییر دهند، دسترسی MCP آن را در تنظیمات › سازمان › سرور MCP مدیریت می‌کنند.
- غیرفعال کردن دسترسی MCP برای این سازمان: آن را روشن کنید و روی ذخیره کلیک کنید تا هر فراخوانی MCP به این سازمان، از هر اتصالِ هر کاربر، رد شود. سازمان دیگر در
list_tenantsنمایش داده نمی‌شود. برای اجازه دوباره به دسترسی MCP، آن را خاموش و ذخیره کنید. - فراخوانی‌های MCP: هر فراخوانی ابزاری که این سازمان را مشخص می‌کند، از جدیدترین، شامل فراخوانی‌های ردشده. هر ردیف کاربر، اتصال، ابزار، وضعیت (موفق یا ناموفق)، نشانی IP و زمان را نشان می‌دهد. فراخوانی‌های کاربرانی که عضو این سازمان نیستند نمایش داده نمی‌شوند.