پرش به مطلب اصلی

کلاینت‌های MCP

Model Context Protocol (MCP) یک استاندارد باز برای ارائه ابزارها به مدل‌های AI است. بسیاری از سرویس‌ها یک سرور MCP دارند و شما هم می‌توانید سرور خودتان را بنویسید. یک کلاینت AI MCP MonoChat را به یک سرور MCP وصل می‌کند تا ابزارهایی که آن سرور ارائه می‌دهد در کنار توابع ابزار AI که در MonoChat می‌نویسید، به گره‌ها و عامل‌های AI شما داده شود.

آن‌ها را در تنظیمات › اتوماسیون › کلاینت‌های AI MCP مدیریت می‌کنید.

نحوه کار​

  1. آدرس سرور MCP را اضافه می‌کنید و وصل می‌شوید. MonoChat آنچه سرور ارائه می‌دهد را می‌خواند: ابزارها، منابع، الگوهای منبع و پرامپت‌ها.
  2. هنگام ذخیره، MonoChat این فهرست را به‌عنوان محتوای کلاینت نگه می‌دارد.
  3. در گره ایجاد تکمیل چت هوش مصنوعی یا گره عامل هوش مصنوعی، ابزارهایی را که می‌خواهید آن گره داشته باشد انتخاب می‌کنید و می‌توانید توضیح هر ابزار را برای مدل بازنویسی کنید.
  4. در طول گفتگو، مدل تصمیم می‌گیرد چه زمانی ابزاری را فراخوانی کند؛ MonoChat سرور MCP را فراخوانی می‌کند و نتیجه را به مدل برمی‌گرداند.

فقط ابزارهایی که به یک گره اضافه می‌کنید در دسترس آن گره هستند، بنابراین هر گره فقط همان چیزی را می‌بیند که نیاز دارد.

افزودن کلاینت MCP​

  1. به تنظیمات › اتوماسیون › کلاینت‌های AI MCP بروید و روی + (ایجاد) کلیک کنید.

  2. فیلدها را پر کنید:

    فیلدتوضیحات
    نامنامی برای سرور که در کشوی گره‌ها کنار هر ابزار آن نمایش داده می‌شود.
    توضیحاتیادداشت‌های اختیاری.
    نسخهنسخه کلاینتی که MonoChat هنگام اتصال به سرور اعلام می‌کند، مثلاً 1.0.0.
    EndpointURL پایه سرور MCP. MonoChat با انتقال SSE به <Endpoint>/sse وصل می‌شود، پس آدرس را بدون /sse وارد کنید.
    نوع احراز هویتهیچ، Basic (با نام کاربری و رمز عبور) یا Bearer (با توکن). اعتبارنامه‌ها همراه کلاینت ذخیره می‌شوند.

  3. روی اتصال کلیک کنید. MonoChat به سرور وصل می‌شود و آنچه یافته را در سربرگ‌ها نشان می‌دهد:

    • اطلاعات سرور: نام، نسخه، نسخه پروتکل و دستورالعمل‌های سرور.
    • ابزارها: نام و توضیح هر ابزار.
    • منابع، الگوهای منبع و پرامپت‌ها، اگر سرور ارائه دهد.

  4. اگر فهرست درست به نظر می‌رسد، روی ذخیره کلیک کنید. برای تغییر آدرس و تلاش دوباره، روی دکمه قطع اتصال کنار آن کلیک کنید.

نکته

اگر اتصال ناموفق بود، بررسی کنید که endpoint از اینترنت در دسترس باشد، سرور از انتقال SSE پشتیبانی کند و URL از قبل به /sse ختم نشده باشد.

به‌روزرسانی فهرست ابزارها​

وقتی سرور MCP ابزارهایی اضافه یا تغییر می‌دهد، کلاینت را با به‌روزرسانی باز کنید. MonoChat دوباره وصل می‌شود و محتوای فعلی را نشان می‌دهد؛ برای ذخیره فهرست جدید روی به‌روزرسانی کلیک کنید.

حذف یک کلاینت، محتوای آن را هم حذف می‌کند، بنابراین گره‌ها ابزارهایی را که از آن آمده بودند از دست می‌دهند.

دادن ابزارها به یک گره​

گره ایجاد تکمیل چت هوش مصنوعی​

  1. گره را باز کنید و تا تنظیمات ابزار محتوای کلاینت MCP هوش مصنوعی پایین بروید.
  2. روی تعیین ابزارهای محتوای کلاینت MCP هوش مصنوعی کلیک کنید. کشوی ابزارهای محتوای کلاینت MCP هوش مصنوعی ابزارهایی را که قبلاً به این گره اضافه شده‌اند فهرست می‌کند.
  3. روی + (ایجاد) کلیک کنید، سپس در ابزارهای محتوای کلاینت MCP هوش مصنوعی یک ابزار انتخاب کنید. ابزارها به شکل <client name> - <tool name> فهرست می‌شوند.
  4. توضیحات با توضیح خود ابزار پر می‌شود. اگر می‌خواهید دقیق‌تر به مدل بگویید چه زمانی از ابزار استفاده کند، آن را ویرایش کنید، مثلاً «از این برای جست‌وجوی سفارش با شماره آن استفاده کن». توضیحات الزامی است.
  5. برای هر ابزار تکرار کنید، سپس گره را ذخیره کنید.

می‌توانید توضیح یک ابزار را به‌روزرسانی کنید یا آن را از گره در همان کشو حذف کنید.

گره عامل هوش مصنوعی​

گره عامل هوش مصنوعی همان دکمه تعیین ابزارهای محتوای کلاینت MCP هوش مصنوعی را در بخش تنظیمات ابزار خود دارد. ابزارهای MCP انتخاب‌شده همراه با محدوده‌های AI و ابزارهای AI گره، روی همه harnessها در اختیار عامل قرار می‌گیرند. عامل‌های هوش مصنوعی را ببینید.

اطلاع

اجرای عامل بررسی می‌کند که هر ابزار MCP روی گره هنوز در فضای کاری شما وجود دارد. اگر کلاینت MCP‌ای را که یک گره از آن استفاده می‌کند حذف کنید، اجراهای آن گره با پیام «An AI scope or MCP tool was not found in this workspace.» ناموفق می‌شوند تا زمانی که ابزار را از گره حذف کنید.

مجوزها​

دسترسی با مجوزهای نقش Read / Create / Update / Delete AI MCP clients in automation و Read AI MCP client contents in automation کنترل می‌شود. نقش‌ها را ببینید.