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

Gemini · Google

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

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

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

Gemini CLI و ابزارهای سازگار با MCP در Gemini می‌توانند به سرورهای MCP بیرونی متصل شوند. اِنترگرام حساب شخصی تلگرام شما را به‌صورت یک سرور MCP میزبانی‌شده در دسترس قرار می‌دهد، تا Gemini با امنیت OAuth گفت‌وگوهای واقعی شما را بخواند و روی آن‌ها عمل کند — بدون ربات، بدون کدنویسی و بدون کلید API.

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

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

از Gemini چیزهایی بپرسید که هرگز نمی‌توانستید از تلگرام بپرسید

با اتصال حساب شخصی، Gemini می‌تواند هم‌زمان همه گفت‌وگوها را تحلیل کند. این درخواست‌ها را امتحان کنید:

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

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

با Gemini CLI و کلاینت‌های سازگار با MCP در Gemini کار می‌کند.

  1. 01

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

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

  2. 02

    ثبت سرور MCP در Gemini

    اِنترگرام را با این آدرس به پیکربندی MCP در Gemini CLI خود اضافه کنید: https://mcp.entergram.com/mcp.

  3. 03

    تأیید دسترسی و اجرا

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

سرور را کجا ثبت کنیم

Gemini CLI، در دامنه کاربر

مسیر اصلی، و همان چیزی که بیشتر آدم‌ها از «Gemini MCP» مراد می‌کنند. سرور را در ~/.gemini/settings.json زیر mcpServers اضافه کنید و httpUrl را به اندپوینت میزبانی‌شده بدهید، CLI را دوباره راه بیندازید و ابزارها در همه پروژه‌های آن ماشین در دسترس‌اند. چون سرور از راه دور و روی HTTPS است، نه wrapper مبتنی بر npx لازم دارید نه پل stdio که زنده نگهش دارید.

{ "mcpServers": { "entergram": { "httpUrl": "https://mcp.entergram.com/mcp" } } }

Gemini CLI، در دامنه پروژه

همان بلوک اگر داخل مخزن در .gemini/settings.json بنشیند، فقط برای همان checkout اعمال می‌شود. وقتی یک مخزن خطِ لوله انتشار است که اعلان‌ها را به یک کانال تلگرام می‌فرستد و بقیه کارهایتان اصلاً کاری با گفت‌وگوها ندارند، همین را می‌خواهید — ضمن اینکه پیکربندی در کنترل نسخه می‌ماند و هم‌تیمی‌تان می‌تواند بخواندش.

mkdir -p .gemini && $EDITOR .gemini/settings.json

هر کلاینتی که مدل Gemini را می‌راند

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

کارهای ترمینالی که ارزش سیم‌کشی دارند

در CLI این‌ها فراخوانی‌های یک‌خطی‌اند که می‌توانید پشت یک alias پوسته یا یک git hook بگذارید. هر درخواست به زبان ساده به دنباله‌ای از فراخوانی ابزار باز می‌شود و CLI چاپ می‌کند چه چیزی را صدا زده — پس می‌توانید پیش از سپردن یک نوشتن به آن، مکانیکش را تماشا کنید. همه موارد زیر فرض می‌گیرند سرور یک‌بار ثبت و تأیید شده؛ بعد از آن فقط تایپ‌کردن است.

شما می‌پرسید

«یادداشت‌های انتشار را از CHANGELOG.md در کانال بتا منتشر کن.»

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

entergram_list_accountsentergram_list_groupsentergram_send_message

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

همان گام بعد از deploy که هیچ‌کس یادش نمی‌ماند. Gemini از دل مخزن changelog را در زمینه دارد، حسابی را که کانال را مدیریت می‌کند برمی‌دارد، کانال را با نام تطبیق می‌دهد و منتشر می‌کند. آن را به یک build موفق آویزان کنید تا اعلان دیگر به حافظه کسی وابسته نباشد.

شما می‌پرسید

«چه کسانی در کانال بتا هستند که هرگز به‌عنوان مشتری پولی علامتشان نزده‌ایم؟»

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

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

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

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

شما می‌پرسید

«خروجی تست‌های شکست‌خورده را با یک توضیح کوتاه به رشته Acme بفرست.»

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

entergram_list_chatsentergram_send_media_message

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

فایل همین‌جا کنار دستتان روی دیسک است و این کل مراسم آپلود را حذف می‌کند. Gemini خروجی را پیوست می‌کند و خودش خط توضیح را می‌نویسد — همان تفاوت میان مشتری‌ای که یک دیوار stack trace می‌بیند و مشتری‌ای که می‌فهمد چه چیزی شکسته و کی درست می‌شود.

شما می‌پرسید

«یک کانال برای عرضه بساز، اسمش را درست بگذار و تیم انتشار را اضافه کن.»

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

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

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

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

شما می‌پرسید

«در آن اعلان شماره نسخه را غلط زدم، درستش کن.»

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

entergram_list_messagesentergram_edit_message

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

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

شما می‌پرسید

«تعداد تیکت‌های این هفته را به تفکیک مسئول، به‌صورت TSV بده.»

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

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

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

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

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

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

سطح ابزارها در CLI

بعد از اتصال، سرورهای MCP ثبت‌شده را فهرست کنید تا هر ۷۰ ابزار زیر entergram ظاهر شوند، با همین گروه‌بندی پایین. نام ابزارها شناسه‌های تحت‌اللفظی‌اند و این در ترمینال بیشتر از پنجره چت به کار می‌آید: وقتی رفتار قطعی می‌خواهید، می‌توانید مستقیم نام یک فراخوانی را در درخواستتان بیاورید تا مدل خودش مسیر انتخاب نکند. CLI هر فراخوانی و آرگومان‌هایش را حین اجرا چاپ می‌کند و همین یادگیری یک فهرست ناآشنا را سریع می‌کند.

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

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

رضایت، به‌ازای هر ماشین

هیچ چیز در settings.json یک اعتبارنامه نیست. این فایل فقط به CLI می‌گوید سرور کجاست؛ دسترسی از یک ورود OAuth می‌آید که در مرورگر کامل می‌کنید و توکن حاصل به شما تعلق دارد، نه به آن checkout. Google در هیچ نقطه‌ای اعتبارنامه تلگرام دریافت نمی‌کند — شماره تلفن و نشست درون اِنترگرام می‌مانند. دو مجموعه دسترسی وجود دارد و اینکه کدام را لازم دارید بستگی دارد به اینکه از CLI انتظار نوشتن می‌رود یا نه.

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

محدودیت‌هایی که باید دورشان طراحی کنید

بیشترشان تازه وقتی گاز می‌گیرند که بخواهید CLI را بدون نظارت اجرا کنید.

  • ثبت سرور با تأیید آن یکی نیست. هر ماشین بار اول خودش باید از صفحه رضایت رد شود، پس یک لپ‌تاپ تازه یا یک کانتینر بازساخته دست‌کم یک‌بار به مرورگر نیاز دارد.
  • فضای کاری اِنترگرام باید روی Pro باشد. اگر پلن پایین‌تر باشد، CLI با کمال میل سرور را فهرست می‌کند و بعد از هر فراخوانی رد جمع می‌کند — چیزی که شبیه پیکربندی خراب به نظر می‌رسد ولی نیست.
  • حساب ضمنی وجود ندارد. ابزارهای پیام به account_id صریح نیاز دارند، پس هر اسکریپتی اول باید فهرست حساب‌ها را حل کند — در یک چت به‌سختی به چشم می‌آید، در یک pipeline یک چیز دیگر که باید یادتان بماند. یک‌بار در ابتدای اسکریپت حلش کنید و پایین‌دست پاسش بدهید.
  • عامل شخصی نه می‌فرستد و نه گروه مدیریت می‌کند. اتوماسیون‌هایی که یادداشت انتشار منتشر می‌کنند یا کانال می‌سازند به connector فضای کاری نیاز دارند که یک owner یا admin تأییدش کرده باشد.
  • پروتکل درخواست و پاسخ است، نه اشتراک. هیچ چیز بی‌مقدمه در ترمینال شما ظاهر نمی‌شود؛ Gemini تنها وقتی از یک پیام تازه باخبر می‌شود که چیزی به او بگوید نگاه کند. هر چیزی شبیه پایش باید یک کار زمان‌بندی‌شده باشد که خودتان می‌سازید.
  • CLI سطح دسترسی را بالا نمی‌برد. دقیقاً همان گفت‌وگوهایی را می‌بیند که حساب تلگرام خودتان می‌بیند و گروهی که ترکش کرده‌اید، گروهی است که نمی‌تواند بخواندش.

مشکلات CLI و ریشه‌هایشان

سرور اصلاً در فهرست MCP ظاهر نمی‌شود
تقریباً همیشه JSON خراب است — یک ویرگول اضافه در انتها باعث می‌شود CLI کل فایل تنظیمات را بی‌صدا کنار بگذارد. اعتبارسنجی‌اش کنید، مطمئن شوید برای یک سرور HTTPS از راه دور کلید httpUrl است نه یک مدخل stdio با command و args، و بررسی کنید مدخل واقعاً داخل mcpServers نشسته باشد.
تغییرات settings.json انگار هیچ اثری ندارد
پیکربندی موقع راه‌اندازی خوانده می‌شود. نشست را کامل ببندید و دوباره باز کنید؛ یک پروسه در حال اجرا همان فهرست ابزاری را سرو می‌کند که موقع بالا آمدن ساخته، پس فایل می‌تواند درست باشد و باز هم نادیده‌گرفته‌شده به نظر برسد.
OAuth روی یک ماشین بدون رابط گرافیکی کامل نمی‌شود
صفحه رضایت به مرورگر نیاز دارد. روی ایستگاه کاری‌ای که می‌بینیدش تأیید کنید، یا پورت callback را روی SSH فوروارد کنید — یک build agent بدون نمایشگر خودش نمی‌تواند دست‌دادن را تمام کند.
در یک پوشه کار می‌کند و در آن یکی نه
دو فایل تنظیمات دارید. آن‌که زیر ~/.gemini است همه‌جا اعمال می‌شود و آن‌که زیر .gemini داخل یک مخزن است فقط همان‌جا. پیش از دست‌زدن به هر چیز دیگری ببینید مدخل entergram واقعاً در کدامشان است.
همه فراخوانی‌ها 403 برمی‌گردانند
اول پلن را بررسی کنید، بعد نقش را. دسترسی MCP به Pro نیاز دارد و هر چیزی فراتر از مجموعه دسترسی عامل شخصی به نقش owner یا admin در فضای کاری اِنترگرام.
خواندن کار می‌کند ولی ارسال رد می‌شود
این مرزِ عامل شخصی است که خودش را نشان می‌دهد، نه یک خطای گذرا. ارسال اصلاً در مجموعه دسترسی‌های آن نیست، پس تکرار کمکی نمی‌کند — یک owner یا admin باید یک connector فضای کاری تأیید کند و شما جریان رضایت را در برابر همان دوباره اجرا کنید.

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

آیا با Gemini CLI کار می‌کند؟
بله. Gemini CLI از سرورهای MCP پشتیبانی می‌کند — آدرس MCP اِنترگرام را در پیکربندی MCP خود ثبت کنید و از طریق OAuth دسترسی بدهید.
آیا این یک ربات تلگرام است؟
نه. اِنترگرام حساب شخصی واقعی تلگرام شما را از طریق یک سرور MCP میزبانی‌شده وصل می‌کند، پس Gemini با گفت‌وگوهای واقعی شما کار می‌کند.
آیا Gemini می‌تواند بگوید چه چیزی را از دست داده‌ام؟
بله. می‌تواند همه گفت‌وگوهای متصلتان را بخواند، پیام‌های بی‌پاسخ و خوانده‌نشده را بشمارد و پیام‌های مشتری‌ها و سرنخ‌ها را برجسته کند.
آیا امن است؟
بله. این اتصال از OAuth 2.0 با دسترسی‌های محدودشده استفاده می‌کند؛ شما تصمیم می‌گیرید Gemini به چه چیزی دسترسی داشته باشد و هر زمان می‌توانید آن را لغو کنید.