هفتهٔ جشن راه‌اندازی: تا ۳۰ مهر همهٔ امکانات رایگان است! فقط کافی است وارد شوید. ورود رایگان

Esc

بله MCP: اتصال هوش مصنوعی به پیام‌های بازوی بله

۳ دقیقه مطالعهپیامک و پیام‌رسان

با بله MCP، دستیار هوش مصنوعی شما می‌تواند پیام‌های بازوی (ربات) بله را بخواند، در آن‌ها جستجو کند و جواب بفرستد. همچنین می‌تواند در بله سؤالی از شما بپرسد و منتظر دکمه یا جوابتان بماند.

بله MCP چیست و به چه کسی کمک می‌کند؟

بله MCP یک سرور MCP است؛ یعنی قطعه‌ای که به برنامه‌های هوش مصنوعی امکان می‌دهد کاری را روی سرویس دیگری انجام دهند. این سرور روی کامپیوتر شما اجرا می‌شود و ۱۳ قابلیت دارد.

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

چه کارهایی می‌تواند انجام دهد؟

ابزار چند کار اصلی را پوشش می‌دهد:

  • bot_get_new_messages: پیام‌های تازه همه چت‌ها را از آخرین بررسی می‌گیرد.
  • bot_list_chats: فهرست چت‌ها را با تعداد پیام‌های خوانده‌نشده نشان می‌دهد.
  • bot_read_chat: پیام‌های اخیر یک چت را می‌خواند؛ هم پیام‌های فرستاده‌شده و هم دریافتی.
  • bot_search_messages: در پیام‌های ذخیره‌شده جستجو می‌کند. با نوشتار فارسی سازگار است.
  • bot_wait_for_reply: منتظر می‌ماند تا کسی در چت چیزی بنویسد یا دکمه‌ای بزند.
  • bot_send_message: یک پیام متنی از طرف بازو می‌فرستد.
  • bot_send_file: عکس، سند، ویدیو، صدا یا پیام صوتی می‌فرستد.
  • bot_download_file: فایلی را که برای بازو فرستاده شده، تا ۲۰ مگابایت، روی کامپیوتر شما ذخیره می‌کند.

قابلیت‌های دیگر هم هستند: bot_get_me برای امتحان توکن و نمایش مشخصات بازو، bot_get_chat برای مشخصات یک چت، bot_get_webhook_info برای وضعیت وب‌هوک، bot_edit_message برای ویرایش پیام بازو، و bot_delete_message برای حذف آن.

نمونه سؤال‌هایی که می‌توانید بپرسید

این نمونه‌ها را همان‌طور که هستند در گفتگو با دستیار بنویسید:

  • «پیام‌های جدید بله را بخوان و خلاصه‌شان را بگو.»
  • «وقتی تست‌ها تمام شد، خلاصه نتیجه را در بله برایم بفرست.»
  • «در بله از من بپرس دیپلوی کنم یا نه، با دکمه بله/خیر، و منتظر جوابم بمان.»

سؤال آخر نشان می‌دهد که دستیار فقط خواندن و فرستادن ندارد. با bot_wait_for_reply منتظر دکمه یا جواب شما در بله می‌ماند.

نصب و اتصال

بله MCP روی کامپیوتر شما اجرا می‌شود، پس نصب محلی لازم است. مراحل:

  1. با @botfather در بله یک بازو بسازید و توکن آن را بگیرید.
  2. توکن را در متغیر BALE_BOT_TOKEN قرار دهید. این متغیر لازم است؛ توکن را به‌عنوان راز ذخیره کنید.
  3. سرور را با دستور uvx bale-mcp اجرا کنید. در تنظیمات برنامه، command را uvx و args را bale-mcp بگذارید.
  4. اگر خواستید، BALE_ALLOWED_CHATS را با شناسه یا @username چت‌های مجاز، جدا شده با ویرگول، پر کنید.

متغیرهای اختیاری دیگر: BALE_MCP_DB برای مسیر فایل تاریخچه پیام‌ها و BALE_MCP_PROXY اگر اینترنت شما به tapi.bale.ai وصل نمی‌شود.

محدودیت‌ها و هشدارها

  • برای کار کردن به توکن بازو نیاز دارد. بدون توکن، سرور پیام‌ها را نمی‌خواند و نمی‌فرستد.
  • قابلیت‌های ارسال، ویرایش و حذف روی پیام‌های واقعی اثر می‌گذارند. حذف پیام برگشت‌پذیر نیست. پیش از استفاده از آن‌ها دقت کنید.
  • فقط پیام‌هایی را می‌بیند که به بازو فرستاده می‌شود. با حساب شخصی شما وارد بله نمی‌شود.
  • با BALE_ALLOWED_CHATS فقط چت‌های خودتان خوانده می‌شود و پیام غریبه‌ها به دستیار نمی‌رسد. اگر این متغیر را خالی بگذارید، همه چت‌های بازو در دسترس دستیار هستند.
  • تاریخچه پیام‌ها روی کامپیوتر خودتان ذخیره می‌شود. با :memory: در BALE_MCP_DB چیزی روی دیسک نمی‌ماند.

جمع‌بندی

اگر می‌خواهید دستیار هوش مصنوعی شما با بازوی بله کار کند، بله MCP کمک می‌کند بدون کپی‌کردن دستی پیام‌ها، خلاصه بگیرید، جواب بفرستید و نتیجه کار را در بله دریافت کنید. برای جزئیات قابلیت‌ها و تنظیمات، صفحه ابزار بله را ببینید. اگر می‌خواهید بدانید MCP دقیقاً چیست، راهنمای MCP را بخوانید.

سؤال‌های پرتکرار

بله MCP چیست؟

بله MCP یک سرور MCP است که به دستیار هوش مصنوعی شما اجازه می‌دهد پیام‌های بازوی بله را بخواند و جواب بفرستد. روی کامپیوتر شما اجرا می‌شود و ۱۳ قابلیت دارد.

برای اتصال بله MCP چه چیزی لازم است؟

توکن بازو لازم است که آن را از @botfather در بله می‌گیرید. توکن را در متغیر BALE_BOT_TOKEN قرار دهید و سرور را با دستور uvx bale-mcp اجرا کنید.

آیا بله MCP پیام‌های شخصی من را می‌خواند؟

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

آیا بله MCP می‌تواند پیام حذف کند؟

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

بیشتر بخوانید