בדף הזה מוסבר איך לחבר את מופע Cloud SQL לכלים שונים של AI לעזרה למפתחים, כולל:
- Gemini Code Assist
- Claude code
- Claude למחשב
- Codex
- Cline (תוסף ל-VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codeium)
- Antigravity
כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף Gemini CLI ייעודי ל-Cloud SQL ל-SQL Server.
Gemini CLI הוא ממשק שורת פקודה (CLI) מהדור הבא של Google Cloud, שמשלב את היכולות הבסיסיות ישירות בתוסף, וכך מפשט את ההגדרה וההגדרה. אתם יכולים להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, וליהנות מיתרונות דומים בהגדרה בסביבת הפיתוח המשולבת (IDE).
במקרה של כלי פיתוח אחרים שתומכים ב-Model Context Protocol (MCP), אפשר להתחבר על ידי הגדרה ידנית של MCP Toolbox for Databases (Toolbox). Toolbox הוא שרת MCP בקוד פתוח שמחבר סוכני AI לנתונים שלכם באמצעות ניהול משימות כמו אימות ואיגום חיבורים. כך תוכלו לקיים אינטראקציה עם הנתונים באמצעות שפה טבעית ישירות מ-IDE. השיטה הזו מספקת יכולות ליבה של אינטראקציה עם מסד נתונים עבור הכלים האלה.
מידע נוסף זמין במאמרים בנושא כלים מוכנים מראש וMCP Toolbox for Databases ב-GitHub.
מידע על Gemini CLI ותוספים
Gemini CLI הוא סוכן מבוסס-AI בקוד פתוח שנועד לעזור בתהליכי פיתוח, למשל בכתיבת קוד, באיתור באגים, בחיפוש נתונים וביצירת תוכן. הוא מספק ממשק מבוסס-סוכן לאינטראקציה עם שירותי ניתוח נתונים ומסדי נתונים פופולריים בקוד פתוח.
איך תוספים פועלים
Gemini CLI הוא כלי שניתן להרחבה בקלות, ואפשר להוסיף לו כלים ויכולות חדשים באמצעות תוספים. אפשר לטעון את התוספים מכתובת URL ב-GitHub, מספרייה מקומית או ממאגר שניתן להגדרה. הם מספקים כלים חדשים, פקודות סלאש, מיומנויות והנחיות שיעזרו לכם בתהליך העבודה.
שימוש בתוספים ל-Gemini CLI ב-Cloud SQL ל-SQL Server
התוסף Cloud SQL Gemini CLI מבוסס על MCP Toolbox for Databases.
השילוב עם Gemini CLI מתבצע באמצעות תוסף ייעודי שמציע יכולות נוספות בהשוואה לחיבור הרגיל של Toolbox. התוסף מציע תהליך התקנה יעיל ומערך מיומנויות שמבוסס על כלי MCP.
מידע נוסף זמין במאמרי העזרה של GitHub בנושא תוסף Gemini CLI ל-Cloud SQL ל-SQL Server.תוסף ל-Gemini CLI למסדי נתונים של Cloud SQL ל-SQL Server
התוסףcloud-sql-sqlserver כולל מיומנויות לשליחת שאילתות למסד הנתונים ולמעקב אחרי תקינות מסד הנתונים.
ב-GitHub אפשר לראות את כל הכישורים הזמינים של Cloud SQL.
התוסף cloud-sql-sqlserver-observability מספק ממשק מאוחד לניהול ולמעקב אחרי הביצועים והתקינות של מסד הנתונים ישירות מ-Gemini CLI.
| קטגוריה | כלים |
|---|---|
| ניראות (observability) |
|
תוסף ל-Gemini CLI למסדי נתונים של SQL Server
רשימת הפעולות האלה מופיעה במאמרים בנושא MCP Toolbox for Databases וGemini CLI extension for SQL Server.
לפני שמתחילים
בדף project selector במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
כברירת מחדל, Cloud SQL מקצה כתובת IP ציבורית למופע חדש. בהתאם לתרחיש השימוש, צריך לוודא שמוגדרת כתובת IP ציבורית או כתובת IP פרטית למכונות Cloud SQL. החיבור של Toolbox מאובטח באמצעות Cloud SQL Language Connectors.
נותנים למשתמש שיפעיל את שרת ה-MCP את התפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM). הכלים שזמינים תלויים בתפקידים שהוקצו:
משימה שם התפקיד תפקיד IAM נדרש התפקיד הזה מספק גישת קריאה בלבד למשאבים, כולל הפעולות הבאות: get_instancelist_instanceslist_databaseswait_for_operation
בעל הרשאת צפייה ב-Cloud SQL roles/cloudsql.viewerההרשאה מאפשרת גישת קריאה בלבד לנתוני ניטור, כמו מדדים של סדרות זמן. בעל הרשאת צפייה ב-Cloud Monitoring roles/monitoring.viewerההרשאה מאפשרת לנהל משאבים קיימים, כולל הפעולות הבאות: - כל הכלים של
viewer create_database
עורך Cloud SQL roles/cloudsql.editorהתפקיד הזה נותן שליטה מלאה על כל המשאבים, כולל המשאבים הבאים: - כל הכלים של
viewerושלeditor create_instancecreate_user
Cloud SQL Admin roles/cloudsql.adminמגדירים Application Default Credentials (ADC) לסביבה.
יוצרים או משתמשים מחדש במשתמש במסד נתונים, ומוודאים שיש לכם את שם המשתמש והסיסמה.
התחברות ל-Antigravity
אפשר לחבר את Cloud SQL ל-SQL Server ל-Antigravity בדרכים הבאות:
- שימוש ב-MCP Store
- שימוש בהגדרה מותאמת אישית
חנות MCP
השיטה המומלצת ביותר להתחבר ל-Cloud SQL for SQL Server ב-Antigravity היא באמצעות MCP Store המובנה.
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל שלוש הנקודות בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- ברשימת השרתים הזמינים, מאתרים את Cloud SQL ל-SQL Server ולוחצים על Install (התקנה).
- פועלים לפי ההוראות המוצגות כדי לקשר את החשבונות בצורה מאובטחת, אם רלוונטי.
אחרי שמתקינים את Cloud SQL for SQL Server בחנות MCP, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.
הגדרות אישיות
כדי להתחבר לשרת MCP בהתאמה אישית:
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל שלוש הנקודות בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- לוחצים על Manage MCP Servers > View raw config (ניהול שרתי MCP > הצגת הגדרות גולמיות) כדי לפתוח את הקובץ
mcp_config.json. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
"mcpServers": {
"cloud-sql-mssql": {
"command": "npx",
"args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
"env": {
"CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MSSQL_REGION": "REGION",
"CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MSSQL_USER": "USER_ID",
"CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
}
}
}
}
אחרי שמגדירים את שרת ה-MCP המותאם אישית, המשאבים והכלים מהשרת של Cloud SQL for SQL Server זמינים בעורך.
התקנת MCP Toolbox
- מורידים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת המעבד.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
- הופכים את הקובץ הבינארי לקובץ הפעלה:
chmod +x toolbox
- כדי לוודא שההתקנה בוצעה, מריצים את הפקודה הבאה:
./toolbox --version
הגדרת לקוח MCP
בקטע הזה מוסבר איך להגדיר כלי פיתוח שונים כדי להתחבר למופע Cloud SQL באמצעות Toolbox. Toolbox הוא שרת Model Context Protocol (MCP) בקוד פתוח שפועל בין סביבת הפיתוח המשולבת (IDE) לבין מסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI. בוחרים את הכרטיסייה של הכלי הספציפי כדי לראות את הוראות ההגדרה.
Gemini CLI ל-Cloud SQL ל-SQL Server
- מתקינים את Gemini CLI.
- מתקינים את התוסף Cloud SQL for SQL Server ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:
במהלך התקנת התוסף, מחליפים את מה שכתוב בשדות הבאים:gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
מחליפים את מה שכתוב בשדות הבאים:export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MSSQL_REGION="REGION" export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של מופע Cloud SQL.
- INSTANCE_NAME: המזהה של מופע Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- PASSWORD: אופציונלי: הסיסמה של משתמש מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, כמו 'ציבורי' (ברירת מחדל) או 'פרטי'.
- מפעילים את Gemini CLI במצב אינטראקטיבי:
gemini
ממשק ה-CLI טוען באופן אוטומטי את התוסף Gemini CLI ל-Cloud SQL ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מסד הנתונים.
ב-Gemini CLI, משתמשים בפקודה
/extensionsכדי לוודא שהתוסף מותקן, ובפקודה/mcp listכדי לראות את הכלים.
Gemini CLI ל-SQL Server
- מתקינים את Gemini CLI.
- מתקינים את תוסף התוכנה SQL Server ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:
במהלך התקנת התוסף, מחליפים את מה שכתוב בשדות הבאים:gemini extensions install https://github.com/gemini-cli-extensions/sql-server
מחליפים את מה שכתוב בשדות הבאים:export MSSQL_HOST="HOST" export MSSQL_PORT="PORT" export MSSQL_DATABASE="DATABASE" export MSSQL_USER="USER" export MSSQL_PASSWORD="PASSWORD"
- HOST: שם המארח או כתובת ה-IP של שרת SQL Server.
- PORT: מספר היציאה של שרת SQL Server.
- DATABASE: השם של מסד הנתונים שאליו רוצים להתחבר.
- USER: שם המשתמש במסד הנתונים.
- PASSWORD: הסיסמה של משתמש מסד הנתונים.
- מפעילים את Gemini CLI במצב אינטראקטיבי:
gemini
ממשק ה-CLI טוען באופן אוטומטי את התוסף Gemini CLI ל-SQL Server ואת הכלים שלו, שבהם אפשר להשתמש כדי לקיים אינטראקציה עם מסד הנתונים.
Gemini Code Assist
- מתקינים את התוסף Gemini Code Assist ב-Visual Studio Code.
- הפעלת מצב סוכן בצ'אט של Gemini Code Assist.
- בספריית העבודה, יוצרים תיקייה בשם
.gemini. בתוך התיקייה, יוצרים קובץsettings.json. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } }
Claude code
- מתקינים את Claude Code.
- מגדירים משתני סביבה כדי להתחבר למופע Cloud SQL:
מחליפים את מה שכתוב בשדות הבאים:export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MSSQL_REGION="REGION" export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של מופע Cloud SQL.
- INSTANCE_NAME: המזהה של מופע Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- PASSWORD: אופציונלי: הסיסמה של משתמש מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, כמו 'ציבורי' (ברירת מחדל) או 'פרטי'.
- מפעילים את הסוכן:
claude
- מתקינים את הפלאגין:
/plugin install cloud-sql-sqlserver@claude-plugins-official
Claude למחשב
- פותחים את Claude Desktop ועוברים אל הגדרות.
- בכרטיסייה Developer (פיתוח), מקישים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ ההגדרות.
- כדי להתחבר לשרת ה-MCP ולהגדיר את משתני הסביבה, מוסיפים את השורות הבאות:
{ "mcpServers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } } - מפעילים מחדש את Claude Desktop. במסך הצ'אט החדש מוצג סמל ה-MCP עם שרת ה-MCP החדש שזמין.
Codex
- מתקינים את Data Agent Kit Marketplace:
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
- מתקינים את הפלאגין:
codex plugin install cloud-sql-sqlserver@data-agent-kit
- מגדירים את משתני הסביבה כדי להתחבר למכונת Cloud SQL:
מחליפים את מה שכתוב בשדות הבאים:export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MSSQL_REGION="REGION" export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של מופע Cloud SQL.
- INSTANCE_NAME: המזהה של מופע Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- PASSWORD: אופציונלי: הסיסמה של משתמש מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, כמו 'ציבורי' (ברירת מחדל) או 'פרטי'.
- זה שינוי אופציונלי. עדכון ה-Marketplace:
codex plugin marketplace upgrade data-agent-kit
- מריצים את הפקודה
codex plugin listאו משתמשים בתפריט האינטראקטיביpluginsכדי לאמת את הפלאגינים שהתקנתם.
קלין
- פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers.
- לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
- מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.{ "mcpServers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } }
סמן
- אם היא לא קיימת, יוצרים את הספרייה
.cursorבתיקיית הבסיס של הפרויקט. - יוצרים קובץ
.cursor/mcp.jsonאם הוא לא קיים ופותחים אותו. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } } - פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.
קוד Visual Studio (Copilot)
- פותחים את VS Code ויוצרים את הספרייה
.vscodeבתיקיית הבסיס של הפרויקט, אם היא לא קיימת. - יוצרים קובץ
.vscode/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "servers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } }
גלישת רוח
- פותחים את Windsurf ועוברים אל Cascade assistant.
- מקישים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
- מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-sqlserver": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mssql","--stdio"], "env": { "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MSSQL_REGION": "REGION", "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID", "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS", "CLOUD_SQL_MSSQL_USER": "USER_ID", "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD" } } } }