שימוש בשרת MCP מרוחק של Cloud SQL

במאמר הזה נסביר איך משתמשים בשרת Model Context Protocol‏ (MCP) מרוחק של Cloud SQL ל-MySQL כדי להתחבר לאפליקציות מבוססות-AI, כולל Antigravity, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP המרוחק של Cloud SQL מאפשר לכם לגשת לכלים של Cloud SQL ולהריץ אותם כדי ליצור, לנהל ולשלוח שאילתות למשאבים של Cloud SQL מסביבות הפיתוח מבוססות-AI ומפלטפורמות סוכני ה-AI שלכם. שרת ה-MCP המרוחק של Cloud SQL ל-MySQL מופעל כשמפעילים את Cloud SQL ל-MySQL API.

‫Model Context Protocol (MCP) הוא תקן שמגדיר איך מודלים גדולים של שפה (LLM) ואפליקציות או סוכנים של AI מתחברים למקורות נתונים חיצוניים. שרתי MCP מאפשרים לכם להשתמש בכלים, במשאבים ובהנחיות שלהם כדי לבצע פעולות ולקבל נתונים מעודכנים משירות הקצה העורפי שלהם.

מה ההבדל בין שרתי MCP מקומיים לשרתי MCP מרוחקים?

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

ליבה בלי שמירת מצב

בגרסת MCP‏ 2026-07-28, פרוטוקול MCP משתנה מפרוטוקול דו-כיווני עם שמירת מצב (stateful) לפרוטוקול ללא שמירת מצב (stateless). כל בקשת MCP מתארת את עצמה ואפשר לנתב אותה באמצעות כותרות. אין צורך בלחיצת היד של initialize/initialized או ב-Mcp-Session-Id כי כל בקשה כוללת את כל המידע הנדרש בכותרות ה-HTTP או בפרמטר _meta. שרתי MCP יכולים לבקש מידע נוסף שנדרש לכלי באמצעות בקשות מרובות-סבבים (MRTR).

כדי לעזור לנתב ולעבד בקשות בלי לנתח את גוף הבקשה, נדרשות כמה כותרות MCP, כולל:

  • כותרות שנדרשות לפי מפרט ה-MCP, כמו כותרת גרסת הפרוטוקול וכותרות בקשה רגילות.
  • כותרות בהתאמה אישית שמוגדרות על ידי שרת ה-MCP. הכותרות האלה משתקפות בכותרות HTTP מהסכימה של קלט הכלי באמצעות המאפיין x-mcp-header. לדוגמה, שרת MCP יכול להגדיר כותרת מותאמת אישית כדי לציין את האזור או את מזהה הפרויקט של Cloud de Confiance by S3NS .

מידע נוסף על ארכיטקטורת MCP זמין במפרט של גרסת MCP ‏2026-07-28 ובשינויים העיקריים.

שרתי MCP של Google ושרתי MCP מרוחקים של Cloud de Confiance by S3NS

לשרתי MCP של Google ושל Cloud de Confiance by S3NS יש את התכונות והיתרונות הבאים:

  • חיפוש פשוט ומרוכז
  • נקודות קצה (endpoints) מנוהלות של HTTP גלובלי או אזורי
  • הרשאה פרטנית
  • אבטחה אופציונלית של הנחיות ותשובות באמצעות הגנה מוגברת על המודל
  • רישום מרכזי ביומן הביקורת

במאמר סקירה כללית על שרתי Google Cloud MCP תוכלו לקרוא על שרתי MCP אחרים ועל אמצעי האבטחה והפיקוח שזמינים לשרתי Google Cloud MCP.

שרתי MCP מרוחקים מנוהלים על ידי Google ומציעים אמצעי אבטחה ופיקוח נוספים בהשוואה לשרתי MCP מקומיים שסופקו על ידי Cloud SQL ל-MySQL MCP Toolbox for Databases. מידע נוסף על שרתי MCP מרוחקים אחרים ועל אמצעי הבקרה לאבטחה ולממשל שזמינים ל-MCP, מופיע בCloud de Confiance by S3NS סקירה הכללית על שרתי MCP.

הקטעים הבאים רלוונטיים רק לשרת ה-MCP המרוחק של Cloud SQL ל-MySQL.

לפני שמתחילים

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשימוש בשרת ה-MCP המרוחק של Cloud SQL, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט שבו אתם רוצים להשתמש בשרת ה-MCP המרוחק של Cloud SQL:

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

התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי להשתמש בשרת MCP מרוחק של Cloud SQL. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי להשתמש בשרת ה-MCP המרוחק של Cloud SQL, נדרשות ההרשאות הבאות:

  • להפעיל קריאות API לכלי MCP: mcp.tools.call
  • גישה לגרסת סוד ב-Secret Manager: secretmanager.secretVersions.access
  • ‫Clone a Cloud SQL instance: cloudsql.instances.clone
  • יוצרים מכונה של Cloud SQL: cloudsql.instances.create
  • יוצרים משתמש ב-Cloud SQL: cloudsql.users.create
  • יוצרים גיבוי ב-Cloud SQL: cloudsql.backupRuns.create
  • מריצים הצהרות SQL (כולל לקריאה בלבד) במכונה של Cloud SQL:
    • cloudsql.instances.executeSql
    • cloudsql.instances.login
  • מקבלים מכונה של Cloud SQL: cloudsql.instances.get
  • קבלת פעולה של מכונת Cloud SQL: cloudsql.instances.get
  • ייבוא נתונים למכונה של Cloud SQL: cloudsql.instances.import
  • הצגת רשימה של מכונות Cloud SQL בפרויקט: cloudsql.instances.list
  • רשימת המשתמשים ב-Cloud SQL: cloudsql.users.list
  • שחזור מגיבוי של Cloud SQL:
    • cloudsql.backupRuns.get
    • cloudsql.instances.restoreBackup
  • עדכון מכונה של Cloud SQL: cloudsql.instances.update
  • עדכון משתמש ב-Cloud SQL: cloudsql.users.update

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

הגדרת לקוח MCP לשימוש בשרת Cloud SQL MCP

תוכנות מארחות, כמו Claude או Gemini CLI, יכולות ליצור לקוחות MCP שמתחברים לשרת MCP יחיד. לתוכנה מארחת יכולים להיות כמה לקוחות שמתחברים לשרתי MCP שונים. כדי להתחבר לשרת MCP מרוחק, לקוח ה-MCP צריך לדעת לפחות את כתובת ה-URL של שרת ה-MCP המרוחק.

כדי להגדיר לקוחות MCP שיתחברו לשרת MCP של Cloud SQL המרוחק, פועלים לפי ההוראות הבאות.

Gemini CLI

כדי להוסיף שרת MCP מרוחק של Cloud SQL ל-Gemini CLI, צריך להגדיר אותו כתוסף.

  1. יוצרים קובץ תוסף במיקום הבא: ~/.gemini/extensions/EXT_NAME/gemini-extension.json כאשר ~/ היא ספריית הבית ו-EXT_NAME הוא השם שרוצים לתת לתוסף.

  2. שומרים את התוכן הבא בקובץ התוסף:

            {
              "name": "EXT_NAME",
              "version": "1.0.0",
              "mcpServers": {
                "Cloud SQL MCP Server": {
                  "httpUrl": "https://sqladmin.googleapis.com/mcp",
                  "authProviderType": "google_credentials",
                  "oauth": {
                    "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
                  },
                  "timeout": 30000,
                  "headers": {
                    "x-goog-user-project": "PROJECT_ID"
                  }
                }
              }
            }
            
  3. שומרים את קובץ התוספים.

  4. מפעילים את Gemini CLI:

            gemini
            
  5. מריצים את /mcp כדי לראות את שרת ה-MCP שהגדרתם ואת הכלים שלו.

    התגובה אמורה להיראות כך:

            Configured MCP servers:
            🟢 Cloud SQL MCP Server (from sqladmin )
              - list_instances
              - get_instance
              - clone_instance
              - create_instance
              - update_instance
              - execute_sql
              - execute_sql_readonly
              - get_operation
              - create_user
              - update_user
              - list_users
              - create_backup
              - restore_backup
              - import_data
              - postgres_upgrade_precheck
            

שרת ה-MCP המרוחק מוכן לשימוש ב-Gemini CLI.

Antigravity

כדי להגדיר את שרת ה-MCP המרוחק של Cloud SQL לשימוש עם Antigravity, משתמשים בApplication Default Credentials (‏ADC).

אימות בפרויקט Cloud de Confiance by S3NS

  1. כדי להיכנס אל Cloud de Confiance by S3NS באמצעות ADC, מריצים את הפקודה הבאה:
    gcloud auth application-default login
        
  2. מעתיקים את כתובת ה-URL והאסימון שנוצרו לחלון דפדפן.
  3. מסך הכניסה יופיע. בוחרים את החשבון שיש לו הרשאות להפעיל כלי MCP ולהשתמש בשרת ה-MCP המרוחק. אחרי שנכנסים, פרטי הכניסה נשמרים בקובץ פרטי הכניסה המקומי שמשמש את ADC.

הוספת שרת ה-MCP המרוחק ל-Antigravity

  1. פותחים את Antigravity.
  2. בחלונית Agent, לוחצים על כדי לפתוח את התפריט Additional options ובוחרים באפשרות שרת MCP.
  3. בחלון מאגר MCP, לוחצים על ניהול שרתי MCP. בחלון העורך הראשי, מופיע החלונית ניהול שרתי MCP.
  4. בחלונית ניהול שרתי MCP, לוחצים על הצגת ההגדרות הגולמיות כדי לפתוח כרטיסייה עם הקובץ mcp_json.config.
  5. מוסיפים את ההגדרות הבאות לקובץ mcp_config.json:
      {
         "mcpServers": {
            "cloud-sql": {
               "serverUrl": "https://sqladmin.googleapis.com/mcp",
                "authProviderType": "google_credentials",
                "disabled": false
          }
        }
      }
  6. חוזרים לחלונית ניהול שרתי MCP ולוחצים על רענון. מופיעה רשימה של הכלים הזמינים לשרת ה-MCP המרוחק של Cloud SQL.
  7. בחלונית Agent, מזינים הנחיה לסוכן שמשתמש בשרת ה-MCP המרוחק של Cloud SQL. לדוגמה:
    List the Cloud SQL instances in the project.
  8. מוודאים שהסוכן משתמש בכלי list_instances משרת ה-MCP המרוחק של Cloud SQL. בחלונית Agent, אתם יכולים לראות את העבודה של הסוכן, כולל:

    MCP tool: cloud-sql/list_instance

Claude.ai

כדי להגדיר שרתי Google ו- Cloud de Confiance by S3NS שרתי MCP ב-Claude.ai, צריך מינוי לתוכנית Claude Enterprise, ‏ Pro, ‏ Max או Team. למידע על מחירים, ראו התמחור של Claude.

כדי להוסיף שרת MCP של Google או שרת MCP Cloud de Confiance by S3NS מרוחק ל-Claude.ai, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח וסוד לקוח ב-OAuth:

יצירת מזהה לקוח וסוד ב-OAuth 2.0

  1. במסוף Cloud de Confiance , נכנסים אל Google Auth Platform > Clients > Create client.

    כניסה לדף Create client

    אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

  2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

  3. בשדה Name, מזינים שם לאפליקציה.

  4. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://claude.ai/api/mcp/auth_callback בשדה URIs.

  5. לוחצים על יצירה. הלקוח נוצר. כדי לגשת למזהה הלקוח, במסוף Cloud de Confiance , נכנסים אל Google Auth Platform > Clients.

  6. ברשימה מזהי לקוח ב-OAuth 2.0, בוחרים את שם הלקוח.

  7. בקטע סודות לקוח, מעתיקים את סוד לקוח ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

יצירת מחבר בהתאמה אישית ב-Claude.ai

פועלים לפי ההוראות לתוכנית Claude שבה אתם משתמשים:

Enterprise ו-Team

  1. ב-Claude.ai, עוברים אל Admin settings > Connectors (הגדרות אדמין > מחברים).

  2. לוחצים על הוספת מחבר בהתאמה אישית.

  3. בתיבת הדו-שיח הוספת מחבר בהתאמה אישית, מזינים את הפרטים הבאים:

    • שם השרת: שם קריא לאנשים של השרת.
    • כתובת ה-URL של שרת ה-MCP המרוחק: https://sqladmin.googleapis.com/mcp
  4. מרחיבים את התפריט הגדרות מתקדמות ומזינים את הפרטים הבאים:

    • מזהה לקוח OAuth: מזהה הלקוח ב-OAuth 2.0 שיצרתם.
    • סוד לקוח OAuth: הסוד של לקוח OAuth 2.0. כדי לאחזר את הסוד, עוברים אל פלטפורמת האימות של Google‏ > לקוחות ובוחרים את מזהה הלקוח ב-OAuth שיצרתם. בקטע Client secrets, לוחצים כדי להעתיק את Client secret.
  5. לוחצים על הוספה.

    המחבר בהתאמה אישית נוצר.

  6. פותחים את התפריט כלים ומפעילים את המחבר.

    ‫Claude.ai יכול להשתמש בשרת ה-MCP.

‫Pro ו-Max

  1. ב-Claude.ai, עוברים אל הגדרות > מחברים.

  2. לוחצים על הוספת מחבר בהתאמה אישית.

  3. בתיבת הדו-שיח הוספת מחבר בהתאמה אישית, מזינים את הפרטים הבאים:

    • שם השרת: שם קריא לאנשים של השרת.
    • כתובת ה-URL של שרת ה-MCP המרוחק: https://sqladmin.googleapis.com/mcp
  4. מרחיבים את התפריט הגדרות מתקדמות ומזינים את הפרטים הבאים:

    • מזהה לקוח OAuth: מזהה הלקוח ב-OAuth 2.0 שיצרתם.
    • סוד לקוח OAuth: הסוד של לקוח OAuth 2.0. כדי לאחזר את הסוד, עוברים אל פלטפורמת האימות של Google‏ > לקוחות ובוחרים את מזהה הלקוח ב-OAuth שיצרתם. בקטע Client secrets, לוחצים כדי להעתיק את Client secret.
  5. לוחצים על הוספה.

    המחבר בהתאמה אישית נוצר.

  6. פותחים את התפריט כלים ומפעילים את המחבר.

    ‫Claude.ai יכול להשתמש בשרת ה-MCP.

ChatGPT

כדי להשתמש בשרתי MCP של Google ו-Cloud SQL עם ChatGPT, צריך מינוי ל-ChatGPT Business.

כדי להוסיף ל-ChatGPT שרת MCP מרוחק של Google או של Cloud SQL, צריך ליצור מזהה לקוח וסוד לקוח של Google OAuth 2.0, ואז להוסיף את שרת ה-MCP כאפליקציה ב-ChatGPT.

יצירת מזהה לקוח וסוד ב-OAuth 2.0

  1. במסוף Cloud de Confiance , נכנסים אל Google Auth Platform > Clients > Create client.

    כניסה לדף Create client

    אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

  2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

  3. בשדה Name, מזינים שם לאפליקציה.

  4. בקטע Authorized JavaScript origins, לוחצים על ‎+ Add URI ומוסיפים את https://chatgpt.com בשדה URIs.

  5. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://chatgpt.com/connector_platform_oauth_redirect בשדה URIs.

  6. לוחצים על יצירה. הלקוח נוצר. כדי לגשת למזהה הלקוח, במסוף Cloud de Confiance , נכנסים אל Google Auth Platform > Clients.

  7. ברשימה מזהי לקוח ב-OAuth 2.0, בוחרים את שם הלקוח.

  8. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

מוסיפים את שרת ה-MCP כאפליקציה ב-ChatGPT

  1. נכנסים לחשבון ב-ChatGPT.
  2. מפעילים את מצב פיתוח:
    1. ב-ChatGPT, לוחצים על שם המשתמש כדי לפתוח את תפריט הפרופיל, ואז בוחרים באפשרות הגדרות.
    2. בתפריט ההגדרות, לוחצים על אפליקציות ואז על הגדרות מתקדמות.
    3. ב-Advanced settings, מעבירים את המתג מצב פיתוח למצב מופעל.
  3. בקטע הגדרות > אפליקציות, לוחצים על הכפתור יצירת אפליקציה.
  4. בתיבת הדו-שיח New app, מזינים את הפרטים הבאים:
    • שם: השם של שרת ה-MCP.
    • תיאור: תיאור אופציונלי של שרת ה-MCP.
    • כתובת ה-URL של שרת ה-MCP: https://sqladmin.googleapis.com/mcp
    • אימות:
      • בתפריט Authentication, בוחרים באפשרות OAuth.
      • בשדה OAuth client ID, מזינים את מזהה הלקוח ב-Google OAuth.
      • בשדה OAuth secret, מזינים את סוד הלקוח של Google OAuth.
    • מאשרים שמבינים את הסיכון שקשור לשימוש בשרת MCP ולוחצים על יצירה.

שרת ה-MCP מופיע בתפריט אפליקציות, ואפשר להשתמש בו באמצעות הנחיות בצ'אט.

הנחיות כלליות ללקוחות MCP

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

בשרת ה-MCP המרוחק של Cloud SQL, מזינים את הפרטים הבאים לפי הצורך:

  • שם השרת: שרת Cloud SQL MCP
  • כתובת ה-URL של השרת או נקודת הקצה: https://sqladmin.googleapis.com/mcp (או כתובת URL של ערכת כלים ייעודית)
  • תעבורה: HTTP שניתן להעביר בסטרימינג
  • פרטי אימות: בהתאם לשיטת האימות שאתם רוצים להשתמש בה, אתם יכולים להזין את פרטי הכניסה, את מזהה הלקוח והסוד של OAuth או את פרטי הכניסה והזהות של הנציג. Cloud de Confiance by S3NS מידע נוסף על אימות זמין במאמר אימות בשרתי MCP.
  • היקף הרשאות OAuth: היקף ההרשאות של OAuth 2.0 שבו רוצים להשתמש כשמתחברים לשרת ה-MCP של Cloud SQL.

אימות והרשאה

שרתי Cloud SQL MCP משתמשים בפרוטוקול OAuth 2.0 עם ניהול זהויות והרשאות גישה (IAM) לאימות ולהרשאה. כל Cloud de Confiance by S3NS הזהויות נתמכות לאימות בשרתי MCP.

שרת ה-MCP המרוחק של Cloud SQL לא מקבל מפתחות API.

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

היקפי ההרשאות של Cloud SQL MCP OAuth

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

אלה היקפי ההרשאות של OAuth לכלי MCP ב-Cloud SQL:

URI של היקף ההרשאות ל-CLI של gcloud תיאור
https://www.googleapis.com/auth/cloud-platform ליצור, לעדכן ולפרט משאבים של Cloud SQL, כולל מכונות ומשתמשים במסד הנתונים. לייבא נתונים ולהריץ הצהרות SQL במכונות של Cloud SQL.
https://www.googleapis.com/auth/cloudsql ליצור, לעדכן ולפרט משאבים של Cloud SQL, כולל מכונות ומשתמשים במסד הנתונים. לייבא נתונים ולהריץ הצהרות SQL במכונות של Cloud SQL. אתם יכולים להשתמש בהיקף הזה בנוסף להיקף הרחב יותר ברמת הפלטפורמה, או במקומו.
https://www.googleapis.com/auth/cloudsql.readonly צפייה במשאבים של Cloud SQL ובנתונים במכונות של Cloud SQL. אפשר להשתמש בהיקף הזה כדי להריץ הצהרות SQL לקריאה בלבד.

יכול להיות שיידרשו היקפי הרשאות נוספים במשאבים שאליהם ניגשים במהלך קריאת API לכלי. ב-Cloud SQL Admin API מפורטים היקפי ההרשאות שנדרשים ל-Cloud SQL.

ערכות הכלים הזמינות

שרת ה-MCP המרוחק של Cloud SQL מספק כתובות URL ייעודיות של נקודות קצה (ערכות כלים) שחושפות קבוצות משנה ספציפיות של כלים, בהתאם לדרישות האבטחה ותהליך העבודה שלכם. אתם יכולים להגדיר את לקוח ה-MCP כך שיתחבר לכל אחת מכתובות ה-URL הבאות של ערכת הכלים:

  • כל הכלים: https://sqladmin.googleapis.com/mcp חושף את כל הכלים שזמינים בשרת ה-MCP המרוחק.

  • לקריאה בלבד: https://sqladmin.googleapis.com/mcp/readonly חשיפת כלים לקריאה בלבד:

    • get_instance
    • get_operation
    • list_instances
    • list_users
    • execute_sql_readonly
  • ניהול מכונות: https://sqladmin.googleapis.com/mcp/instance_manage כלים ליצירה, לשינוי ולניהול של מכונות Cloud SQL:

    • clone_instance
    • create_instance
    • get_instance
    • get_operation
    • list_instances
    • update_instance
  • הרצת שאילתות: https://sqladmin.googleapis.com/mcp/query_execution חושף כלים להרצת הצהרות SQL:

    • execute_sql
    • get_operation

באילו כלים אפשר להשתמש

  • ‫clone_instance: יצירת מכונה של Cloud SQL כשיבוט של מכונת המקור.
  • ‫create_backup: יצירת גיבוי של מכונה ב-Cloud SQL.
  • ‫create_instance: הפקודה שמתחילה את היצירה של מכונת Cloud SQL.
  • ‫create_user: יצירת משתמש במסד נתונים למכונה של Cloud SQL.
  • ‫execute_sql: מריץ כל הצהרת SQL תקינה (DDL, ‏ DCL, ‏ DQL, ‏ DML) במכונה של Cloud SQL.
  • ‫execute_sql_readonly: מריץ כל הצהרת SQL תקינה לקריאה בלבד במכונה של Cloud SQL.
  • get_instance: קבלת הפרטים של מכונה ב-Cloud SQL.
  • get_operation: קבלת הסטטוס של פעולה ממושכת ב-Cloud SQL.
  • import_data: ייבוא נתונים למופע של Cloud SQL מ-Cloud Storage.
  • list_instances: הצגת רשימה של כל המכונות של Cloud SQL בפרויקט.
  • list_users: הצגת רשימה של כל משתמשי מסד הנתונים של מכונה ב-Cloud SQL.
  • restore_backup: שחזור גיבוי של מכונה ב-Cloud SQL.
  • ‫update_instance: עדכון ההגדרות הנתמכות של מכונה ב-Cloud SQL.
  • update_user: עדכון משתמש במסד נתונים של מכונה ב-Cloud SQL.

בחומר העזר של Cloud SQL MCP מפורטים כלים נוספים של MCP שזמינים לשרת ה-MCP המרוחק של Cloud SQL, כולל תיאורים שלהם.

כלים לרשימות

משתמשים ב-MCP inspector כדי להציג רשימה של כלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP המרוחק של Cloud SQL. השיטה tools/list לא דורשת אימות.

curl -X POST https://sqladmin.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫TOOLSET_ENDPOINT: החלק של נקודת הקצה של ה-MCP אחרי שם השירות. לדוגמה, ב-Cloud SQL זה יכול להיות mcp/toolset-name.
  • ‫MCP_PROTOCOL_VERSION: גרסת פרוטוקול ה-MCP. לדוגמה, 2026-07-28.

יצירת מכונה

כברירת מחדל, כשיוצרים מכונה של Cloud SQL באמצעות הכלי create_instance, המכונה מוגדרת עם כתובת IP ציבורית.

כדי ליצור מכונה עם כתובת IP פרטית, אתם יכולים ליצור מכונה שמופעלת בה גישה לשירותים פרטיים או Private Service Connect. כשיוצרים מכונה עם כתובת IP פרטית, כתובת ה-IP הציבורית שלה מושבתת באופן אוטומטי.

כדי להפעיל גישה לשירותים פרטיים, צריך שכבר יהיה חיבור לגישה לשירותים פרטיים בפרויקט שבו אתם יוצרים את המכונה של Cloud SQL. כדי להפעיל את Private Service Connect, צריך שכבר תהיה נקודת קצה של Private Service Connect בפרויקט שיש לו גישה למכונה של Cloud SQL שאתם יוצרים.

יצירת מכונה לתקופת ניסיון בחינם

אתם יכולים להשתמש בכלי create_instance כדי להקצות מכונה של Cloud SQL לבדיקה ולפיתוח. כשמפעילים את create_instance, מגדירים את הפרמטר האופציונלי free_trial לערך true.

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

למידע נוסף על תקופות ניסיון בחינם של מכונות Cloud SQL, ראו סקירה כללית על מכונות לתקופת ניסיון בחינם.

עדכון של מכונה

הכלי update_instance מאפשר לבצע את העדכונים הבאים במכונה של Cloud SQL:

יצירת משתמש

אתם יכולים ליצור משתמשים במסד הנתונים שמשתמשים באימות של IAM במסד הנתונים או באימות מובנה.

אם אתם יוצרים משתמש במסד נתונים שמשתמש באימות מובנה, כדי ליצור סיסמה למשתמש, קודם צריך ליצור את הסיסמה ב-Secret Manager. כשיוצרים את המשתמש, מציינים את הנתיב לגרסת הסוד.

למידע נוסף על יצירת סוד וגישה לגרסת סוד, ראו יצירת סוד.

הרצת הצהרות SQL

שרת ה-MCP המרוחק של Cloud SQL מספק שני כלים נפרדים להרצת הצהרות SQL. אתם יכולים להשתמש בכלי execute_sql כדי לנהל את מסד הנתונים ולבצע בו שינויים. כדי להריץ הצהרות SQL לקריאה בלבד, כמו שאילתות על נתונים, אתם יכולים להשתמש בכלי execute_sql_readonly.

בשני המקרים, כדי להריץ את הצהרות ה-SQL, המכונה של Cloud SQL צריכה לעמוד בדרישות הבאות:

אם הגדרת התצורה data_api_access של המכונה לא מוגדרת ל-ALLOW_DATA_API, משתמשים בכלי update_instance כדי לעדכן את התצורה של המכונה.

תגי sqlcommenter

כשמריצים שאילתות באמצעות הכלי execute_sql או execute_sql_readonly, מגדירים את הפרמטר האופציונלי sql_commenter_enabled לערך true כדי להוסיף תגי sqlcommenter להצהרות ה-SQL לצורך ניטור וטלמטריה של מסד הנתונים. התגובה שנוספה כוללת את התגים הבאים:

  • ‫mcp.tool: השם של כלי ה-MCP שהופעל.
  • ‫mcp.server: הזהות של שרת ה-MCP המרוחק (Remote MCP Server).
  • ‫user.identity: מסד הנתונים המאומת או זהות המשתמש ב-IAM שמריצה את השאילתה.
  • ‫mcp.client: הלקוח או סוכן האפליקציה של ה-AI שזוהה (לדוגמה, Claude,‏ Gemini או Antigravity).

אלה התגים היחידים שנתמכים, ואי אפשר להוסיף תגים אחרים.

אתם יכולים לראות את השאילתות שבוצעו ואת תגי sqlcommenter שנוספו להן ב-Cloud SQL Studio או ב-Logs Explorer, על ידי צפייה בשאילתות של מסד הנתונים וביומני הביקורת.

תרחישים לדוגמה

הנה כמה תרחישים לדוגמה לשימוש בשרת ה-MCP של Cloud SQL:

פיתוח אפליקציות אינטרנט

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

הנחיה לדוגמה:

"Create a new MySQL development instance and set up a table called products."

תהליך עבודה:

תהליך העבודה להגדרת אפליקציית אינטרנט יכול להיראות כך:

  • הקצאה: הנציג מפעיל את הכלי create_instance כדי ליצור מכונה חדשה של Cloud SQL עם מפרט שמתאים לסביבת פיתוח.

  • אימות: הנציג משתמש בכלי get_operation כדי לדגום את הסטטוס של פעולת יצירת המכונה.

  • חיבור: כשהפעולה מסתיימת, הסוכן משתמש בכלי get_instance כדי לאחזר את המטא-נתונים של החיבור למכונה.

  • הגדרת הסכימה: כשהסוכן מוכן, הוא משתמש ב-execute_sql כדי להריץ את הצהרת ה-SQL‏ CREATE TABLE products.

  • הזנת נתונים: הנציג משתמש שוב ב-execute_sql כדי להוסיף נתוני הזנה ראשוניים (DML) לטבלה החדשה שנוצרה.

  • הזנת נתונים: כשהסוכן מוכן, הוא משתמש ב-import_data כדי לייבא קובץ נתונים של מוצרים מ-Cloud Storage.

איך שולחים שאילתה למסד נתונים באמצעות שפה טבעית

אתם יכולים לשלוח שאילתות למסד נתונים של Cloud SQL, לעדכן רשומות ולעדכן סכימות באמצעות שפה טבעית.

הנחיה לדוגמה:

"Add a `stock_count` column to the inventory table."

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

  • העברת סכימה: הנציג קורא ל-execute_sql כדי להריץ הצהרת ALTER TABLE, ומוסיף את העמודה החדשה stock_count לסכימת מסד הנתונים.

  • אימות: הנציג משתמש ב-get_instance כדי לוודא שעדכון המכונה הושלם בהצלחה.

הנחיה לדוגמה:

"Show me a list of shoes that are priced above $100 from the inventory table."

תהליך עבודה:

  • הרצת השאילתה: הנציג קורא ל-execute_sql כדי להריץ את הצהרת ה-SQL שמאחזרת את הנתונים.

מגבלות

לשרת ה-MCP המרוחק של Cloud SQL יש את המגבלות הבאות:

  • אם הכלי execute_sql או execute_sql_readonly מחזיר תשובה שגדולה מ-10MB, התשובה תיחתך.
  • כשמשתמשים בכלי execute_sql או execute_sql_readonly, יכול להיות שהזמן הקצוב לתפוגה של שאילתות שפועלות יותר מ-30 שניות יסתיים.

הגדרות אופציונליות של אבטחה ובטיחות

בגלל המגוון הרחב של הפעולות שאפשר לבצע באמצעות כלי MCP, הוא מביא איתו סיכוני אבטחה ושיקולים חדשים. כדי לצמצם את הסיכונים האלה ולנהל אותם,Cloud de Confiance by S3NS מציע הגדרות ברירת מחדל וכללי מדיניות שניתנים להתאמה אישית כדי לשלוט בשימוש בכלי MCP בארגון או בפרויקט ב- Cloud de Confiance by S3NS.

מידע נוסף על אבטחה ופיקוח ב-MCP זמין במאמר אבטחה ובטיחות ב-AI.

Model Armor

הגנה מוגברת על המודל היא שירות שלCloud de Confiance by S3NS שנועד לשפר את האבטחה והבטיחות של אפליקציות ה-AI שלכם. הוא פועל באופן יזום כדי לסנן הנחיות ותשובות של מודלים גדולים של שפה (LLM), להגן מפני סיכונים שונים ולתמוך בשיטות לפיתוח אחראי של AI. לא משנה אם אתם פורסים את ה-AI בסביבת הענן שלכם או אצל ספקי שירותי ענן חיצוניים, אתם יכולים להשתמש ב-Model Armor כדי למנוע קלט זדוני, לוודא שהתוכן בטוח, להגן על מידע אישי רגיש, לשמור על תאימות ולאכוף את מדיניות הבטיחות והאבטחה של ה-AI באופן עקבי בכל סביבת ה-AI שלכם.

כשהתכונה "הגנה מוגברת על המודל" מופעלת והרישום ביומן מופעל, התכונה מתעדת ביומן את כל המטען הייעודי (payload). זה עלול לחשוף מידע רגיש ביומנים.

ניתוב בקשות של MCP ל-Model Armor

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

הפעלת Model Armor

כדי להשתמש ב-Model Armor, צריך להפעיל את ממשקי ה-API של Model Armor.

המסוף

  1. מפעילים את Model Armor API, אם הוא עדיין לא מופעל.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

  2. בוחרים את הפרויקט שבו רוצים להפעיל את Model Armor.

gcloud

לפני שמתחילים, מבצעים את השלבים הבאים באמצעות ה-CLI של gcloud עם Model Armor API:

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

    gcloud init

  2. מריצים את הפקודה הבאה כדי להגדיר את נקודת הקצה ל-API של שירות Model Armor.

    gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"

    מחליפים את LOCATION באזור שבו רוצים להשתמש ב-Model Armor.

הגדרת הגנה לשרתי MCP של Google ו Cloud de Confiance by S3NS שרתי MCP מרוחקים

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

מגדירים את הסף של Model Armor כשהסרת תוכן זדוני או רגיש ב-MCP מופעלת. מידע נוסף זמין במאמר הגדרת רמות הסינון של Model Armor.

דוגמה לפקודה:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

מחליפים את PROJECT_ID במזהה הפרויקט ב- Cloud de Confiance .

שימו לב להגדרות הבאות:

  • ‫INSPECT_AND_BLOCK: סוג האכיפה שבודק את התוכן בשרת MCP של Google וחוסם הנחיות ותשובות שתואמות למסננים.
  • ‫ENABLED: ההגדרה שמפעילה מסנן או אכיפה.
  • ‫MEDIUM_AND_ABOVE: רמת הסמך של הגדרות הסינון של Responsible AI - Dangerous. אפשר לשנות את ההגדרה הזו, אבל ערכים נמוכים יותר עלולים לגרום ליותר תוצאות חיוביות כוזבות. מידע נוסף מופיע במאמר רמות הסמך של Model Armor.

השבתת הסריקה של תנועת MCP באמצעות Model Armor

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

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

מחליפים את PROJECT_ID במזהה הפרויקט ב- Cloud de Confiance . התכונה "הגנה מוגברת על המודל" לא מחילה באופן אוטומטי את הכללים שמוגדרים בהגדרות המינימום של הפרויקט הזה על תנועה בשרת MCP של Google.

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

שליטה בשימוש ב-MCP באמצעות מדיניות IAM

כללי מדיניות הדחייה וכללי מדיניות ההרשאה של ניהול הזהויות והרשאות הגישה (IAM) עוזרים לכם לאבטח את Cloud de Confiance by S3NS ואת שרתי Google MCP.

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

  • חשבון המשתמש.
  • מאפייני כלים כמו המאפיין "לקריאה בלבד".
  • שם השירות או הכלי.
  • מזהה הלקוח ב-OAuth של האפליקציה.

מידע נוסף זמין במאמר שליטה בשימוש ב-MCP באמצעות ניהול זהויות והרשאות גישה.

המאמרים הבאים