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

Cursor، Zed و Windsurf

اتصال تلگرام به Cursor و ویرایشگرها

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

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

Cursor، Zed و Windsurf همگی از سرورهای MCP از طریق یک پیکربندی mcp.json پشتیبانی می‌کنند. اِنترگرام حساب شخصی تلگرام شما را به‌صورت یک سرور MCP میزبانی‌شده در دسترس قرار می‌دهد، تا هوش مصنوعی ویرایشگرتان با امنیت OAuth روی گفت‌وگوهای واقعی شما عمل کند — بدون ربات و بدون کلید API.

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

mcp.json (Cursor / Zed / Windsurf)
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

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

با اتصال حساب شخصی، هوش مصنوعی IDE شما می‌تواند بدون اینکه اپ عوض کنید تلگرام را بررسی کند. امتحان کنید:

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

اتصال ویرایشگرتان در ۳ گام

با Cursor، Zed و Windsurf کار می‌کند.

  1. 01

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

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

  2. 02

    افزودن سرور به mcp.json

    در تنظیمات MCP ویرایشگرتان (mcp.json)، آدرس MCP اِنترگرام را ثبت کنید: https://mcp.entergram.com/mcp.

  3. 03

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

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

سه ویرایشگر، سه فایل پیکربندی

Cursor — ~/.cursor/mcp.json

Cursor سرورها را برای همه پروژه‌هایی که باز می‌کنید از ~/.cursor/mcp.json می‌خواند، یا از .cursor/mcp.json که داخل خود مخزن commit شده باشد وقتی می‌خواهید سرور فقط برای همان کدبیس در دسترس باشد. مسیر منویی‌اش Cursor Settings → MCP & Integrations → New MCP server است که همان فایل را برایتان می‌نویسد. یک مدخل در سطح پروژه بار اول که عامل سراغش برود اعتماد شما را می‌خواهد، پس هم‌تیمی‌ای که مخزن را pull می‌کند هم انتخاب آگاهانه‌ای می‌کند.

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

Zed — ~/.config/zed/settings.json

Zed سرورهای MCP را به‌جای بلوک mcpServers زیر بلوک context_servers در فایل تنظیمات اصلی‌اش نگه می‌دارد، و همین یک کلمه بیشترِ تلاش‌های اول را خراب می‌کند: قطعه Cursor را عیناً جای‌گذاری کنید و هیچ چیز بار نمی‌شود، آن هم بدون هیچ خطایی که علتش را بگوید. صفحه تنظیمات Agent Panel یک دکمه Add Custom Server دارد که اگر نمی‌خواهید JSON را دستی ویرایش کنید، شکل درست را برایتان می‌نویسد.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

Windsurf به‌جای تنظیمات ویرایشگر که شاید انتظارش را داشته باشید، یک فایل اختصاصی زیر ~/.codeium می‌خواند و Cascade فقط وقتی بخواهید دوباره اسکنش می‌کند: بعد از ذخیره، پنل MCP را در Cascade باز کنید و refresh بزنید، وگرنه ابزارها تا راه‌اندازی بعدی نامرئی می‌مانند. شکل خود JSON با Cursor یکی است، پس مدخل میان این دو قابل جابه‌جایی است.

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

از stack trace تا آدمی که فرستاده‌اش

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

شما می‌پرسید

«یکی یک TypeError از صفحه صورت‌حساب برایمان فرستاده. پیامش را پیدا کن و بگو چه کسی گزارشش کرده.»

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

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

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

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

شما می‌پرسید

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

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

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

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

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

شما می‌پرسید

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

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

entergram_list_chatsentergram_list_messagesentergram_get_message

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

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

شما می‌پرسید

«این مراحل بازتولید را روی تیکت این باگ بگذار.»

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

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

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

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

شما می‌پرسید

«کسی که این را ثبت کرده روی کدام پلن است و تا حالا چه به او گفته‌ایم؟»

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

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

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

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

شما می‌پرسید

«اصلاح merge شد. به آن دو نفری که گزارشش کردند خبر بده و تیکت را ببند.»

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

entergram_list_accountsentergram_send_messageentergram_update_ticket

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

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

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

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

۷۰ ابزاری که ویرایشگرتان برمی‌دارد

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

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

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

چه چیزی در فایل پیکربندی می‌ماند و چه چیزی نه

مدخلی که در mcp.json جای‌گذاری می‌کنید دقیقاً یک چیز دارد: یک آدرس. نه توکن، نه شماره تلفن، نه کلید API — و برای همین است که یک .cursor/mcp.json در سطح پروژه را می‌شود بی‌خطر کنار کدی که به آن خدمت می‌کند commit کرد. خود مجوز در مرورگر داده می‌شود، به شما تعلق دارد نه به مخزن، و ویرایشگر نگهش می‌دارد. برای پس‌گرفتنش، اتصال را از صفحه MCP در مسیر Settings → Workspace → Connectors در اِنترگرام لغو کنید؛ توکنی که ویرایشگر در دست دارد از فراخوانی بعدی از کار می‌افتد. دو سطح دسترسی وجود دارد و جای هم را نمی‌گیرند.

عامل شخصی
هر عضو می‌تواند برای خودش یکی صادر کند و روی یک لپ‌تاپ توسعه معمولاً سقف درستی است. در سراسر فضای کاری، حساب‌ها، مخاطبین، گفت‌وگوها، پیام‌ها و تیکت‌ها می‌خواند و فقط روی فیلدهای سفارشی گفت‌وگوهای متعلق به حساب‌های متصل خودتان می‌نویسد. عاملی که این را در دست دارد می‌تواند یک باگ را تا ته بکاود و نمی‌تواند به کسی که گزارشش کرده پیام بدهد.
connector فضای کاری
مخصوص owner و admin. کل مجموعه دسترسی‌ها را دارد — ارسال، نوشتن فیلد سفارشی روی هر گفت‌وگو، مدیریت گروه — و به‌جای اینکه مال یک توسعه‌دهنده باشد با تیم به اشتراک گذاشته می‌شود. وقتی ویرایشگر دارد از طرف شرکت کار می‌کند نه از طرف شما، سراغ همین بروید.
لغو دسترسی
از هر دو سو کار می‌کند و بی‌درنگ اثر می‌گذارد. حذف سرور از mcp.json جلوی پرسیدن ویرایشگر را می‌گیرد؛ لغو در اِنترگرام جلوی پاسخ‌گرفتنش را. وقتی لپ‌تاپ دیگر دست شما نیست، دومی همان است که اهمیت دارد.

یکپارچگی با ویرایشگر کجا تمام می‌شود

پیش از آنکه عادتی حولش بسازید، دانستنش می‌ارزد.

  • دسترسی MCP روی پلن Pro است و هیچ چیز در سمت ویرایشگر این را عوض نمی‌کند — فضای کاری پایین‌تر از آن می‌تواند سرور را ثبت کند، ورود را کامل کند و باز هم از یک فراخوانی چیز به‌دردبخوری نگیرد.
  • هیچ چیز خودبه‌خود نمی‌رسد. ویرایشگر فقط داخل نوبتی که خودتان شروع کرده‌اید از اِنترگرام پرس‌وجو می‌کند، پس پیامی که وسط یک refactor می‌رسد بی‌صدا منتظر می‌ماند تا دفعه بعد سراغش بروید.
  • پیکربندی به‌ازای هر ماشین است. mcp.json با حساب ویرایشگر شما سفر نمی‌کند و مجوز OAuth هم همین‌طور — لپ‌تاپ دوم یعنی فایل دوم و صفحه رضایت دوم.
  • خروجی ابزارها در همان گفت‌وگو می‌ماند. عامل می‌تواند لاگ یک مشتری را در یک کامنت یا یک fixture نقل کند، اما فقط وقتی که بخواهید در فایل‌های شما می‌نویسد، و هرگز در جهت عکس.
  • هر ارسال یک حساب را نام می‌برد. account_id یک آرگومان اجباری است نه یک پیش‌فرض، پس عاملی که شاخه اشتباه را انتخاب می‌کند نمی‌تواند سرخود سر از پیام‌دادن به کل فهرست مخاطبین شما دربیاورد.
  • connector دقیقاً همان را می‌بیند که حساب تلگرام شما می‌بیند. گروهی که هرگز به آن اضافه نشده‌اید از ویرایشگر هم نامرئی می‌ماند، هر جور که درخواست را بنویسید.

وقتی ویرایشگر اِنترگرام را نمی‌بیند

سرور در پنل MCP در Cursor نقطه قرمز نشان می‌دهد
Cursor فهرست ابزارها را از آخرین دست‌دادن موفق کش می‌کند. در Cursor Settings → MCP & Integrations سرور را خاموش و روشن کنید، و اگر نقطه قرمز ماند پنجره را reload کنید — عامل فهرست را موقع بالا آمدن پنجره می‌خواند، نه وقتی فایل را ویرایش می‌کنید.
Zed مدخل را کاملاً نادیده می‌گیرد
تقریباً حتماً mcpServers نوشته‌اید. کلید Zed برابر context_servers است و یک کلید سطح‌بالای ناشناخته به‌جای گزارش‌شدن به‌عنوان خطا، بی‌صدا حذف می‌شود. نام کلید را اصلاح کنید، ذخیره کنید و Zed را دوباره راه بیندازید.
Windsurf بعد از ذخیره هیچ ابزار اِنترگرامی نشان نمی‌دهد
مطمئن شوید ~/.codeium/windsurf/mcp_config.json را ویرایش کرده‌اید نه رابط تنظیمات را، بعد پنل MCP را در Cascade باز کنید و refreshش کنید. Windsurf آن فایل را وقتی می‌خوانید که بخواهید، نه زودتر.
صفحه رضایت باز می‌شود ولی ویرایشگر همچنان قطع است
مجوزدهی در همان مرورگری تمام می‌شود که سیستم‌عامل شما به‌صورت پیش‌فرض باز می‌کند. ورود را همان‌جا و در حالی که در همان پروفایل به اِنترگرام وارد شده‌اید کامل کنید، بعد برگردید و یک‌بار دیگر اتصال را بزنید.
عامل درباره تلگرام جواب می‌دهد بدون اینکه چیزی صدا بزند
سرورهای ثبت‌شده زیادی دارید و فهرست ابزارها پیش از رسیدن به مدل هرس می‌شود. سرورهای MCPی را که برای این کار لازم ندارید غیرفعال کنید و در درخواستتان نام اِنترگرام را بیاورید تا انتخاب بی‌ابهام باشد.
فراخوانی‌ها 403 برمی‌گردانند
به‌ترتیب دو چیز را بررسی کنید. نقشتان: connector فضای کاری به owner یا admin نیاز دارد و عامل شخصی بقیه را پوشش می‌دهد. بعد پلنتان: دسترسی MCP روی Pro است و پلن پایین‌تر به‌جای زمان اتصال، همین‌جا شکست می‌خورد.

پرسش‌های متداول Cursor / Zed / Windsurf و تلگرام

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

اتصال تلگرام به Cursor و ویرایشگرها