← همه کانکتورهای MCP تلگرام

Raycast · MCP

اتصال تلگرام به Raycast

اِنترگرام را به‌عنوان یک سرور MCP در Raycast اضافه کنید و با یک کلید به حساب واقعی تلگرام خود برسید — پیام‌های از دست رفته و مشتریان منتظر را بدون باز کردن تلگرام بررسی کنید.

آدرس سرور MCP https://mcp.entergram.com/mcp

Raycast از طریق فرمان «Manage MCP Servers» از سرورهای MCP پشتیبانی می‌کند. اِنترگرام حساب شخصی تلگرام شما را به‌صورت یک سرور MCP میزبانی‌شده در دسترس می‌گذارد، بنابراین Raycast AI با امنیت کامل OAuth روی گفت‌وگوهای واقعی شما عمل می‌کند — بدون ربات و بدون کلید API.

پیکربندی آمادهٔ چسباندن

Raycast → Manage MCP Servers → Add
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

درباره تلگرامتان از Raycast بپرسید

با اتصال حساب شخصی شما، Raycast AI می‌تواند با یک کلید تلگرام را بررسی کند. امتحان کنید:

  • «در یک ساعت گذشته پیامی از مشتری‌ها را از دست دادم؟»
  • «پاسخ کدام گفت‌وگوها را فراموش کرده‌ام؟»
  • «این هفته چند سرنخ سرد شد؟»
  • «بازخورد مشتری‌های امروز را خلاصه کن.»
  • «برای آخرین پیام بی‌پاسخم یک پاسخ پیش‌نویس کن.»

اتصال Raycast در ۳ گام

با Raycast AI روی مک‌اواس کار می‌کند.

  1. 01

    آدرس MCP خود را در اِنترگرام کپی کنید

    در اِنترگرام، Settings → Workspace → Connectors → MCP را باز کنید و آدرس سرور MCP خود را کپی کنید.

  2. 02

    افزودن سرور در Raycast

    فرمان «Manage MCP Servers» در Raycast را اجرا کنید و یک سرور با آدرس اِنترگرام اضافه کنید: https://mcp.entergram.com/mcp.

  3. 03

    تأیید دسترسی و استفاده

    روی Connect کلیک کنید، با حساب اِنترگرام خود وارد شوید و روی Allow access کلیک کنید. اکنون Raycast AI می‌تواند از هر جای مک شما حساب تلگرامتان را پرس‌وجو کند و روی آن عمل کند.

سه راه برای شلیک‌کردنش

Raycast AI Chat

مسیر پیش‌فرض و همانی که باید با آن شروع کنید. کلید میان‌بر Raycast را بزنید، AI Chat را باز کنید، در متن درخواست به سرور اِنترگرام اشاره کنید تا ابزارهایش وارد بازی شوند و پاسخ را در همان پنجره‌ای بخوانید که بازش کرده‌اید. هیچ چیز دیگری روی صفحه لازم نیست تکان بخورد، و کل ماجرا همین است.

یک AI Command روی کلید خودش

پرسشی را که روزی بیست بار می‌پرسید — همین حالا چه چیزی روی دست من مانده — به‌عنوان یک AI Command ذخیره کنید و یک کلید به آن ببندید. یک ضربه کلید از داخل هر اپلیکیشنی جواب را برمی‌گرداند. یک آرگومان جای‌گیر اضافه کنید تا همان فرمان بتواند نام مشتری‌ای را که هنگام فراخوانی تایپ می‌کنید هم بپذیرد.

Manage MCP Servers

Raycast فهرست سرورهایش را پشت فرمان Manage MCP Servers نگه می‌دارد و هر مدخل یک JSON ساده است. وقتی همین را روی مک دوم راه می‌اندازید دانستنش می‌ارزد: مدخل را جای‌گذاری کنید، یک‌بار ورود را انجام دهید و همه فرمان‌های ذخیره‌شده آنجا هم بدون بازسازی کار می‌کنند. همین‌جا هم سر می‌زنید وقتی یک فرمان بی‌سروصدا دیگر فضای کاری شما را نمی‌بیند، چون این فهرست نشان می‌دهد سرور اصلاً هنوز فعال هست یا نه.

پرسش‌هایی که وسط جمله شلیک می‌کنید

اینجا جای اجرای یک کار چهل‌مرحله‌ای نیست. اینجا جایی است که یک واقعیت را در دو ثانیه‌ای می‌گیرید که طرف مقابل هنوز دارد سؤالش را تمام می‌کند. هر کدام از این‌ها یک ضربه کلید است، دو یا سه فراخوانی ابزار، و پاسخی آن‌قدر کوتاه که ایستاده بخوانیدش — زنجیره ابزارها فقط از این جهت مهم است که توضیح می‌دهد چرا جواب این‌قدر سریع می‌رسد.

شما می‌پرسید

«آخرین چیزی که Marco به من گفت چه بود، و من جوابش را دادم؟»

ابزارهای فراخوانی‌شده

entergram_list_chatsentergram_list_messages

دریافت می‌کنید

دو فراخوانی و یک خط جواب: خود پیام، زمانش، و اینکه آخرین نوبت آن رشته مال او بوده یا شما. همین است که ارزش دارد روی یک کلید بنشیند، چون درست وقتی لازمش دارید که طرف هنوز وسط پرسش است و گزینه دیگر این است که جلوی چشمش اپ باز کنید و اسکرول کنید.

شما می‌پرسید

«همین حالا تیکت بازی برای Northwind هست؟»

ابزارهای فراخوانی‌شده

entergram_list_chatsentergram_list_chat_tickets

دریافت می‌کنید

گفت‌وگوی آن حساب را پیدا می‌کند، تیکت‌های پیوست‌شده به آن را می‌آورد و برای هرچه هنوز باز است وضعیت و اولویت را گزارش می‌کند. هم برای پاسخ‌دادن زنده به مشتری در یک تماس کافی است، هم برای اینکه بفهمید نکند دارید تکراری چیزی را ثبت می‌کنید که همکارتان یک ساعت پیش باز کرده.

شما می‌پرسید

«به گروه استندآپ بگو پنج دقیقه دیگر می‌رسم.»

ابزارهای فراخوانی‌شده

entergram_list_accountsentergram_list_chatsentergram_send_message

دریافت می‌کنید

همان یک نوشتنی که بیشتر آدم‌ها روی میان‌بر می‌گذارند. پیش از ارسال درمی‌آورد آن گروه به کدام حساب متصل تعلق دارد، تا پیام از طرف شما برسد نه از طرف حسابی که تصادفاً اول مرتب شده. این یکی به connector فضای کاری نیاز دارد — عامل شخصی گروه را خوب می‌خواند و بعد سر ارسال می‌ایستد.

شما می‌پرسید

«درباره این مخاطب چه داریم — پلن، مسئول حساب، تاریخ تمدید؟»

ابزارهای فراخوانی‌شده

entergram_list_contactsentergram_get_chat_custom_fields

دریافت می‌کنید

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

شما می‌پرسید

«تیکت ۴۱۲ دست کیست و آخرین بار کی دستش زده؟»

ابزارهای فراخوانی‌شده

entergram_get_ticketentergram_list_members

دریافت می‌کنید

رکورد تیکت شناسه مسئول را دارد؛ جست‌وجوی عضو آن را به نامی که می‌شناسید تبدیل می‌کند. مسئول، وضعیت و آخرین به‌روزرسانی در یک خط برمی‌گردند — که دقیقاً همان محتوای پیامی است که وگرنه در کانال تیم می‌گذاشتید و منتظر می‌ماندید. روزی دوبار بپرسیدش و یک وقفه کوچک اما تکرارشونده را برای یک نفر دیگر در تیم حذف کرده‌اید.

شما می‌پرسید

«به آخرین پیام کانال عرضه ری‌اکشن تأیید بده.»

ابزارهای فراخوانی‌شده

entergram_list_chatsentergram_list_messagesentergram_set_message_reactions

دریافت می‌کنید

یک تأیید سه‌فراخوانی که از عوض‌کردن پنجره هم کمتر وقت می‌برد. کانال را پیدا می‌کند، شناسه جدیدترین پیام را از تاریخچه برمی‌دارد و ری‌اکشن را ثبت می‌کند. دقیقاً وقتی به کار می‌آید که می‌خواهید یک جمع بداند چیزی را خوانده‌اید و وسط کاری هستید که دلتان نمی‌خواهد رهایش کنید.

Raycast با تلگرام شما چه کارهایی می‌تواند بکند

  • پرس‌وجو از گفت‌وگوهای تلگرام از هر جای مک‌اواس
  • نمایان‌کردن آنی پیام‌های از دست رفته
  • جست‌وجوی مخاطبین و فیلدهای CRM
  • ارسال پیام و پاسخ با تأیید شما
  • عددی‌کردن فرصت‌های از‌دست‌رفته و بازخوردها
  • راه‌اندازی اقدامات تلگرام با یک کلید

پشت این لانچر چه چیزی نشسته

این کانکتور همان ۷۰ ابزار در ۹ گروه را که یک عامل کامل می‌گیرد به Raycast هم می‌دهد، هرچند یک پرسش معمولی لانچری فقط به دو یا سه‌تایشان دست می‌زند. این وسعت به‌خاطر همان درخواست‌های نادر و عجیب می‌ارزد — فهرست اعضای یک گروه، یک فیلد از یک تیکت، انجمن‌های مشترک یک مخاطب — که وگرنه دو اپ و یک کادر جست‌وجو خرجتان می‌شد. در عمل گروه‌های کشف بیشترین کار را می‌کنند، چون تقریباً هر پرسش سریع اول باید یک نام را به یک گفت‌وگو یا یک مخاطب تبدیل کند تا بتواند چیزی را نگاه کند.

حساب‌ها و فضای کاری

5 ابزار

شناسایی هویت و دامنه دسترسی. هر فراخوانی مربوط به پیام‌ها ابتدا به یک account_id از list_accounts نیاز دارد — کلاینت هوش مصنوعی که این گام را رد کند، سراغ حساب تلگرام اشتباهی می‌رود.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

گفت‌وگوها و یافتن آن‌ها

8 ابزار

برای پیدا کردن گفت‌وگوها. نماهای فضای کاری وضعیت CRM را می‌آورند (تیکت‌ها، کامنت‌ها، فیلدهای سفارشی) و نماهای زنده وضعیت جاری انتقال در تلگرام و شمار پیام‌های خوانده‌نشده را.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

پیام‌ها

9 ابزار

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

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

مخاطبین

3 ابزار

اینکه با چه کسی حرف می‌زنید و کجای دیگر با او هم‌پوشانی دارید. جست‌وجوی گروه‌های مشترک همان چیزی است که پرسش‌هایی مانند «کدام سرنخ‌های من در یک انجمن مشترک‌اند؟» را پاسخ‌پذیر می‌کند.

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

تیکت‌ها

10 ابزار

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

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

فیلدهای سفارشی CRM

11 ابزار

ساختار قیف فروش شما. پیش از نوشتن مقادیر، ستون‌ها را بخوانید — چک‌باکس‌ها مقدار boolean می‌گیرند، چندانتخابی‌ها آرایه‌ای از مقادیر گزینه‌ها، و تاریخ‌ها رشته‌های ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

فیلدهای سفارشی تیکت

9 ابزار

همان کنترل ساختار در سمت تیکت — دسته‌بندی‌ها، سطوح شدت، پله‌های SLA و هر چیز دیگری که میز پشتیبانی شما فراتر از وضعیت و اولویت دنبال می‌کند.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

یادداشت‌های داخلی

4 ابزار

کامنت‌هایی روی یک گفت‌وگو که مشتری شما هرگز آن‌ها را نمی‌بیند. کاربردی برای اینکه یک کلاینت هوش مصنوعی استدلالش را جا بگذارد و همکار انسانی آن را ادامه دهد.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

گروه‌ها و کانال‌ها

11 ابزار

ساخت و مدیریت گروه‌ها و کانال‌های تلگرام — عضویت، دسترسی‌ها، حریم خصوصی و اطلاعات — به‌علاوه یک راه گریز برای اجرای دستور خام برای باقی موارد.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

یک ضربه کلید اجازه چه کاری دارد

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

عامل شخصی
چیزی که تقریباً هر راه‌اندازی تک‌کاربره Raycast باید رویش باشد. هر عضو می‌تواند یکی بسازد و خواندن‌ها دست‌ودل‌بازانه‌اند — گفت‌وگوها، تاریخچه پیام‌ها، مخاطبین، تیکت‌ها و فضای کاری پیرامونشان — در حالی که تنها نوشتنی که دارد فیلدهای سفارشی گفت‌وگوهای خودتان است. کلید میان‌بری که اشتباهی زده شود چیزی را نگاه می‌کند و همان‌جا می‌ایستد — هیچ راهی به‌سمت مشتری ندارد.
connector فضای کاری
همان لحظه‌ای لازم می‌شود که فرمان‌های پاسخ‌سریع را بخواهید، و ضمناً نوشتن فیلد روی هر گفت‌وگو و مدیریت گروه را هم باز می‌کند. ساختنش با owner و admin است. روی لپ‌تاپی که همراهتان سفر می‌کند، این سطح دسترسی را در برابر اینکه چقدر آسان می‌شود آن میان‌بر را زد بسنجید.
لغو دسترسی از یک مک مشترک
حذف سرور از فهرست Raycast آن را روی همان ماشین متوقف می‌کند. اگر ماشین دیگر دست شما نیست، به‌جایش توکن را در اِنترگرام در مسیر Settings → Workspace → Connectors → MCP لغو کنید — این دسترسی را فارغ از اینکه چه چیزی هنوز محلی پیکربندی شده تمام می‌کند.

کاری که یک لانچر برایتان نمی‌کند

Raycast عمداً کم‌عمق است و این‌ها لبه‌هایی‌اند که در همان هفته اول زندگی روی کلید میان‌بر به آن‌ها می‌خورید.

  • فراخوانی ابزارهای MCP در سمت اِنترگرام به فضای کاری Pro نیاز دارد. اتصال روی هر پلنی تأیید می‌شود؛ جواب‌ها فقط روی Pro برمی‌گردند.
  • Raycast AI روی سطح پولی Raycast است. سرورهای MCP با قابلیت‌های هوش مصنوعی Raycast رانده می‌شوند، پس پیش از عیب‌یابیِ اینکه چرا ابزارها شلیک نمی‌کنند، مطمئن شوید پلن Raycast شما پوششش می‌دهد.
  • فقط مک‌اواس. روی ویندوز یا لینوکس کلاینت Raycastی برای پیکربندی نیست — آدرس MCP همه‌جا یکسان است، اما آنجا اپ دیگری را به آن نشانه می‌گیرید.
  • هیچ چیز در پس‌زمینه polling نمی‌کند. کانکتور وقتی از او بپرسید جواب می‌دهد و هرگز برعکس: نه اعلان push، نه نشان روی نوار منو، نه تلنگری وقتی مشتری‌ای در میانه یک جلسه برایتان می‌نویسد.
  • پرسش‌های گسترده دیگر سریع نیستند. هر «چه چیزی در کل فضای کاری فوری است» تعداد زیادی گفت‌وگو را می‌پیماید و به‌همان اندازه هم طول می‌کشد. یک آدم، یک گروه یا یک بازه زمانی را نام ببرید تا چابک بماند.
  • فرمان‌های ارسال روی عامل شخصی شکست می‌خورند. آن دسترسی‌ها پیش از پیام‌های خروجی تمام می‌شوند، پس میان‌بر پاسخ‌دادن از لانچر به connector فضای کاری وابسته است که پشت نقش owner یا admin نشسته.

رفع اشکال connector Raycast

ابزارهای اِنترگرام هرگز استفاده نمی‌شوند
Raycast فقط سراغ سروری می‌رود که متن درخواست واقعاً به آن اشاره کند. نام سرور اِنترگرام را در پیام AI Chat بیاورید، یا همان ارجاع را داخل AI Command ذخیره‌شده بپزید — وگرنه مدل از دانش عمومی جواب می‌دهد و اصلاً به فضای کاری شما دست نمی‌زند.
هیچ گزینه هوش مصنوعی‌ای در Raycast پیدا نمی‌شود
سرورهای MCP از مسیر قابلیت‌های هوش مصنوعی Raycast اجرا می‌شوند که روی سطح پولی آن است. اگر AI Chat و AI Commands در نصب شما نیستند، این یک پرسش درباره اشتراک Raycast است نه چیزی که سمت اِنترگرام درست شود.
سرور بعد از یک به‌روزرسانی از فهرست ناپدید شد
دوباره Manage MCP Servers را باز کنید، مدخل را از نو اضافه کنید و یک‌بار دیگر وارد شوید. اگر مدخل JSON را جایی ذخیره نگه دارید این کار ده ثانیه‌ای می‌شود، و همان قطعه‌ای است که برای راه‌اندازی ماشین دوم هم جای‌گذاری می‌کنید.
کلید میان‌بر جواب می‌دهد، اما کند
درخواست زیادی گسترده بوده. پرسشی که یک گفت‌وگو، یک مخاطب یا یک روز را نام ببرد در دو یا سه فراخوانی حل می‌شود؛ بررسی کنید کدام بخش دارد کل فضای کاری را می‌پیماید. نسخه گسترده را به فرمان جداگانه خودش ببرید و نسخه سریع را روی کلید نگه دارید.
خواندن‌ها کار می‌کنند، ارسال‌ها با خطا برمی‌گردند
به‌عنوان عامل شخصی وصل شده‌اید که دسترسی‌هایش پیش از پیام‌های خروجی تمام می‌شود. connector فضای کاری که یک فرمان ارسال به آن وابسته است باید توسط کسی با نقش owner یا admin ساخته شود — هر فرمان فقط‌خواندنی در هر صورت به کارش ادامه می‌دهد.
دوباره از من می‌خواهد وارد شوم
توکن‌ها ابدی نیستند. اتصال را از Manage MCP Servers شروع کنید، یک‌بار دیگر صفحه رضایت را تأیید کنید و همه فرمان‌های ذخیره‌شده بدون اینکه هیچ‌کدامشان ویرایش شوند دوباره کار می‌کنند.

پرسش‌های متداول Raycast و تلگرام

چطور یک سرور MCP به Raycast اضافه کنم؟
از فرمان «Manage MCP Servers» در Raycast استفاده کنید، آدرس MCP اِنترگرام را اضافه کنید و از طریق OAuth دسترسی بدهید.
آیا این یک ربات تلگرام است؟
نه. اِنترگرام حساب شخصی واقعی تلگرام شما را از طریق یک سرور MCP میزبانی‌شده وصل می‌کند.
آیا امن است؟
بله. OAuth 2.0 با دسترسی‌های محدودشده؛ اطلاعات ورود شما در اِنترگرام می‌ماند و دسترسی قابل لغو است.