רישום, בדיקה ופרסום של האפליקציה המקושרת

אחרי שמוודאים שכל התנאים המוקדמים מתקיימים, פועלים לפי השלבים הבאים כדי לרשום, להגדיר, לבדוק ולפרסם את האפליקציה המקושרת.

שלב 1: יוצרים אפליקציה מקושרת

כדי ליצור אפליקציה מקושרת:

  1. נכנסים אל Google Connected Console.
  2. בדף הבית, לוחצים על יצירת אפליקציה.
  3. בתיבת הדו-שיח בחירת מה שרוצים ליצור:
    • אם מתבקשים לאשר את התנאים וההגבלות של אפליקציות מקושרות, לוחצים על View terms, קוראים את ההסכם ומאשרים אותו, ואז לוחצים על Create. רק אדמין של החשבון יכול לאשר את ההסכם.
    • אם לא, לוחצים על יצירה בכרטיס אפליקציה מקושרת.

  4. בתיבת הדו-שיח צריך לתת שם לאפליקציה המקושרת, מקלידים שם לאפליקציה המקושרת. זה השם שיוצג למשתמשים במוצרי Google, והם יקלידו אותו אחרי @ כדי לתייג את האפליקציה. לוחצים על הבא.

  5. בתיבת הדו-שיח בחירת קטגוריית אפליקציות מקושרות, בוחרים את הדומיין, הקטגוריה או התחום של האפליקציה בתפריט בחירת קטגוריה.

  6. בתיבת הדו-שיח Choose connection type, בוחרים אחת מהאפשרויות הבאות:

    • שרת MCP: אתם יכולים לחבר שרת MCP כדי לספק את השירותים שלכם למשתמשי Gemini וחיפוש Google באינטרנט, ב-Android וב-iOS.
    • ‫Android MCP: היכולות במכשיר שלכם יהיו זמינות ל-Gemini ב-Android, כדי שהוא יוכל להפעיל פעולות ולהשלים משימות בשביל המשתמשים באפליקציה שלכם.

    איך מגדירים אפליקציה מקושרת ב-Android MCP. אפשר לבחור רק סוג חיבור אחד לכל אפליקציה מקושרת, ואי אפשר לשנות את הבחירה הזו בהמשך.

  7. לוחצים על Create Connected app (יצירת אפליקציה מקושרת).

הפעולה הזו פותחת את דף הסקירה הכללית של ניהול האפליקציה המקושרת (הגדרה ובדיקה של האפליקציה המקושרת), שבו אפשר להגדיר את פרטי האפליקציה, את החיבור לשרת MCP ואת הבודקים.

שלב 2: מזינים את פרטי האפליקציה המקושרת

כדי לספק פרטים נוספים על האפליקציה המקושרת ולהגדיר איך היא תופיע למשתמשים:

  1. בדף הסקירה הכללית של האפליקציה המקושרת, בשורה פרטי האפליקציה, לוחצים על שנתחיל? (או על ניהול אם מעדכנים פרטים קיימים).
  2. בחלק העליון של הדף פרטי האפליקציה, בודקים את השדה Connected app name. אם צריך, אפשר לעדכן את השם. השם הזה מוצג למשתמשים במוצרי Google, והם משתמשים בו כדי לתייג את האפליקציה באמצעות @.
  3. בקטע פרטים שגלויים לכולם, בקטע סמל, מעלים את סמל האפליקציה (בפורמט JPG או PNG, בגודל של עד 1MB ובמידות של ‎512 x 512 פיקסלים).

  4. ממלאים את השדות הבאים:

    • תיאור: מזינים סיכום תמציתי במשפט אחד (עד 30 מילים) שמתאר את התכונות העיקריות של האפליקציה המקושרת ואת מה שהיא יכולה לעשות. הטקסט הזה מוצג למשתמשים, והוא לא משמש כהוראות למודל.
    • יכולות: מזינים לפחות שלוש משימות חשובות שהאפליקציה המקושרת יכולה לבצע. כדי להוסיף עוד רשומות, לוחצים על Add capability. אל תכללו מספרים בתחילת ההצהרות על יכולות. צריך לכלול רק יכולת אחת בכל רשומה. אם הקטגוריה כוללת יכולות מוגדרות מראש, הן מופיעות בראש הרשימה ואי אפשר לשנות אותן.
    • הנחיות לדוגמה: הזינו לפחות שלוש הנחיות לדוגמה שיעזרו למשתמשים להבין מה הם יכולים לשאול. כדי להוסיף פריטים, לוחצים על הוספת הנחיה לדוגמה.
      • לפחות שתי הנחיות צריכות להתחיל ב-@<YourAppName> (לדוגמה, @Order Tracker where is my last order?).
      • תייגו את <YourAppName> באופן טבעי בפרומפט אחד לפחות בלי להתחיל עם שם האפליקציה (לדוגמה, Track my recent order on Order Tracker).
      • אל תכללו קידומות ממוספרות (1., 2., 3.) ואל תקיפו את ההנחיות במירכאות ("...").

    • לוקליזציה בכמה שפות: כדי לספק תרגומים לתיאור, ליכולות ולהנחיות לדוגמה, צריך להקיף את הטקסט של כל לוקאל בתגי שפה בתוך השדה להזנת קלט. לדוגמה:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      מערכת Connected Console מאמתת את התגים באופן אוטומטי ומציגה את הלוקאלים שזוהו מתחת לכל שדה (לדוגמה, Found translations for 2 languages: en-US, es-ES).

    • כתובת ה-URL של התנאים וההגבלות: מזינים קישור תקין מסוג https:// או http:// לתנאים ולהגבלות.

    • כתובת ה-URL של המדיניות: מזינים קישור תקין מסוג https:// או http:// למדיניות הפרטיות.

    • כתובת האתר (אופציונלי): מזינים קישור לאתר שלכם לצורכי שיוך.

  5. לוחצים על שמירה בתחתית הדף כדי לחזור לדף הסקירה הכללית.

שלב 3: מזינים את נקודת הקצה של ה-MCP ומאמתים את הבעלות על הדומיין

כדי ש-Google תוכל להתחבר לשרת ה-MCP או לסנכרן את הכלים, אתם צריכים לספק את כתובת ה-URL של נקודת הקצה של שרת ה-MCP ולאמת את הבעלות על הדומיין שבו הוא מתארח.

כדי להזין את נקודת הקצה של ה-MCP ולאמת את הבעלות על הדומיין:

  1. בדף הסקירה הכללית של האפליקציה המקושרת, בכרטיס הגדרת MCP וכלים, לוחצים על שנתחיל? (או על ניהול אם מעדכנים פרטים קיימים). ייפתח שלב 1 (נקודות הקצה של שרת ה-MCP) בתהליך ההגדרה של ה-MCP.
  2. בקטע חיבור נקודת הקצה של שרת ה-MCP, מזינים את כתובת ה-URL המלאה מסוג HTTPS של נקודת הקצה של שרת ה-MCP (לדוגמה, https://api.yourdomain.com/v1/mcp).

  3. בקטע אימות הדומיין, משלימים את אימות אסימון האתגר של הדומיין (אם כבר אימתתם את הדומיין או את הדומיין הראשי שלו בחשבון הפיתוח, הוא יופיע באופן אוטומטי כמאומת):

    1. בכרטיס אימות הבעלות על הדומיין, לוחצים על הורדת טוקן. הדפדפן מוריד קובץ בשם google-connected-apps.json עם המבנה הבא:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. מעלים את תוכן ה-JSON הזה ומארחים אותו בשרת בכתובת https://<your-domain>/.well-known/google-connected-apps.

      • צריך לוודא שנקודת הקצה נגישה באופן ציבורי דרך HTTPS, מחזירה את HTTP 200 OK ישירות בלי הפניות אוטומטיות של HTTP וכוללת את האסימון בתוך המערך verification_tokens.

    3. חוזרים אל Google Connected Console ובוחרים באפשרות אימות הדומיין.

    4. אחרי שהאימות מצליח, בשורה Domain verified with challenge token מופיע סימן וי ירוק, והקטע Access credentials שמתחתיה נפתח.

שלב 4: הגדרת פרטי כניסה

אחרי אימות הדומיין, צריך להגדיר את אופן האימות של Google מול שרת ה-MCP ולאחזר את הגדרות הכלים של השרת.

כדי להגדיר את פרטי הכניסה:

  1. בקטע Provide access credentials (בשלב 1 בדף MCP and tools setup), לוחצים על Get started (או על Update credentials כדי לשנות הגדרה קיימת).

  2. בקטע Does your server require authorization?, בוחרים אחת מהאפשרויות הבאות:

    • לא: בוחרים באפשרות הזו אם שרת ה-MCP גלוי לכולם בלי אימות, ואז לוחצים על אישור.

    • כן: צריך לבחור באפשרות הזו אם אחד מהכלים שחשופים לשרת ה-MCP דורש הרשאה. אחר כך, בקטע בחירת מודל ההרשאה שבו משתמש שרת ה-MCP, בוחרים את תהליך האימות:

      • מכונה-למכונה (פרטי כניסה של לקוח OAuth): בוחרים באפשרות הזו לאימות בין שירותים (RFC 6749), שבו Google מתקשרת ישירות עם שרת ה-MCP באמצעות מזהה לקוח וסוד לקוח משותפים, בלי הפניות להתחברות של משתמשי קצה:
        1. מזינים את מזהה הלקוח (חובה) ואת סוד הלקוח (אופציונלי).
        2. אם השרת לא מפרסם את נקודת הקצה להרשאה (אופציונלי) ואת נקודת הקצה של הטוקן (אופציונלי) באמצעות /.well-known/oauth-authorization-server, אפשר להזין אותן.
        3. לוחצים על Register client (או Update client).

      • הקצאת הרשאות למשתמשים (קוד הרשאה): האפשרות הזו הכי מתאימה אם שרת ה-MCP דורש ממשתמשים פרטיים להתחבר ולאשר פעולות באמצעות החשבונות שלהם דרך קישור של חשבון Google:

        1. הוספת כתובות ה-URI להפניה אוטומטית של Google OAuth לרשימת ההיתרים: בבאנר Ensure you have allow listed the provided redirect URIs, לוחצים על View (או על סמל ההעתקה) כדי לבדוק את כתובות ה-URI המדויקות להפניה אוטומטית שנוצרו לאפליקציה המקושרת. מוסיפים אותן לרשימת ההיתרים של שרת ה-OAuth וחוזרים ל-Google Connected Console.
        2. בקטע בחירת אופן האימות של Google מול שרת OAuth, בוחרים איך לקוח OAuth רשום:
          • רישום מראש: צריך לבחור באפשרות הזו אם יוצרים מזהה לקוח וסוד לקוח (אופציונלי) סטטיים בספק ה-OAuth. אפשר גם לספק נקודת קצה מותאמת אישית של הרשאה (אופציונלי) ונקודת קצה מותאמת אישית של טוקן (אופציונלי).
          • מטא-נתונים של מזהה לקוח או Dynamic Client Registration (מומלץ): צריך לבחור באפשרות הזו אם השרת תומך ב-OAuth Client ID Metadata Documents (CIMD) או ב-Dynamic Client Registration (RFC 7591). ‫Google בודקת קודם את CIMD, ואם היא לא מוצאת, היא עוברת ל-DCR באמצעות נקודות הקצה של הגילוי ב-.well-known. אפשר גם לציין נקודות קצה מותאמות אישית של הרשאה וטוקן.

        3. בקטע Authenticate with your developer credentials, מכיוון שבחרתם במודל ההרשאה User-delegated, אתם צריכים להיכנס לשרת שלכם כדי ש-Google תוכל לאחזר כלים. בוחרים באחת מהאפשרויות הבאות:

          • אימות באמצעות חלון קופץ (מומלץ): תהליך האימות נפתח בתיבת דו-שיח בשכבת-על. זו חוויית השימוש שמוגדרת כברירת מחדל.
          • אימות באמצעות הפניה אוטומטית (חלופה): תהליך האימות נפתח באמצעות הפניה אוטומטית במסך מלא באותה כרטיסייה או באותו חלון. כדאי להשתמש באפשרות הזו אם תיבת הדו-שיח לא מוצגת בגלל אילוצי תצוגה או כותרות של תגובות HTTP שקשורות לאבטחה (כמו X-Frame-Options או Content-Security-Policy).

          מומלץ לנסות קודם לאמת באמצעות תיבת הדו-שיח. אם אתם לא מצליחים לבצע אימות באמצעות תיבת הדו-שיח, השתמשו בשיטת ההפניה האוטומטית. הבחירה שלכם גם קובעת את חוויית ההתחברות של המשתמשים בפעם הראשונה שהם משתמשים באפליקציה המקושרת.

        4. לוחצים על Register client (או Update client).

שלב 5: מספקים פרטים של חשבון לבדיקה (רק להרשאה בהקצאת משתמש)

אם האפליקציה המקושרת דורשת אימות, אתם צריכים לספק לנציג Google פרטי כניסה לבדיקה, שמאוכלסים מראש בנתונים לדוגמה שדומים לנתונים אמיתיים, כשהאימות הדו-שלבי (2FA) מושבת, וגם הוראות לבדיקה. כך צוות הבדיקה ובקרת האיכות של Google יכול לאמת את הפעלת הכלי בלי להיתקל בחסימות של ארגזי חול ריקים, חומות תשלום או אתגרי אימות דו-שלבי. אם Google לא תוכל לבדוק את האפליקציה המקושרת באופן מלא, יכול להיות שהיא תידחה במהלך הבדיקה.

שלב 6: מסנכרנים את הכלים

כדי ליצור כל גרסה של האפליקציה המקושרת, Google מסתנכרנת עם נקודת הקצה שסיפקתם כדי לקבל את הכלים הזמינים וליצור תמונת מצב. אלה הכלים שיהיו זמינים למשתמשים בגרסה הזו. בזמן שגרסת האפליקציה המקושרת נמצאת במצב טרום-השקה (Preview) וזמינה לבודקים, אתם יכולים להמשיך לבצע שינויים בשרת ולסנכרן מחדש את הכלים כדי לעדכן. הפעולה הזו יוצרת תמונת מצב חדשה של הכלים.

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

כדי לסנכרן כלים:

  1. בקטע כלים לסנכרון:

    1. לוחצים על כלי סנכרון.
    2. אם תתבקשו להיכנס, בצעו אימות באמצעות חשבון פיתוח שיש לו הרשאות להציג את כל הכלים שאתם רוצים לחשוף למשתמשים. כלים שאין לחשבון שלכם גישה אליהם לא מסונכרנים.
    3. אחרי החיבור, ב-Connected Console מוצג מספר הכלים שסונכרנו, וגם הכפתור סנכרון מחדש של הכלים.

  2. בתחתית הדף, לוחצים על הבא כדי לעבור לשלב השני בהגדרת הכלים וה-MCP.

שלב 7: קובעים איך ואיפה המשתמשים יחוו את האפליקציה

בקטע כלים בדף הגדרת MCP וכלים, מגדירים פרמטרים בסיסיים כמו המיקום הגיאוגרפי שבו האפליקציה המקושרת זמינה, השפה שלה ומוצרי Google שבהם רוצים שהיא תהיה זמינה.

  1. בקטע זמינות, לצד הגרסה תהיה זמינה ב, מגדירים את אפשרויות הטירגוט הבאות:
    • מדינות או אזורים: בוחרים את המיקומים הגיאוגרפיים שבהם האפליקציה המקושרת צריכה להיות זמינה.
    • שפות: בוחרים את השפות שנתמכות באפליקציה המקושרת.
    • מוצרים: בוחרים את מוצרי Google שבהם האפליקציה המקושרת תהיה זמינה.

  2. בקטע כלים, אחרי זמינות, בודקים את הכלים שסונכרנו משרת ה-MCP. בוחרים כלי כלשהו ברשימה Tools כדי לקבוע את ההגדרות שלו בחלונית Manage tool שמשמאל:

    • הפעלת הכלי: מעבירים את המתג הפעלת הכלי למצב הרצוי כדי לכלול את הכלי באפליקציה המקושרת או להחריג אותו ממנה. כלים מושבתים לא יהיו זמינים באפליקציה המקושרת, והמשתמשים לא יוכלו להשתמש בהם.

    • הקשר נוסף: בוחרים אם הכלי דורש אותות הקשריים מ-Google כדי לפעול:

      • לוקאל: הלוקאל נקבע לפי חשבון Google של המשתמש.
      • מיקום משוער: המיקום הפיזי של המשתמש או המכשיר באזור בגודל 3 קילומטרים רבועים ומעלה (לדוגמה, העיר שבה המשתמש נמצא).
      • זיהוי מיקום משופר: המיקום הפיזי של המשתמש או המכשיר ברמת דיוק של 50 מטרים או פחות.

    • אישור משתמש: בוחרים באפשרות נדרש אישור משתמש כדי לדרוש אישור מפורש מהמשתמש לפני הפעלת הכלי (האפשרות הזו נבחרת מראש באופן אוטומטי אם ההערות של MCP בכלי מציינות את destructiveHint: true).

  3. אם שרת ה-MCP מספק משאבי ממשק משתמש, עוברים לכרטיסייה UI resources לצד Tools כדי לבדוק את משאבי ממשק המשתמש של השרת (text/html,‏ text/html;profile=mcp-app,‏ text/javascript,‏ text/css), לוודא אילו כלים מקושרים לכל משאב ולבדוק את מדיניות אבטחת התוכן (CSP) connectDomains ו-resourceDomains.

  4. בתחתית הדף, לוחצים על שמירה.

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

שלב 8: בודקים את האפליקציה המקושרת

כדי שהאפליקציה המקושרת תהיה זמינה לבודקים, צריך להוסיף אותם במסך "ניהול הבודקים". רק משתמשים שתוסיפו לרשימת הבודקים יוכלו לראות את האפליקציה המקושרת שלא פורסמה ולבצע בה פעולות. אתם יכולים להוסיף רק בודקים שיש להם חשבון @gmail.com.

  1. בדף הסקירה הכללית של האפליקציה המקושרת, בכרטיס בדיקת האפליקציה, לוחצים על הוספת בודקים (או על ניהול הבודקים אם כבר הוספתם בודקים).

  2. במסך ניהול הבודקים, בוחרים רשימות אימייל קיימות או לוחצים על יצירת רשימת אימייל כדי להוסיף את חשבונות Google שמורשים לבדוק את השילוב. כדי לבדוק את האפליקציה בעצמך, עליך להוסיף את כתובת האימייל שלך.

  3. לוחצים על שמירה.

  4. כדי להפעיל את האפליקציה המקושרת, הבודקים באפליקציית Gemini יכולים להקליד @, ואז את שם האפליקציה המקושרת ולבחור אותה מהתפריט. אתם יכולים גם לראות את האפליקציה ולקשר אותה ב-Gemini: בסרגל הניווט שמימין, עוברים אל הגדרות ועזרה ← אפליקציות מקושרות.

  5. מומלץ לבדוק את השילוב באופן יסודי:

    • נסו את כל ההנחיות לדוגמה.
    • בודקים גם הפעלות מפורשות של @<AppName> וגם שאילתות בשפה טבעית.
    • מאמתים את תהליך האימות מקצה לקצה, את הפעלת הכלי, את בקשות האישור מהמשתמשים ואת כל משאבי ממשק המשתמש.

אחרי שסיימתם את הבדיקות, אתם יכולים לשלוח את האפליקציה המקושרת ל-Google לבדיקה.

שלב 9: מתחילים בדיקה של האפליקציה המקושרת ומפרסמים אותה אחרי שהיא מאושרת

לפני שהאפליקציה המקושרת תהיה זמינה לכל המשתמשים, Google בודקת את השילוב.

כדי לשלוח את האפליקציה המקושרת לבדיקה:

  1. בדף הסקירה הכללית של האפליקציה המקושרת, בכרטיס גרסאות שבצד שמאל של הדף, לוחצים על שליחה לבדיקה (האפשרות הזו זמינה אחרי שהגדרת האפליקציה הושלמה והיא נמצאת במצב טרום-השקה בלי בעיות חסימה).

  2. בזמן שהגרסה בבדיקה:

    • מערכת Connected Console יוצרת באופן אוטומטי גרסת טיוטה חדשה שניתנת לעריכה, כדי שהבודקים יוכלו להמשיך לראות תצוגה מקדימה של האפליקציה, וכדי שתוכלו להכין עריכות עתידיות בלי להפריע לבדיקה.
    • האפשרות הזו נועלת את הגרסה שנמצאת בבדיקה, כך שלא ניתן לבצע בה שינויים.
    • כדי לראות את הפרטים לקריאה בלבד של הגרסה שנמצאת בבדיקה או לבטל את הבדיקה, לוחצים על כפתור האפשרויות הנוספות (⋮) בכרטיס בבדיקה ובוחרים באפשרות הצגת פרטי האפליקציה או ביטול הבדיקה.

  3. אחרי ש-Google תסיים את הבדיקה, תקבלו התראה והכרטיס גרסאות יתעדכן:

    • אם נמצאו בעיות: בכרטיס גרסאות מוצג הכיתוב נמצאו בעיות. לוחצים על עיון בבעיות כדי לבדוק את הממצאים הספציפיים של הבדיקה. מעדכנים את ההגדרות או את שרת ה-MCP בגרסת טרום-השקה (Preview) שניתנת לעריכה, מוודאים שהתיקונים תקינים בעזרת הבודקים ולוחצים שוב על שליחה לבדיקה.
    • אם הבקשה אושרה: בכרטיס גרסאות מוצג הסטטוס מוכנה לפרסום. כשהאפליקציה המקושרת מוכנה לפרסום למשתמשים, לוחצים על פרסום.

מזל טוב! האפליקציה המקושרת פורסמה ומוצגת למשתמשים במוצרי Google שבחרת.

ניהול גרסאות שוטף אחרי הפרסום

אחרי הפרסום, בכרטיס התחתון בקטע גרסאות יוצג הסטטוס פורסמה, לצד מספר הגרסה הפעילה של האפליקציה המקושרת, תאריך הפרסום ומספר המדינות או האזורים, השפות והמוצרים המטורגטים. בכל שלב אפשר ללחוץ על סמל האפשרויות הנוספות (⋮) בכרטיס פורסמה ולבחור באפשרות הצגת פרטי האפליקציה כדי לבדוק את ההגדרות לקריאה בלבד של הגרסה הפעילה.

הגרסה שפורסמה נשארת פעילה בסביבת הייצור, ואתם יכולים להשתמש בחלונית עריכה ובדיקה של האפליקציה המקושרת שמימין (או לבחור באפשרות יצירת גרסה חדשה אם אין טיוטה) כדי להגדיר, לנסות גרסת טרום-השקה (Preview) ולבדוק עדכונים בגרסה חדשה (Version <N+1>) באופן עצמאי לפני שאתם שולחים אותה לבדיקה ולפרסום.