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

Claude · Anthropic

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

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

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

Claude از طریق connectorهای سفارشی از Model Context Protocol (MCP) پشتیبانی می‌کند. اِنترگرام حساب شخصی تلگرام شما را به‌صورت یک سرور MCP میزبانی‌شده در دسترس قرار می‌دهد، تا Claude گفت‌وگوهای واقعی شما را بخواند و روی آن‌ها عمل کند — با امنیت کامل OAuth، بدون حساب ربات، بدون کدنویسی و بدون اینکه هرگز شماره تلفن یا کلیدهای API شما را در اختیار بگیرد.

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

claude_desktop_config.json — or run `claude mcp add`
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

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

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

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

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

در Claude (وب و دسکتاپ) و Claude Code کار می‌کند.

  1. 01

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

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

  2. 02

    افزودن connector در Claude

    در Claude به مسیر Settings → Connectors → Add custom connector بروید و آدرس MCP اِنترگرام را وارد کنید: https://mcp.entergram.com/mcp. در Claude Code، همان آدرس را با دستور `claude mcp add` اجرا کنید.

  3. 03

    تأیید دسترسی و شروع پرسیدن

    روی Connect کلیک کنید، با حساب اِنترگرام خود وارد شوید و روی Allow access کلیک کنید تا connector فعال شود — Claude بلافاصله می‌تواند روی گفت‌وگوها، مخاطبین، تیکت‌ها و آمار شما استدلال کند.

connector اِنترگرام در کدام نسخه‌های Claude کار می‌کند

Claude وب و دسکتاپ

مسیر اصلی و همانی که بیشتر آدم‌ها دنبالش هستند. Settings → Connectors → Add custom connector را باز کنید، آدرس را جای‌گذاری کنید و Connect را بزنید. روی پلن‌های Free، Pro، Max، Team و Enterprise در دسترس است — Claude کانکتورهای سفارشی را پشت پلن پولی قفل نکرده، پس می‌توانید پیش از هر تعهدی همین را روی یک حساب رایگان امتحان کنید.

Claude Code

همان سرور میزبانی‌شده را به CLI اضافه کنید تا عامل ترمینالتان بتواند بین دو build تلگرام را غربال کند — مثلاً وقتی یک deploy تمام می‌شود و باید خبرش به یک گروه مشتری برسد.

claude mcp add --transport http entergram https://mcp.entergram.com/mcp

Claude Agent SDK

دارید عامل خودتان را روی Claude می‌سازید؟ اِنترگرام را در پیکربندی سرورهای MCP در SDK اعلام کنید تا عامل شما همان ۷۰ ابزار را به ارث ببرد، با همان صفحه رضایت OAuth برای هر کسی که اجرایش می‌کند.

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

وقتی می‌پرسید، پشت صحنه چه می‌گذرد

Claude دسترسی خام به پایگاه داده نمی‌گیرد — ابزارهای ساخت‌یافته را صدا می‌زند، همان‌هایی که خودتان به‌صورت برنامه‌نویسی صدا می‌زدید. این هم نگاشت میان یک پرسش به زبان ساده و فراخوانی‌هایی که پشتش می‌نشینند.

شما می‌پرسید

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

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

entergram_list_accountsentergram_list_live_chatsentergram_list_messages

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

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

شما می‌پرسید

«کدام مخاطبان VIP در ۲۴ ساعت گذشته از ما جوابی نگرفته‌اند؟»

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

entergram_list_custom_columnsentergram_list_contactsentergram_list_messages

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

اول شمای CRM شما را می‌خواند تا ستون VIP را پیدا کند، مخاطبین را بر اساس همان مقدار فیلتر می‌کند و بعد نگاه می‌کند آخرین پیام هر رشته ورودی بوده یا خروجی. فهرستی با مدت انتظار هرکدام می‌گیرید — و می‌توانید ادامه بدهید با «برای هرکدام یک پیام احوال‌پرسی پیش‌نویس کن».

شما می‌پرسید

«برای گفت‌وگو با Lena یک تیکت صورت‌حساب با اولویت بالا باز کن و به پشتیبانی بسپار.»

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

entergram_list_chatsentergram_create_ticketentergram_list_ticket_custom_columns

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

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

شما می‌پرسید

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

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

entergram_list_messagesentergram_get_chat_custom_fieldsentergram_patch_chat_custom_fields

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

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

شما می‌پرسید

«میانگین زمان اولین پاسخ ما این هفته چقدر بود، به تفکیک عضو تیم؟»

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

entergram_list_workspace_chatsentergram_list_messagesentergram_list_members

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

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

شما می‌پرسید

«روی رشته Acme یک یادداشت داخلی بگذار که کار را کجا رها کردیم.»

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

entergram_list_chatsentergram_create_chat_comment

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

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

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

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

همه ابزارهایی که Claude تحویل می‌گیرد

تأیید connector یعنی ۷۰ ابزار در ۹ گروه در اختیار Claude. این کل سطح در دسترس است — چیزی پشت پلن بالاتر پنهان نشده، هرچند اینکه هر اتصال در عمل چه چیزی را می‌تواند صدا بزند، به سطح دسترسی‌ای بستگی دارد که پایین‌تر توضیح داده‌ایم.

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

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

در عمل به چه چیزی مجوز می‌دهید

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

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

کارهایی که از این connector برنمی‌آید

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

  • به پلن Pro نیاز دارد. دسترسی MCP در اِنترگرام قابلیت پلن Pro است — connector تأیید می‌شود، اما در پلن‌های پایین‌تر فراخوانی ابزارها شکست می‌خورد.
  • عامل پس‌زمینه نیست. Claude فقط تا وقتی با آن در گفت‌وگو هستید عمل می‌کند؛ چیزی طبق زمان‌بندی اجرا نمی‌شود مگر خودتان از Claude Code یا Agent SDK راهش بیندازید.
  • ارسال به‌ازای هر حساب محدود است. فراخوانی «برای همه بفرست» وجود ندارد — هر ابزار پیام به یک account_id صریح نیاز دارد، پس یک اشتباه نمی‌تواند در همه حساب‌های متصلتان پخش شود.
  • گفت‌وگویی را که خودتان نمی‌توانید بخوانید، او هم نمی‌خواند. connector دقیقاً دسترسی‌های تلگرام شما را به ارث می‌برد؛ همان را می‌بیند که شما می‌بینید و هیچ چیز از گروهی که هرگز عضوش نبوده‌اید.
  • عمق تاریخچه پیام‌ها تابع محدودیت‌های خود تلگرام است، نه اِنترگرام — تاریخچه خیلی قدیمی یک گروه بزرگ ممکن است در یک مرحله قابل بازیابی نباشد.
  • نوشتن روی فیلد سفارشی وقتی ممکن است که ساختارش از قبل موجود باشد. Claude می‌تواند یک ستون pipeline را پر کند، اما ستونی که در فضای کاری شما نیست نمی‌سازد، مگر اینکه یک connector فضای کاری بدهید.

رفع اشکال connector Claude

Claude می‌گوید آدرس نامعتبر است
آدرس سرور MCP را دوباره از Settings → Workspace → Connectors → MCP کپی کنید و حواستان به فاصله انتهایی باشد — جای‌گذاری از دل یک پیام چت معمول‌ترین مقصر است. این آدرس برای همه کاربران و همه اپ‌ها یکسان است: https://mcp.entergram.com/mcp
صفحه ورود اِنترگرام اصلاً بالا نمی‌آید
Claude صفحه رضایت را در یک پنجره بازشو باز می‌کند. پنجره‌های بازشو را برای claude.ai مجاز کنید، مطمئن شوید در همان مرورگر از قبل به اِنترگرام وارد شده‌اید و بعد دوباره Connect را بزنید.
ابزارها خطای 403 برمی‌گردانند
دو علت دارد. یا حساب اِنترگرام شما دسترسی owner/admin لازم برای یک connector فضای کاری را ندارد — که در آن صورت به‌جایش یک عامل شخصی بسازید — یا پلن شما شامل دسترسی MCP نیست، که قابلیت پلن Pro است.
Claude هیچ ابزار اِنترگرامی نشان نمی‌دهد
connector تأیید شده اما فهرست ابزارها تازه نشده. در Settings → Connectors آن را خاموش و دوباره روشن کنید، یا یک گفت‌وگوی تازه باز کنید — Claude فهرست ابزارها را در آغاز هر گفت‌وگو می‌خواند.
روی حساب تلگرام اشتباهی عمل می‌کند
از Claude بخواهید entergram_list_accounts را صدا بزند و در درخواستتان صریحاً نام حساب را بیاورید. هیچ چیز میان حساب‌ها سراسری نیست، پس account_id مشخص‌نشده یعنی خودش یکی را برایتان انتخاب کرده.
بعد از مدتی اتصال قطع می‌شود
توکن‌های OAuth منقضی می‌شوند. در Claude دوباره Connect را بزنید و دسترسی را از نو تأیید کنید — لازم نیست آدرس را دوباره کپی کنید.

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

آیا با Claude Code کار می‌کند؟
بله. Claude Code از سرورهای MCP پشتیبانی می‌کند — آدرس MCP اِنترگرام را با `claude mcp add` اضافه کنید و از طریق OAuth دسترسی بدهید. همین connector در اپ‌های دسکتاپ و وب Claude هم کار می‌کند.
آیا این یک ربات تلگرام است؟
نه. اِنترگرام حساب شخصی واقعی تلگرام شما را از طریق یک سرور MCP میزبانی‌شده وصل می‌کند، پس Claude همان گفت‌وگوهایی را می‌بیند که شما می‌بینید — نه یک حساب ربات جداگانه.
واقعاً می‌تواند بگوید کدام پیام‌ها را از دست داده‌ام؟
بله. چون Claude می‌تواند هم‌زمان همه گفت‌وگوهای متصلتان را بخواند، می‌تواند پیام‌های خوانده‌نشده و بی‌پاسخ را بشمارد، آن‌ها را بر اساس مدت انتظارشان رتبه‌بندی کند و پیام‌های مشتری‌ها و سرنخ‌ها را علامت بزند.
آیا امن است؟
بله. این اتصال از OAuth 2.0 با دسترسی‌های محدودشده استفاده می‌کند. شما دقیقاً تعیین می‌کنید Claude به چه چیزی دسترسی داشته باشد، اطلاعات ورود شما هرگز به دست Claude نمی‌رسد و هر زمان می‌توانید دسترسی را لغو کنید.