דרישות מוקדמות לשימוש באפליקציות מקושרות

לפני שמתחילים, חשוב לוודא שהתנאים הבאים מתקיימים:

  • שרת MCP פרוס עם נקודת קצה מאובטחת של HTTPS

    שרת ה-MCP צריך להיות נגיש באופן ציבורי דרך HTTPS באמצעות העברת HTTP שניתנת להעברה בסטרימינג (לדוגמה, https://api.yourdomain.com/v1/mcp).

    פרטים על ההטמעה זמינים במדריך למפתחים של שרת MCP ב-Connected Apps Platform.

  • מוודאים שהשרת יכול לקבל בקשות מ-Google

    אם השרת מגביל את הגישה החיצונית לפי כתובת ה-IP של המקור, צריך להוסיף לרשימת ההיתרים את כתובות ה-IP הבאות:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    טווחי כתובות ה-IP של Google לתעבורה יוצאת יכולים להשתנות עם הזמן, לכן מומלץ לקרוא אותם מהרשימות ש-Google מפרסמת ולרענן את רשימת ההיתרים באופן קבוע:

  • גישה לחשבון פיתוח רשום ב-Google Connected Console

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

    • צפייה באפליקציות המקושרות
    • יצירה וניהול של אפליקציות מקושרות

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

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

  • יכולת לארח קובץ אימות של .well-known בדומיין של שרת ה-MCP

    כדי לאמת את הבעלות על הדומיין, אתם צריכים להיות מסוגלים להציג קובץ טוקן לאימות בפורמט JSON ישירות (עם HTTP 200 OK וללא הפניות אוטומטיות) בכתובת https://<your-domain>/.well-known/google-connected-apps.

  • עיון בקטגוריות האפליקציות המקושרות הזמינות

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

  • שרת MCP פרוס עם כתובת URL תקינה של נקודת קצה

    פרטים נוספים זמינים במדריך למפתחים בנושא שרת MCP של אפליקציות מקושרות.

  • מטא-נתונים ונכסים שקשורים למותג שגלויים לציבור באפליקציה המקושרת

    • שם האפליקציה המקושרת: השם של האפליקציה המקושרת שמוצג למשתמשים במוצרי Google, ומשמש את המשתמשים כשהם מתייגים את האפליקציה באמצעות @.
    • תיאור: סיכום תמציתי במשפט אחד (פחות מ-30 מילים) של מה שהאפליקציה המקושרת יכולה לעשות בשביל המשתמשים, למשל "מעקב אחרי הרכישות האחרונות, בדיקת סטטוס המשלוח וצפייה בהיסטוריית ההזמנות".
    • סמל: סמל אפליקציה בגודל 512 פיקסלים על 512 פיקסלים בפורמט JPEG או PNG, ובגודל קובץ מקסימלי של 1MB‏ (1,024KB).
    • יכולות: לפחות 3 משימות חשובות שהאפליקציה המקושרת יכולה לבצע, כמו "חיפוש בהיסטוריית ההזמנות" או "בדיקת סטטוס המשלוח בזמן אמת", בנוסף ליכולות שמוגדרות כברירת מחדל לפי קטגוריית האפליקציה. היכולות יוצגו למשתמשים כדי לעזור להם להחליט אם לקשר את האפליקציה. אל תכללו מספרים בתחילת ההצהרות על יכולות.
    • הנחיות לדוגמה: לפחות 3 שאילתות לדוגמה שעוזרות למשתמשים להבין מה הם יכולים לשאול. התחילו לפחות 2 פרומפטים לדוגמה בשם של האפליקציה המקושרת. תייגו את שם האפליקציה באופן טבעי בפרומפט אחד לפחות (כלומר, בלי להתחיל בשם האפליקציה). אל תכללו מספרים בתחילת הפרומפטים לדוגמה.
    • כתובת ה-URL של התנאים וההגבלות: כתובת URL שנגישה לכולם ומובילה לתנאים ולהגבלות של האפליקציה המקושרת.
    • כתובת ה-URL של מדיניות הפרטיות: כתובת URL שנגישה לכולם ומובילה למדיניות הפרטיות של האפליקציה המקושרת.
    • כתובת אתר (אופציונלי): אתר לאפליקציה המקושרת.