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

Cline · VS Code

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

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

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

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

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

cline_mcp_settings.json
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

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

با اتصال حساب شخصی شما، Cline می‌تواند تلگرام را بدون خروج شما از VS Code بررسی کند. امتحان کنید:

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

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

با افزونه Cline در VS Code کار می‌کند.

  1. 01

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

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

  2. 02

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

    در تنظیمات MCP در Cline (فایل cline_mcp_settings.json) آدرس MCP اِنترگرام را ثبت کنید: https://mcp.entergram.com/mcp.

  3. 03

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

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

سه راه برای ثبتش در Cline

پنل MCP Servers — بخش Remote Servers

مسیری که اصلاً JSON در آن دخیل نیست. روی آیکن سرور در بالای پنل Cline بزنید، تب Remote Servers را باز کنید، نام مدخل را entergram بگذارید، آدرس را جای‌گذاری کنید و Add را بزنید. Cline پیکربندی را برایتان می‌نویسد و کنار سرور یک چراغ وضعیت نشان می‌دهد، که سریع‌ترین راه تشخیص یک جای‌گذاری اشتباه از یک نقشه اشتباه است.

cline_mcp_settings.json

خود فایل در فضای ذخیره‌سازی سراسری افزونه زندگی می‌کند — روی مک‌اواس در ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json، و روی ویندوز و لینوکس با همان شکل مسیر زیر پوشه کاربر VS Code. ویرایش دستی‌اش وقتی می‌ارزد که بخواهید آرایه autoApprove را کنار بقیه تنظیمات ماشینتان در کنترل نسخه داشته باشید.

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

تأیید خودکار، محدود به خواندن‌ها

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

"autoApprove": [
  "entergram_list_accounts",
  "entergram_list_chats",
  "entergram_list_messages",
  "entergram_get_contact"
]

شش اجرا، و جایی که Cline می‌ایستد و می‌پرسد

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

شما می‌پرسید

«گزارش‌های باگ امروز صبح را یکی‌یکی به تیکت تبدیل کن.»

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

entergram_list_live_chatsentergram_list_messagesentergram_create_ticket

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

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

شما می‌پرسید

«بیست دقیقه پیش deploy کردیم. چیزی خراب شده؟»

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

entergram_list_live_chatsentergram_get_live_chatentergram_list_messages

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

یک آزمون دود در برابر تنها پایشگری که خرابی‌های جامانده از داشبوردهایتان را می‌گیرد. Cline دامنه را به گفت‌وگوهایی که از پنجره deploy به بعد فعالیت داشته‌اند باریک می‌کند، آنچه رسیده را می‌خواند و ترافیک معمولی را از هرچه بوی رگرسیون می‌دهد جدا می‌کند. همه‌اش خواندن است، پس با تأیید خودکار روشن بی‌وقفه اجرا می‌شود.

شما می‌پرسید

«تیکت‌های قطعی دیشب هنوز همه عادی علامت خورده‌اند. شدت آن‌هایی را که از مشتری‌های پولی‌اند بالا ببر.»

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

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_update_ticket

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

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

شما می‌پرسید

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

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

entergram_list_messagesentergram_set_message_reactions

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

ری‌اکشن ارزان‌ترین پاسخ ممکن است و همانی که توسعه‌دهنده‌ها هیچ‌وقت فرصتش را پیدا نمی‌کنند. Cline پیام‌های گزارش را در میان رشته‌ها پیدا می‌کند و به هر کدام واکنش می‌دهد؛ چیزی خرج برنمی‌دارد و ساعت‌ها صبر می‌خرد از آدم‌هایی که وگرنه فکر می‌کنند نادیده گرفته شده‌اند.

شما می‌پرسید

«یادداشت انتشار را برای گروه بتا پیش‌نویس کن و پیش از ارسال بایست.»

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

entergram_list_groupsentergram_list_group_membersentergram_send_message

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

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

شما می‌پرسید

«کاری که در این اجرا کردی را به‌عنوان یادداشت داخلی روی هر گفت‌وگویی که دست زدی بنویس.»

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

entergram_list_chat_commentsentergram_create_chat_comment

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

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

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

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

Cline به چه چیزهایی می‌تواند دست ببرد

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

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

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

دو دروازه، نه یکی

پنجره تأیید Cline دروازه‌ای است که می‌بینید. دسترسی‌های OAuth دروازه‌ای است که یک‌بار تنظیمش می‌کنید و بعد فراموشش، و سخت‌گیرانه‌تر از آن یکی است — تأییدکردن یک فراخوانی هرگز نمی‌تواند مجوزی بدهد که توکن با آن صادر نشده. پیش از تنظیم autoApprove سطح دسترسی را تعیین کنید، چون توکن سقف ماجراست و فهرست تأیید فقط تعیین می‌کند چند بار درباره چیزی که از قبل مجاز است از شما بپرسند. لغو دسترسی در اِنترگرام از مسیر Settings → Workspace → Connectors → MCP دو کلیک است.

عامل شخصی
هر عضو فضای کاری می‌تواند بدون پرسیدن از کسی یکی بسازد. دسترسی خواندن روی گفت‌وگوها، پیام‌ها، مخاطبین، تیکت‌ها، حساب‌های متصل و رکورد فضای کاری را پوشش می‌دهد، به‌علاوه نوشتن روی فیلدهای سفارشی گفت‌وگوهای خودتان. در ترکیب با حلقه تأیید Cline، حتی یک عامل جاه‌طلب را بی‌خطر می‌کند: بدترین اتفاق ممکن این است که بیشتر از آنچه لازم بود بخواند.
connector فضای کاری
فقط یک owner یا admin می‌تواند بسازدش، و همان سطحی است که نیمه نوشتن فهرست ابزارها را باز می‌کند — ارسال و ویرایش پیام، تغییر فیلدهای سفارشی گفت‌وگوهایی که مال شما نیستند، مدیریت گروه‌ها. کل تیم مشترکش هستند، و همین یک فهرست autoApprove سخاوتمندانه را از یک ترجیح شخصی به یک تصمیم تیمی تبدیل می‌کند.
لغو دسترسی
حذف سرور از Cline جلوی پرسیدن کلاینت را می‌گیرد. لغو در اِنترگرام جلوی پاسخ‌دادن سرور را، از جمله در هر نشستی که هنوز روی ماشینی دیگر باز است. وقتی دارید دسترسی‌ها را می‌چرخانید سراغ دومی بروید، نه وقتی صرفاً می‌خواهید ویرایشگرتان را مرتب کنید.

حلقه تأیید چه چیزی از شما می‌گیرد

معامله‌های صادقانه یک عامل درون‌ویرایشگری که یک آدم وسطش ایستاده.

  • تأیید به‌ازای هر فراخوانی ابزار است، نه هر نقشه. یک کار شش‌مرحله‌ای یعنی شش پرسش در پنل، و اگر وسط کار بلند شوید و بروید، اجرا تا ابد روی گام بعدی پارک می‌ماند.
  • autoApprove روی نام ابزارها تطبیق می‌دهد، هرگز روی آرگومان‌ها. گذاشتن entergram_send_message در آن فهرست، آن را برای هر گفت‌وگویی تأیید می‌کند نه فقط همانی که در ذهن داشتید، پس تا وقتی یک جریان کاری جایش را نساخته ابزارهای نوشتن را از آن بیرون نگه دارید.
  • اجرا داخل پنجره ویرایشگر شما زندگی می‌کند. VS Code را ببندید یا میزبان افزونه را reload کنید و کار همان‌جا که هست می‌ایستد — چیزی روی سرور ادامه نمی‌یابد و چیزی از جایی که مانده از سر گرفته نمی‌شود.
  • فضای کاری پایین‌تر از Pro ورود OAuth را کامل می‌کند و بعد روی اولین فراخوانی شکست می‌خورد، که Cline آن را به‌جای مشکل اتصال، به‌شکل نتیجه شکست‌خورده ابزار نشان می‌دهد. دسترسی MCP قابلیت پلن Pro است.
  • انتخاب حساب صریح است. اگر در درخواستتان نام حساب نیاید، عامل یکی را از فهرست حل می‌کند و ادامه می‌دهد، و پنجره تأیید هم اشاره‌ای نمی‌کند که کدام را برداشته.
  • عمق تاریخچه تابع سیاست نگهداری خود تلگرام است نه اِنترگرام، پس یک گروه پرترافیک با سال‌ها انباشت، همه‌اش را در یک مرحله تحویل نمی‌دهد. پرسش‌هایی که با بازه تاریخ محدود شده‌اند پاسخ‌های بهتری از پرسش‌های بی‌مرز می‌گیرند.

رفع اشکال connector Cline

پنل MCP Servers وضعیت Disconnected نشان می‌دهد
به‌جای نصب دوباره هر چیزی، از دکمه Restart Server روی همان مدخل استفاده کنید. Cline به‌ازای هر سرور یک اتصال نگه می‌دارد و بعد از قطع شبکه یا بیدارشدن لپ‌تاپ از خواب، خودش دوباره تلاش نمی‌کند.
Cline برای تک‌تک خواندن‌ها اجازه می‌گیرد
این رفتار پیش‌فرض است. مدخل سرور را در پنل MCP Servers باز کنید و ابزارهای فقط‌خواندنی‌ای را که از تأییدکردنشان خسته شده‌اید به فهرست تأیید خودکارش منتقل کنید، و ارسال‌ها، ویرایش‌ها و حذف‌ها را بیرون بگذارید.
بعد از ویرایش دستی فایل تنظیمات هیچ چیز ظاهر نمی‌شود
یک ویرگول اضافه در انتها یا یک کاراکتر سرگردان کل سند را نامعتبر می‌کند و Cline به‌جای اعتراض، به یک فهرست سرور خالی عقب می‌نشیند. JSON را از یک اعتبارسنج رد کنید، بعد پنجره VS Code را reload کنید تا میزبان افزونه دوباره بخواندش.
یک کار وسط راه بدون خطا متوقف شد
یا یک پنجره تأیید بی‌جواب مانده یا پنجره وسط اجرا reload شده. Cline کارها را بین راه‌اندازی‌ها از سر نمی‌گیرد — اجرا را دوباره شروع کنید تا بر اساس وضعیت فعلی گفت‌وگوهای شما از نو نقشه بکشد.
پاسخ از حساب تلگرام اشتباهی رفت
از Cline بخواهید entergram_list_accounts را صدا بزند و بعد نام حساب را داخل خود درخواست بگذارید. وقتی حساب ضمنی باشد عامل یکی را انتخاب می‌کند و پنجره تأیید این انتخاب را نشان نمی‌دهد.
بلافاصله بعد از یک اتصال تمیز، ابزارها 403 می‌دهند
مجوز گرفته شده و دسترسی‌ها نه. عامل شخصی نمی‌تواند پیام بفرستد یا فیلدهای سفارشی عضو دیگری را بنویسد؛ اگر اجرا واقعاً به این‌ها نیاز دارد، از یک owner یا admin یک connector فضای کاری بخواهید.

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

چطور یک سرور MCP به Cline اضافه کنم؟
تنظیمات MCP در Cline (فایل cline_mcp_settings.json) را باز کنید، آدرس MCP اِنترگرام را اضافه کنید و از طریق OAuth دسترسی بدهید.
آیا این یک ربات تلگرام است؟
نه. اِنترگرام حساب شخصی واقعی تلگرام شما را از طریق یک سرور MCP میزبانی‌شده وصل می‌کند.
آیا امن است؟
بله. OAuth 2.0 با دسترسی‌های محدودشده؛ اطلاعات ورود شما هرگز به سازنده ویرایشگر نمی‌رسد و دسترسی قابل لغو است.