שימוש ב-MCP Toolbox for Databases

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

בדף הזה מוסבר איך להשתמש ב-MCP Toolbox for Databases כדי לחבר את מכונת Looker לסביבות פיתוח משולבות (IDE) ולכלי פיתוח שתומכים ב-Model Context Protocol‏ (MCP). ערכת הכלים של MCP היא אפשרות טובה אם אתם משתמשים באירוח בצד הלקוח, או אם אתם מעדיפים לנהל את התשתית שלכם בעצמכם. אחרת, מומלץ להשתמש בשרת MCP שמנוהל על ידי Looker.

מומלץ להשתמש בתוסף הייעודי ל-Looker בשביל Gemini CLI עם MCP Toolbox. אפשר להשתמש בשכבה הסמנטית של Looker כדי לספק ל-Gemini CLI גישה מאובטחת, מבוקרת ועל פי דרישה לנתונים מהימנים, ולזרז את תהליכי העבודה על ידי אוטומציה של יצירת דוחות, תרשימים ולוחות בקרה מהנחיות בשפה טבעית. ‫Gemini CLI הוא ממשק שורת הפקודה מהדור הבא של Looker, והוא הכלי המומלץ לאינטראקציה עם מופעי Looker משורת הפקודה. Google Cloud

אפשר גם לחבר סביבות פיתוח משולבות (IDE) אחרות וכלים למפתחים שתומכים ב-Model Context Protocol‏ (MCP) באמצעות MCP Toolbox for Databases לשימוש כללי. ‫MCP Toolbox הוא שרת MCP בקוד פתוח שמפשט את החיבור של סוכני AI לנתונים שלכם. הוא מטפל במורכבויות כמו אימות ואיגום חיבורים, ומאפשר לכם ליצור אינטראקציה עם הנתונים באמצעות שפה טבעית ישירות מסביבת הפיתוח המשולבת (IDE). השיטה הזו מספקת יכולות ליבה של אינטראקציה עם מסד נתונים עבור הכלים האלה.

הערה: MCP Toolbox הוא פרויקט בקוד פתוח שמוצע "כמו שהוא". הוא לא נכלל במוצרים הנתמכים Google Cloud ולא מכוסה בהנחיות לשירותי תמיכה טכנית או בהסכמי רמת שירות (SLA). Google Cloud לקבלת תמיכה, אפשר לעיין בדף הבעיות ב-GitHub של הפרויקט.

מידע על Gemini CLI ותוספים

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

איך תוספים פועלים

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

הכנת אימות Looker

יש שתי אפשרויות לאימות לקוח MCP ב-Looker: אפשר להשתמש בפרטי כניסה רגילים ל-API או לאמת את הלקוח באמצעות רישום אפליקציית OAuth.

אפשרות 1: פרטי כניסה ל-API

1. מקבלים מזהה לקוח וסוד לקוח של Looker. פועלים לפי ההוראות בדף התיעוד בנושא אימות Looker API.
2. צריכה להיות לכם גישה לכתובת ה-URL הבסיסית של המופע ב-Looker. הוא כנראה ייראה כך: https://looker.example.com. במקרים מסוימים, ה-API מאזין ביציאה אחרת, ותצטרכו להשתמש ב-https://looker.example.com:19999 במקום זאת.

אפשרות 2: רישום אפליקציית OAuth

1. פותחים את Looker API Explorer.

   ‫API Explorer מותקן

   אם API Explorer כבר מותקן במכונה של Looker, אפשר לגשת אליו באמצעות פורמט כתובת ה-URL הבא:

   LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
   

   ‫API Explorer לא מותקן

   אם אין לכם את API Explorer במכונה של Looker, אתם יכולים להתקין אותו מ-Looker Marketplace. מידע על התקנת API Explorer זמין בדף שימוש ב-API Explorer.

   מופע פרטי של PSA

   אם אתם משתמשים במופע של חיבורים פרטיים ב-Looker (Google Cloud core) שמשתמש בגישה לשירותים פרטיים, אי אפשר להשתמש ב-Looker Marketplace וב-API Explorer. כדי לרשום סוכן AI, צריך לשלוח קריאה ישירה לנקודת קצה ל-API‏ oauth_client_apps. אם משתמשים בשיטה הזו, אפשר לדלג על שאר השלבים בתהליך הזה של API Explorer.

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

   curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
   -H "Authorization: token ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
     "redirect_uri": "REDIRECT_URI",
     "display_name": "CLIENT_NAME",
     "description": "OAuth client to access MCP server using CLIENT_NAME",
     "enabled": true
   }'
   

2. בקטע Auth method, מחפשים את נקודת הקצה ל-API Register OAuth App. אפשר גם לחפש 'אפליקציית OAuth' בשדה חיפוש.

3. לוחצים על הפעלה.

4. במאפיין client_guid, מזינים מחרוזת מותאמת אישית (לדוגמה, gemini_cli או claude-desktop).

5. בגוף הבקשה, מזינים את הגדרת ה-JSON הבאה:

   {
     "redirect_uri": "AI_AGENT_REDIRECT_URI",
     "display_name": "APPLICATION_NAME",
     "description": "APPLICATION_DESCRIPTION",
     "enabled": true
   }
   

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

   • ‫AI_AGENT_REDIRECT_URI: ה-URI של ההפניה לכתובת אחרת של תוסף סוכן ה-AI או של אפליקציית השירות המשותף.

     • באפליקציות שמתארחות בענן, יכול להיות שהיא תיראה כמו כתובת URL מאובטחת מסוג HTTPS: https://AI_AGENT_URL/oauth2callback

     • באפליקציות שפועלות באופן מקומי, כתובת ה-URL צריכה להיות localhost עם יציאה סטטית: http://localhost:7777/oauth/callback

       הערה: יכול להיות שבכלים מסוימים, כמו Gemini CLI, תצטרכו להגדיר משתנה סביבה (לדוגמה, export OAUTH_CALLBACK_PORT=7777) כדי לוודא שהכלים משתמשים ביציאה סטטית שתואמת לכתובת ה-URI של ההפניה הרשומה.

     • בסביבות פיתוח משולבות (IDE), זה יכול להיראות כך: vscode://google.vscode-looker-official/oauth_callback

   • ‫APPLICATION_NAME: השם המוצג של אפליקציית OAuth, לדוגמה Claude Desktop.

   • ‫APPLICATION_DESCRIPTION: תיאור קצר של אפליקציית OAuth.

6. מסמנים את תיבת האישור לצד I understand that this API endpoint will change data (ברור לי שנקודת קצה ל-API זו תשנה את הנתונים), ואז לוחצים על Run (הפעלה).

התקנת MCP Toolbox

הערה: אם אתם משתמשים ב-Gemini CLI או ב-Gemini Code Assist כדי להתחבר למופע Looker באמצעות MCP Toolbox for Databases, אתם לא צריכים להתקין את MCP Toolbox. ‫MCP Toolbox יותקן כשמתקינים את התוסף Gemini במהלך שלב ההגדרה.

1. מורידים את הגרסה האחרונה של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת המעבד שלכם. צריך להשתמש ב-MCP Toolbox בגרסה V1.0.0 ואילך.

   ‫linux/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
   
   

   darwin/arm64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
   
   

   darwin/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
   
   

   windows/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe
   
   

2. הופכים את הקובץ הבינארי לקובץ הפעלה.

   chmod +x toolbox
   

3. מאמתים את ההתקנה.

   ./toolbox --version
   

הפעלת MCP Toolbox כשירות משותף

עבור לקוחות MCP שנדרש להם אימות OAuth באמצעות HTTPS, צריך לפרוס את MCP Toolbox מאחורי שרת proxy הפוך של HTTPS (כמו Cloud Run). ה-reverse proxy מסיים את ה-SSL ומעביר בקשות למאגר של MCP Toolbox.

הגדרת סביבת השרת

1. מגדירים את משתני הסביבה הבאים בפריסה:

   • LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
   • LOOKER_USE_CLIENT_OAUTH=true

2. מריצים את ערכת הכלים של MCP עם הארגומנטים הבאים:

   • --prebuilt=looker,looker-dev
   • --mcp-prm-file=prm.json
   • [--address=0.0.0.0]
   • [--port=8080]

   בדרך כלל, MCP Toolbox מאזין ביציאה 127.0.0.1 5000. אם ה-reverse proxy נמצא במארח אחר, משתמשים ב---address=0.0.0.0 כדי לבצע איגוד לכל כתובות ה-IP. משתמשים בהגדרה --port= אם צריך להשתמש ביציאת האזנה אחרת מלבד 5000. לדוגמה, Cloud Run מעביר באופן אוטומטי תנועה חיצונית מיציאה 443, יציאת ה-HTTPS, אל 8080.

3. יוצרים קובץ תצורה של מטא-נתונים של משאב מוגן (PRM) (prm.json) עם המבנה הבא:

   {
   "resource": "https://PROXY_URL/mcp",
   "authorization_servers": ["LOOKER_URL"],
   "scopes_supported": ["cors_api"]
   }
   

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

   • ‫PROXY_URL: הדומיין ונתיב הבסיס של שרת ה-reverse proxy.
   • ‫LOOKER_URL: כתובת ה-URL הבסיסית של מופע Looker.

דוגמה להגדרת הלקוח כשמפעילים את MCP Toolbox כשירות משותף מופיעה בדוגמה להגדרת Claude למחשב.

הגדרת לקוח ה-MCP

בקטע הזה מוסבר איך להגדיר כלי פיתוח שונים כדי להתחבר למופע Looker באמצעות MCP Toolbox for Databases. ערכת הכלים פועלת כשרת Model Context Protocol‏ (MCP) בקוד פתוח, שנמצא בין סביבת הפיתוח המשולבת (IDE) לבין מסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI. בוחרים את הכרטיסייה של הכלי הספציפי כדי לראות את הוראות ההגדרה.

• Gemini CLI
• Gemini Code Assist
• Claude code
• Claude למחשב
• ‫Cline (תוסף ל-VS Code)
• Cursor
• קוד Visual Studio (Copilot)
• ‫Windsurf (Codium)

Gemini CLI

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API עם תוסף

1. מתקינים את Gemini CLI.
2. מתקינים את התוסף Looker ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:

   gemini extensions install https://github.com/gemini-cli-extensions/looker
   

3. מגדירים משתני סביבה כדי להתחבר למופע Looker, ומחליפים את משתני הסביבה הבאים בערכים שלכם:
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

   export LOOKER_BASE_URL="LOOKER_URL"
   export LOOKER_CLIENT_ID="CLIENT_ID"
   export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
   export LOOKER_VERIFY_SSL="VERIFY_SSL"
   

4. מפעילים את Gemini CLI במצב אינטראקטיבי:
   ‫

   gemini
   

   ממשק ה-CLI טוען באופן אוטומטי את התוסף Looker ל-Gemini CLI ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מופע Looker.

אפשרות 2: שירות משותף מרוחק עם OAuth

כדי להתחבר לשירות מרוחק משותף באמצעות OAuth, אל תתקינו את תוסף Looker. במקום זאת, צריך להגדיר את Gemini CLI כך שיתחבר ישירות לשרת ה-MCP המרוחק.

1. מתקינים את Gemini CLI.
2. מוסיפים את שרת ה-MCP המרוחק באמצעות הפקודה הבאה, ומחליפים את PROXY_URL בדומיין של שרת ה-proxy ההפוך:

   gemini mcp add --transport http looker https://PROXY_URL/mcp
   

   אפשר גם להגדיר את זה באופן ידני על ידי הוספת ההגדרה הבאה לקובץ settings.json (שנמצא ב-~/.gemini/settings.json או בספריית הפרויקט):

   {
     "mcpServers": {
       "looker": {
         "httpUrl": "https://PROXY_URL/mcp"
       }
     }
   }
   

3. מפעילים את Gemini CLI במצב אינטראקטיבי:

   gemini
   

   כשמוצגת בקשה להתחבר, ה-CLI מתחיל את תהליך ההרשאה של OAuth כדי לבצע אימות מאובטח במופע Looker.

Gemini Code Assist

מומלץ להגדיר את Gemini Code Assist לשימוש ב-Gemini CLI. הגישה הזו מייתרת את הצורך להגדיר שרת MCP באופן ידני.

1. מוודאים שהתקנתם והגדרתם את Gemini CLI ואת התוסף looker (לפרטי כניסה ל-API) או הגדרתם שרת MCP מרוחק (לשירות משותף עם OAuth).
2. איך מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI
3. מתחילים אינטראקציה עם מופע Looker באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.

Claude code

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. מתקינים את Claude Code.
2. יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

אפשרות 2: שירות משותף מרוחק עם OAuth

1. מתקינים את Claude Code.
2. יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
3. מוסיפים את ההגדרה הבאה, מחליפים את PROXY_URL בדומיין של שרת ה-reverse proxy ושומרים.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

‫Claude למחשב

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. פותחים את Claude למחשב ועוברים אל הגדרות.
2. בכרטיסייה Developer (פיתוח), לוחצים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

אפשרות 2: שירות משותף מרוחק עם OAuth

1. ב-Claude למחשב, עוברים אל הגדרות ובוחרים באפשרות מחברים.
2. בוחרים באפשרות הוספת מחבר בהתאמה אישית ומזינים שם (לדוגמה, Looker).
3. בכתובת ה-URL, מזינים את נקודת הקצה של שרת ה-proxy ההפוך עם הנתיב /mcp שנוסף (לדוגמה, https://looker-mcp-toolbox.example.com/mcp).
4. בקטע הגדרות מתקדמות, מזינים את המחרוזת המדויקת שבה השתמשתם בשביל client_guid במהלך רישום אפליקציית OAuth. משאירים את סוד הלקוח ב-OAuth ריק.
5. לוחצים על הוספה כדי לשמור את המחבר. כשמוצגת בקשה להתחבר, Claude למחשב מתחיל בצורה מאובטחת את תהליך ההרשאה של PKCE דרך הדפדפן.

4. מפעילים מחדש את Claude לשולחן העבודה.

קלין

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
2. לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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

אפשרות 2: שירות משותף מרוחק עם OAuth

1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
2. לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים את ההגדרה הבאה, מחליפים את PROXY_URL בדומיין של שרת ה-reverse proxy ושומרים.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

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

סמן

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. אם התיקייה .cursor לא קיימת, יוצרים אותה בתיקיית הבסיס של הפרויקט.
2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

4. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

אפשרות 2: שירות משותף מרוחק עם OAuth

1. אם התיקייה .cursor לא קיימת, יוצרים אותה בתיקיית הבסיס של הפרויקט.
2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
3. מוסיפים את ההגדרה הבאה, מחליפים את PROXY_URL בדומיין של שרת ה-reverse proxy ושומרים.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

4. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קוד Visual Studio ‏ (Copilot)

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. פותחים את VS Code ויוצרים את הספרייה .vscode ברמה הבסיסית של הפרויקט, אם היא לא קיימת.
2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "servers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

אפשרות 2: שירות משותף מרוחק עם OAuth

1. פותחים את VS Code ויוצרים את הספרייה .vscode ברמה הבסיסית של הפרויקט, אם היא לא קיימת.
2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
3. מוסיפים את ההגדרה הבאה, מחליפים את PROXY_URL בדומיין של שרת ה-reverse proxy ושומרים.

      {
        "servers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

גלישת רוח

בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:

אפשרות 1: פרטי כניסה ל-API

1. פותחים את Windsurf ועוברים אל Cascade assistant.
2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
   • ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
   • ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
   • ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

אפשרות 2: שירות משותף מרוחק עם OAuth

1. פותחים את Windsurf ועוברים אל Cascade assistant.
2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים את ההגדרה הבאה, מחליפים את PROXY_URL בדומיין של שרת ה-reverse proxy ושומרים.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

שימוש בכלים מבוססי-AI

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

הכלים הבאים זמינים ל-LLM:

כלי שאילתות ומודל Looker

הכלים האלה משמשים לקבלת מידע על מודל Looker ולהרצת שאילתות על המודל הזה.

• ‫get_models: רשימה של כל מודלי LookML במופע Looker.
• ‫get_explores: רשימת הניתוחים במודל נתון.
• ‫get_dimensions: הצגת המאפיינים ב'ניתוח נתונים' נתון.
• ‫get_measures: רשימת המדדים ב-Explore נתון.
• ‫get_filters: הצגת המסננים ב-Explore נתון.
• ‫get_parameters: רשימת הפרמטרים ב-Explore נתון.
• ‫query: מריצים שאילתה ומחזירים את הנתונים.
• ‫query_sql: מחזירה את ה-SQL שנוצר על ידי Looker עבור שאילתה.
• ‫query_url: מחזירה קישור לשאילתה ב-Looker כדי להמשיך בניתוח.

כלים לניהול תוכן ב-Looker

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

• ‫get_looks: החזרת המראה השמור שתואם לשם או לתיאור.
• ‫run_look: מריצים Look שמור ומחזירים את הנתונים.
• ‫make_look: יצירת Look שמור ב-Looker והחזרת כתובת ה-URL.
• ‫get_dashboards: החזרת לוחות הבקרה השמורים שתואמים לשם או לתיאור.
• ‫make_dashboard: יצירת מרכז בקרה שמור ב-Looker והחזרת כתובת ה-URL.
• add_dashboard_element: הוספת אריח למרכז הבקרה.

כלי בדיקת תקינות של מכונת Looker

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

• ‫health_pulse: בדיקת תקינות של מופע Looker.
• ‫health_analyze: ניתוח השימוש באובייקט Looker.
• ‫health_vacuum: חיפוש רכיבי LookML שאולי לא נעשה בהם שימוש.

כלים לעריכה ב-LookML

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

• ‫dev_mode: הפעלה והשבתה של מצב פיתוח בסשן. כתיבת LookML חייבת להתבצע במצב פיתוח. שאילתות שמופעלות במצב פיתוח משתמשות ב-LookML ששונה, כך שאפשר לבדוק את ההשפעה של השינויים.
• ‫get_projects: קבלת רשימה של פרויקטים זמינים של LookML.
• ‫get_project_files: קבלת רשימת קובצי LookML בפרויקט.
• ‫get_project_file: קבלת התוכן של קובץ LookML.
• ‫create_project_file: יצירת קובץ LookML חדש.
• ‫update_project_file: שינוי קובץ LookML קיים.
• ‫delete_project_file: מחיקת קובץ LookML.
• ‫get_connections: קבלת רשימת החיבורים.
• ‫get_connection_schemas: קבלת רשימת הסכימות של חיבור.
• ‫get_connection_databases: קבלת רשימת מסדי הנתונים לחיבור.
• ‫get_connection_tables: קבלת רשימת הטבלאות של חיבור.
• ‫get_connection_table_columns: קבלת רשימת העמודות של טבלה בחיבור.

הערה: כלים מוכנים מראש הם גרסה שלפני 1.0, לכן צפויים שינויים מסוימים בכלים בין הגרסאות. מכיוון שמודלים מסוג LLM מותאמים לכלים הזמינים, רוב המשתמשים לא יושפעו.