איך לחבר את Google Gemini לצ'אטים שלכם ב-Telegram

כדי לחבר את Google Gemini לצ'אטים שלכם ב-Telegram, רושמים את שרת ה-MCP המתארח של Entergram, https://mcp.entergram.com/mcp, ב-Gemini CLI, ומתחברים ל-Entergram פעם אחת בדפדפן. מאותו רגע Gemini יכול לקרוא את הצ'אטים, אנשי הקשר ונתוני ה-CRM שלכם דרך חשבון ה-Telegram האישי והאמיתי שלכם, ולפעול עליהם בתוך היקפי ההרשאות (scopes) שנתתם. ההגדרה כוללת שלושה שלבים ובלוק JSON קטן אחד, שמופיעים בהמשך.

ה-Gemini CLI הוא המסלול שמתועד במלואו בעמוד Gemini Telegram MCP. כל לקוח אחר שתומך ב-MCP ומריץ מודל Gemini יכול להשתמש באותה כתובת, ולרשום אותה בדרך שהלקוח הזה מצפה לה.

• סביבת עבודה בתוכנית Pro. API & MCP היא יכולת של תוכנית Pro. בתוכנית נמוכה יותר ה-CLI עדיין יציג את השרת, אבל כל קריאה תידחה. זה נראה כמו הגדרה שבורה, אבל זה לא.
• לפחות חשבון Telegram מחובר אחד במושב שלכם. מחבר אישי יכול להשתמש רק בחשבונות ה-Telegram שמופיעים תחת Settings → Accounts עבור המשתמש שלכם.
• דפדפן במחשב להתחברות הראשונה. מסך ההסכמה דורש דפדפן, ולכן שרת בלי ממשק גרפי צריך לקבל הרשאה קודם מתחנת עבודה.

שלב 1: העתיקו את כתובת ה-MCP שלכם ב-Entergram

היכנסו ל-Settings → Workspace → Connectors → MCP והעתיקו את כתובת שרת ה-MCP. היא זהה לכל הלקוחות:

https://mcp.entergram.com/mcp

שלב 2: רשמו את השרת ב-Gemini CLI

הוסיפו את Entergram תחת mcpServers בקובץ ~/.gemini/settings.json. מכיוון שזה שרת HTTPS מרוחק, המפתח הוא httpUrl, ולא רשומה של פקודה וארגומנטים:

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

הקובץ בתיקיית הבית שלכם חל על כל פרויקט באותו מחשב. כדי להגביל את הגישה ל-Telegram למאגר אחד, שימו את אותו בלוק בקובץ .gemini/settings.json בתוך המאגר הזה.

שלב 3: הפעילו מחדש את ה-CLI ותנו הרשאה

ה-CLI קורא את ההגדרות שלו בזמן העלייה, אז צאו מהסשן לגמרי והפעילו אותו שוב. התחברו ל-Entergram בחלון הדפדפן שנפתח ותנו את היקפי ההרשאות שאתם רוצים ש-Gemini יקבל. שום דבר ב-settings.json הוא לא פרטי גישה: הקובץ רק אומר איפה השרת נמצא, והגישה מגיעה מההתחברות דרך OAuth.

אחרי מתן ההרשאה, הציגו ב-CLI את רשימת שרתי ה-MCP הרשומים, וכלי Entergram יופיעו תחת entergram.

מה ש-Gemini יכול לעשות תלוי בסוג הלקוח שאתם מאשרים, כפי שמתואר בעמוד העזרה על מחברי MCP:

סוכן אישי לא יכול לשלוח הודעות Telegram. אם קריאות עובדות ושליחות נדחות, זה גבול ההרשאות ולא שגיאה. בעלים או מנהל צריכים לאשר מחבר סביבת עבודה, ואז מריצים שוב את תהליך ההסכמה מולו. בכל מקרה, תנו את סט ההרשאות הקטן ביותר שהמשימה צריכה: messages.write מאפשר לסוכן לשלוח הודעות בשמכם.

כדי לנתק את הגישה, בטלו את הלקוח ב-Entergram תחת Settings → Workspace → Connectors → MCP. מחיקת הרשומה ב-mcpServers רק עוצרת את ה-CLI מלקרוא לשרת; היא לא מבטלת את ההרשאה.

שרת ה-MCP של Entergram מתחבר לחשבון Telegram האישי שלכם, לא לבוט, ולכן Gemini עובד עם אותם צ'אטים שאתם רואים. פרומפטים שעובדים טוב ב-CLI:

• "באילו צ'אטים יש שאלות שלא נענו בשלושת הימים האחרונים?"
• "תן לי רשימה של אנשי הקשר בקבוצת הלקוחות שלי שלא נמצאים בקבוצת הקהילה."
• "פרסם את הערות הגרסה מ-CHANGELOG.md בערוץ הבטא." (דורש מחבר סביבת עבודה)
• "הייתה לי טעות הקלדה במספר הגרסה בהודעה ההיא, תקן אותה." (דורש מחבר סביבת עבודה)
• "תן לי את מספר הטיקטים השבוע לפי אחראי, בפורמט TSV."

ה-CLI מדפיס כל קריאת כלי שהוא מבצע, כך שאפשר לראות איך זה עובד במשימה של קריאה בלבד לפני שסומכים עליו בפעולת כתיבה.

• כלי הודעות דורשים חשבון מפורש. אין ברירת מחדל מרומזת, ולכן סקריפט צריך קודם לקבל את רשימת החשבונות ולהעביר הלאה את מזהה החשבון.
• שום דבר לא מגיע בלי בקשה. MCP עובד בשיטת בקשה ותגובה. Gemini יודע על הודעה חדשה רק כשאתם, או משימה מתוזמנת שלכם, מבקשים ממנו לבדוק.
• אין גישה מורחבת. Gemini רואה בדיוק את מה שחשבונות ה-Telegram המחוברים שלכם רואים. קבוצה שעזבתם היא קבוצה שהוא לא יכול לקרוא, וצ'אטים שהחרגתם תחת Accounts → Exclude chats לא מופיעים בתוצאות ה-MCP.

• השרת לא מופיע ברשימת ה-MCP. בדרך כלל זה JSON פגום: פסיק מיותר אחד בסוף גורם ל-CLI להתעלם מכל קובץ ההגדרות. ודאו שהרשומה משתמשת ב-httpUrl ונמצאת בתוך mcpServers.
• שינויים ב-settings.json לא משפיעים. צאו מהסשן לגמרי והפעילו מחדש. תהליך שרץ שומר את רשימת הכלים שבנה בזמן העלייה.
• זה עובד בתיקייה אחת ולא באחרת. יש לכם שני קובצי הגדרות. בדקו אם הרשומה entergram נמצאת ב-~/.gemini או בתיקייה .gemini של מאגר מסוים.
• כל קריאה מחזירה 403. בדקו קודם את התוכנית (MCP דורש Pro), ואחר כך את התפקיד: כל דבר מעבר לסט ההרשאות של סוכן אישי דורש בעלים או מנהל.

שרת ה-MCP של Entergram זהה לכל הלקוחות. הגדירו אותו פעם אחת, ותוכלו לחבר את לקוח ה-AI שאתם מעדיפים, או כמה מהם:

• חיבור Claude ל-Telegram דרך Entergram
• חיבור ChatGPT ל-Telegram דרך Entergram
• חיבור כל כלי AI ל-Telegram MCP

לרשימת הכלים המלאה של Gemini, דוגמאות להיקף פרויקט ומשימות מתוזמנות, ראו את עמוד Gemini Telegram MCP. כדי להבין מה השרת עושה בכל הלקוחות, התחילו בעמוד שרת Telegram MCP.