چگونه گوگل جمینای را به چت‌های تلگرام خود متصل کنیم

گوگل جمینای را با ثبت سرور MCP میزبانی‌شده اینترگرام، یعنی https://mcp.entergram.com/mcp، در Gemini CLI و یک بار ورود به اینترگرام در مرورگر به چت‌های تلگرام خود متصل می‌کنید. پس از آن، جمینای می‌تواند چت‌ها، مخاطبین و داده‌های CRM شما را از طریق حساب شخصی واقعی تلگرامتان بخواند و در محدوده مجوزهایی که داده‌اید روی آن‌ها اقدام کند. راه‌اندازی سه گام و یک بلوک کوچک JSON دارد که در ادامه آمده است.

Gemini CLI همان مسیری است که صفحه MCP تلگرام برای جمینای به‌طور کامل مستند می‌کند. هر کلاینت دیگر سازگار با MCP که یک مدل جمینای را اجرا می‌کند نیز می‌تواند از همین آدرس استفاده کند، به هر شکلی که آن کلاینت برای ثبت سرور انتظار دارد.

• یک فضای کاری Pro. API و MCP قابلیت پلن Pro هستند. در پلن پایین‌تر، CLI همچنان سرور را فهرست می‌کند، اما همه فراخوانی‌ها رد می‌شوند. این شبیه یک پیکربندی خراب به نظر می‌رسد، ولی نیست.
• دست‌کم یک حساب تلگرام متصل روی صندلی (seat) شما. یک کانکتور شخصی فقط می‌تواند از حساب‌های تلگرامی استفاده کند که در Settings → Accounts برای عضویت خود شما فهرست شده‌اند.
• یک مرورگر روی همان دستگاه برای نخستین ورود. صفحه رضایت به مرورگر نیاز دارد، بنابراین یک سرور بدون رابط گرافیکی باید ابتدا از یک ایستگاه کاری مجاز شود.

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

به Settings → Workspace → Connectors → MCP بروید و آدرس سرور MCP را کپی کنید. این آدرس برای همه کلاینت‌ها یکسان است:

https://mcp.entergram.com/mcp

گام ۲: سرور را در Gemini CLI ثبت کنید

اینترگرام را زیر mcpServers در فایل ~/.gemini/settings.json اضافه کنید. چون سرور از نوع HTTPS راه دور است، کلید مورد نیاز httpUrl است، نه یک ورودی شامل command و args:

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

فایلی که در پوشه خانگی شما قرار دارد روی همه پروژه‌های آن دستگاه اعمال می‌شود. اگر می‌خواهید دسترسی به تلگرام فقط در یک مخزن باشد، همین بلوک را در فایل .gemini/settings.json داخل همان مخزن قرار دهید.

گام ۳: CLI را دوباره اجرا و دسترسی را مجاز کنید

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

پس از مجاز شدن، سرورهای MCP ثبت‌شده را در CLI فهرست کنید تا ابزارهای اینترگرام زیر نام entergram نمایش داده شوند.

کارهایی که جمینای می‌تواند انجام دهد به نوع کلاینتی بستگی دارد که مجاز می‌کنید، همان‌طور که در صفحه راهنمای کانکتورهای MCP توضیح داده شده است:

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

برای قطع دسترسی، کلاینت را در اینترگرام از مسیر Settings → Workspace → Connectors → MCP لغو کنید. حذف ورودی mcpServers فقط مانع فراخوانی سرور توسط CLI می‌شود و مجوز اعطاشده را باطل نمی‌کند.

سرور MCP اینترگرام به حساب شخصی تلگرام شما متصل می‌شود، نه به یک ربات، بنابراین جمینای با همان چت‌هایی کار می‌کند که شما می‌بینید. درخواست‌هایی که در CLI به‌خوبی کار می‌کنند:

• «کدام چت‌ها در سه روز گذشته سؤال بی‌پاسخ دارند؟»
• «مخاطبانی را که در گروه مشتریان من هستند ولی در گروه کامیونیتی نیستند فهرست کن.»
• «یادداشت‌های انتشار را از CHANGELOG.md در کانال بتا منتشر کن.» (به کانکتور فضای کاری نیاز دارد)
• «شماره نسخه را در آن اطلاعیه اشتباه تایپ کردم، اصلاحش کن.» (به کانکتور فضای کاری نیاز دارد)
• «تعداد تیکت‌های این هفته را به تفکیک مسئول، به‌صورت TSV بده.»

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

• ابزارهای پیام به یک حساب مشخص نیاز دارند. هیچ حساب پیش‌فرض ضمنی وجود ندارد، بنابراین یک اسکریپت باید ابتدا فهرست حساب‌ها را دریافت کند و شناسه حساب را به فراخوانی‌ها بدهد.
• هیچ‌چیز بدون درخواست نمی‌رسد. MCP بر پایه درخواست و پاسخ کار می‌کند. جمینای فقط زمانی از یک پیام جدید باخبر می‌شود که شما، یا یک کار زمان‌بندی‌شده متعلق به خودتان، از آن بخواهید نگاه کند.
• هیچ دسترسی ویژه‌ای در کار نیست. جمینای دقیقاً همان چیزی را می‌بیند که حساب‌های تلگرام متصل شما می‌بینند. گروهی که از آن خارج شده‌اید گروهی است که جمینای نمی‌تواند بخواند، و چت‌هایی که در Accounts → Exclude chats مستثنا می‌کنید از نتایج MCP بیرون می‌مانند.

• سرور هرگز در فهرست MCP ظاهر نمی‌شود. معمولاً JSON خراب است: یک ویرگول اضافه در انتها باعث می‌شود CLI کل فایل تنظیمات را نادیده بگیرد. بررسی کنید که ورودی از httpUrl استفاده کند و داخل mcpServers باشد.
• تغییرات settings.json ظاهراً اثری ندارند. از نشست کاملاً خارج شوید و دوباره اجرا کنید. فرایندی که در حال اجراست فهرست ابزارهایی را که هنگام شروع ساخته نگه می‌دارد.
• در یک پوشه کار می‌کند و در پوشه دیگر نه. دو فایل تنظیمات دارید. بررسی کنید ورودی entergram در ~/.gemini است یا در پوشه .gemini یک مخزن.
• هر فراخوانی خطای 403 برمی‌گرداند. ابتدا پلن را بررسی کنید (MCP به Pro نیاز دارد)، سپس نقش را: هر چیزی فراتر از مجوزهای عامل شخصی به مالک یا ادمین نیاز دارد.

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

• اتصال Claude به تلگرام از طریق اینترگرام
• اتصال ChatGPT به تلگرام از طریق اینترگرام
• اتصال هر ابزار هوش مصنوعی به MCP تلگرام

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