יכול להיות שחלק מהמידע בדף הזה או כולו לא רלוונטי ל-Cloud de Confiance by S3NS. פרטים נוספים מופיעים במאמר מה ההבדל מ-Google Cloud.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

חיבור מודלים של LLM ל-Cloud Storage באמצעות MCP

אתם יכולים להריץ שרת Model Context Protocol‏ (MCP) מקומי עם MCP Toolbox for Databases כדי ליצור אינטראקציה עם Cloud Storage ישירות מסביבת הפיתוח המשולבת (IDE) ומהכלים למפתחים. ההגדרה הזו מאפשרת למודלים גדולים של שפה (LLM) בלקוחות כמו Antigravity,‏ Claude,‏ Cline,‏ Cursor,‏ Visual Studio Code (Copilot) ו-Windsurf ליצור קטגוריות, לנהל נתוני אובייקטים ולבדוק את כללי המדיניות של ניהול הזהויות והרשאות הגישה (IAM).

‫MCP Toolbox בקוד פתוח תומך באימות OAuth2 ו-OIDC, ומשתלב עם OpenTelemetry לצורך ניראות (observability). כדי לשלב את Cloud Storage, צריך להשתמש ב-MCP Toolbox בגרסה 1.2.0 ואילך. כדי להריץ שרת MCP מקומי עצמאי בלי ארגז הכלים, משתמשים במאגר Cloud Storage MCP ב-GitHub.

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

במסוף Cloud de Confiance , בוחרים או יוצרים פרויקט ב- Cloud de Confiance by S3NS בדף לבחירת הפרויקט.
מוודאים שהחיוב מופעל בפרויקט ב- Cloud de Confiance .
מפעילים את Cloud Storage API בפרויקט ב- Cloud de Confiance .
כדי לבצע את המשימה הזו, צריך להגדיר את התפקידים וההרשאות הנדרשים. המשתמש שמפעיל את סוכני ה-LLM צריך את התפקידים הבאים ברמת הקטגוריה או הפרויקט:
- כדי להציג רשימה של קטגוריות, ליצור קטגוריות ולמחוק קטגוריות ריקות: אדמין של אחסון (roles/storage.admin)
- כדי להציג רשימה של אובייקטים, לקרוא אובייקטים, לקבל מטא-נתונים של אובייקטים או מטא-נתונים של קטגוריות: צפייה באובייקט אחסון (roles/storage.objectViewer)
- כדי לכתוב תוכן לאובייקט או להעלות אובייקט: יצירת אובייקטים באחסון (roles/storage.objectCreator)
- כדי להעתיק, להעביר או למחוק אובייקטים: אדמין של אובייקטים באחסון (roles/storage.objectAdmin)
מגדירים את Application Default Credentials (ADC) בסביבה שלכם.

התחברות ל-Antigravity

אתם מקשרים את Cloud Storage ל-Antigravity באמצעות הגדרה בהתאמה אישית. בהקשר הזה, שרת MCP בהתאמה אישית הוא שרת שמגדירים באופן ידני על ידי עריכת קובץ התצורה (כמו mcp_config.json). ההגדרה הידנית הזו מחליפה את ההתקנה של השרת ישירות מהקטלוג המובנה של MCP Store.

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

כדי לוודא ש-npx מותקן ומוגדר כמו שצריך במערכת, מריצים את npx --version בטרמינל. אם אתם צריכים להתקין את Node.js, שכולל את npx, עיינו במדריך הורדה והתקנה של Node.js ו-npm של npm.
פותחים את Antigravity ועוברים לחנות MCP באמצעות התפריט הנפתח "..." בחלק העליון של חלונית הסוכן בכלי העריכה.
כדי לפתוח את הקובץ mcp_config.json, לוחצים על שרתי MCP ואז על ניהול שרתי MCP > הצגת ההגדרות הגולמיות.

מוסיפים את ההגדרות הבאות, מחליפים את ה-placeholder במזהה הפרויקט ושומרים:

{
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

התקנת MCP Toolbox

ארגז הכלים הוא שרת Model Context Protocol‏ (MCP) בקוד פתוח שפועל באופן מקומי במחשב שלכם. השרת המקומי מנהל את התקשורת בין ה-IDE לבין Cloud Storage. החיבור הזה מספק סביבה מאובטחת ויעילה לכלי ה-AI שלכם.

מורידים את הגרסה העדכנית של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה (OS) ולארכיטקטורת המעבד (CPU). צריך להשתמש ב-MCP Toolbox בגרסה 1.2.0 ואילך:
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v1.2.0.
macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v1.2.0.
macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v1.2.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v1.2.0.
הופכים את הקובץ הבינארי לקובץ הפעלה:
```
chmod +x toolbox
```
מאמתים את ההתקנה:
```
./toolbox --version
```

כדי להגדיר את ארגז הכלים עם קובץ אימג' של קונטיינר או Homebrew, עיינו בדף התקנת ארגז הכלים.

הגדרת לקוחות וחיבורים

בקטע הזה מוסבר איך לחבר את Cloud Storage לכלים שלכם אחרי שאתם מתקינים את MCP Toolbox.

Claude Code

מתקינים את Claude Code.
יוצרים קובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
מוסיפים את ההגדרות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
מפעילים מחדש את Claude Code כדי לטעון את ההגדרות החדשות. כשתפתחו מחדש את Claude Code, האפליקציה תזהה את שרת ה-MCP שהגדרתם.

Claude במחשב

פותחים את Claude Desktop ועוברים אל הגדרות.
בכרטיסייה Developer, לוחצים על Edit Config כדי לפתוח את קובץ התצורה.
מוסיפים את ההגדרות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
מפעילים מחדש את Claude Desktop.
במסך הצ'אט החדש מופיע סמל של פטיש (MCP) עם שרת ה-MCP החדש.

Cline

פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל שרתי MCP.
לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
מוסיפים את ההגדרות הבאות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .

אחרי שהשרת יתחבר בהצלחה, יופיע סטטוס פעיל בצבע ירוק.

סמן

אם הספרייה .cursor לא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה.
יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
מוסיפים את ההגדרות הבאות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP (הגדרות > הגדרות Cursor ‏> MCP). כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.

‫Visual Studio Code ‏ (Copilot)

פותחים את VS Code ויוצרים ספריית .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
מוסיפים את ההגדרות הבאות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
טוענים מחדש את החלון של VS Code. התוסף שתואם ל-MCP מזהה באופן אוטומטי את ההגדרות ומתחיל את השרת.

גלישת רוח

פותחים את Windsurf ועוברים אל Cascade Assistant.
לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
מוסיפים את ההגדרות הבאות, מחליפים את ה-placeholders בערכים הרלוונטיים ושומרים:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
מחליפים את המשתנים הבאים בערכים שלכם:
- ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי של toolbox.
- ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Cloud de Confiance .
- ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .

כלים מוכנים מראש

אחרי שמקשרים את MCP Toolbox ל-Cloud Storage, הסוכן משתמש בכלים הבאים שנוצרו מראש:

‫list_buckets: הצגת רשימה של הקטגוריות של Cloud Storage בפרויקט שהוגדר.
‫list_objects: הצגת רשימה של אובייקטים בקטגוריה, עם אפשרות לסינון לפי תחילית ותו מפריד.
‫get_bucket_metadata: מחזירה מטא-נתונים של קטגוריה.
‫get_bucket_iam_policy: מחזירה את קישורי מדיניות ה-IAM של קטגוריה.
‫get_object_metadata: מחזירה מטא-נתונים של אובייקט.
‫read_object: קריאת אובייקט טקסט בקידוד UTF-8 (או טווח בייטים). מוגבל ל-8MiB, אובייקטים בינאריים נדחים.
‫download_object: הורדת אובייקט לנתיב מקומי.
‫create_bucket: יוצרת קטגוריה בפרויקט שהוגדר.
‫delete_bucket: מחיקת קטגוריה ריקה.
‫upload_object: העלאת קובץ מקומי לאובייקט.
‫write_object: כתיבת תוכן טקסט ישירות לאובייקט.
‫copy_object: העתקת אובייקט לאובייקט יעד.
‫move_object: משנה את השם של אובייקט באותה קטגוריה באופן אטומי.
‫delete_object: מחיקת אובייקט.