אפשרויות הגדרה

Matthias Rohmer
José Luis Zapata

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

מגדירים את השרת על ידי העברת פלאגים של שורת פקודה במערך args של קובץ ההגדרות של לקוח Model Context Protocol‏ (MCP). בדרך כלל זה הקובץ config.json.

לדוגמה, כדי להריץ את Chrome במצב 'דפדפן בלי GUI' ולהשתמש בערוץ Canary, צריך להשתמש בהגדרה הבאה:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

תרחישי הגדרה נפוצים

בתרחישים הבאים מתוארות דרכים נפוצות להגדרת כלי הפיתוח ל-Chrome עבור סוכנים.

הפעלה במצב 'דפדפן ללא GUI'

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

התחברות לסשן קיים של הדפדפן

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

יש שתי דרכים להתחבר לסשן קיים:

חיבור אוטומטי (Chrome 144 ואילך)

אם משתמשים בדגל --autoConnect, שרת ה-MCP מתחבר אוטומטית למופע פעיל של Chrome.

  1. בדפדפן Chrome שפועל, עוברים אל chrome://inspect/#remote-debugging ומפעילים את האפשרות ניפוי באגים מרחוק.
  2. מוסיפים את --autoConnect להגדרות ה-MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
  3. כשסוכן מנסה להתחבר, מוצגת ב-Chrome תיבת דו-שיח שבה מתבקשת הרשאה. לוחצים על אישור.

חיבור ידני

אם אי אפשר להשתמש ב---autoConnect (לדוגמה, בסביבת ארגז חול), אפשר להפעיל את Chrome באופן ידני עם יציאת ניפוי באגים ולהתחבר באמצעות --browser-url.

  1. מפעילים את Chrome מהטרמינל עם ניפוי באגים מרחוק וספריית נתוני משתמשים מותאמת אישית.
    • ‫macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
    • ‫Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
    • ‫Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
  2. מגדירים את הסוכן להתחבר ליציאה הזו: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

הסבר על אפשרויות ההגדרה

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

אפשרויות חיבור

אפשר להשתמש באפשרויות האלה כדי להגדיר איך השרת מתחבר ל-Chrome.

דגל סוג ברירת מחדל תיאור
--autoConnect או --auto-connect בוליאני false מתחבר אוטומטית למופע של Chrome (גרסה 144 ומעלה) שפועל באופן מקומי. צריך להפעיל ניפוי באגים מרחוק באמצעות chrome://inspect/#remote-debugging.
‫--browserUrl או --browser-url
-u		 מחרוזת false מתחברים למופע של Chrome שפועל ואפשר לבצע בו ניפוי באגים (לדוגמה, http://127.0.0.1:9222).
‫--wsEndpoint או --ws-endpoint
-w		 מחרוזת false נקודת קצה של WebSocket להתחברות למופע Chrome שפועל (לדוגמה, ws://127.0.0.1:9222/devtools/browser/<id>). חלופה ל---browserUrl.
--wsHeaders או --ws-headers מחרוזת false כותרות מותאמות אישית לחיבור WebSocket בפורמט JSON (לדוגמה, '{"Authorization":"Bearer token"}'). פועל רק עם --wsEndpoint.

אפשרויות להפעלת הדפדפן

האפשרויות האלה חלות כששרת ה-MCP מפעיל את Chrome.

דגל סוג ברירת מחדל תיאור
--headless בוליאני false מריץ את Chrome במצב headless (ללא ממשק משתמש).
--channel מחרוזת stable קובעת באיזה ערוץ של Chrome יש להשתמש. אפשרויות: canary, ‏dev, ‏beta ו-stable.
‫--executablePath או --executable-path
-e		 מחרוזת false נתיב לקובץ הרצה מותאם אישית של Chrome.
--userDataDir או --user-data-dir מחרוזת הצגת התיאור הנתיב לספרייה של נתוני המשתמש. ערך ברירת המחדל הוא $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE.
--isolated בוליאני false יוצר ספרייה זמנית של נתוני משתמשים שמנוקה באופן אוטומטי כשהדפדפן נסגר.
--viewport מחרוזת false גודל אזור התצוגה הראשוני (לדוגמה, 1280x720). במצב headless, הגודל המקסימלי הוא 3840x2160.
--proxyServer או --proxy-server מחרוזת false הגדרות שרת ה-Proxy מועברות ל-Chrome.
--chromeArg או --chrome-arg מערך false ארגומנטים נוספים להעברה אל Chrome.
--ignoreDefaultChromeArg או --ignore-default-chrome-arg מערך false השבתה מפורשת של ארגומנטים שמוגדרים כברירת מחדל ב-Chrome.

אפשרויות אבטחה ופרטיות

אפשר להשתמש באפשרויות האלה כדי לנהל את הגדרות האבטחה ואת פרטיות הנתונים.

דגל סוג ברירת מחדל תיאור
--acceptInsecureCerts או --accept-insecure-certs בוליאני false מתעלם משגיאות שקשורות לאישורים עם חתימה עצמית ולאישורים שתוקפם פג. צריך להשתמש באפשרות הזו בזהירות.
--blockedUrlPattern או --blocked-url-pattern מערך false הגבלת הגישה לרשת על ידי חסימת תבניות URL שצוינו (השימוש הוא ב-URLPattern). חוסם ניווטים ומשאבי משנה.
--allowedUrlPattern או --allowed-url-pattern מערך false מגבילה את הגישה לרשת על ידי מתן אפשרות רק לתבניות URL שצוינו. נדרשת גרסה 149 ומעלה של Chrome.
--redactNetworkHeaders או --redact-network-headers בוליאני false הפונקציה מחריגה כותרות רגישות של רשת לפני שהיא מחזירה אותן ללקוח.
--usageStatistics או --usage-statistics בוליאני true הפעלה של איסוף נתוני שימוש כדי לשפר את הכלי. אפשר גם להשבית את התכונה באמצעות משתני הסביבה CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS או CI.
--performanceCrux או --performance-crux בוליאני true שולח כתובות URL ממעקב הביצועים אל Google CrUX API כדי לאחזר נתונים על חוויית משתמש אמיתית.

קטגוריות של תכונות

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

דגל סוג ברירת מחדל תיאור
--categoryEmulation או --category-emulation בוליאני true מאפשרת שימוש בכלים שקשורים לאמולציה.
--categoryNetwork או --category-network בוליאני true הגדרה שמאפשרת שימוש בכלים שקשורים לרשת.
--categoryPerformance או --category-performance בוליאני true מפעיל כלים שקשורים לביצועים.
--categoryExtensions או --category-extensions בוליאני false הגדרת כלים שקשורים לתוספים. התמיכה זמינה רק בחיבור צינור.
--categoryExperimentalThirdParty או --category-experimental-third-party בוליאני false הפעלה של כלים למפתחים של צד שלישי שנחשפים על ידי הדף שנבדק.
--categoryExperimentalWebmcp או --category-experimental-webmcp בוליאני false הגדרה שמאפשרת ניפוי באגים בכלי WebMCP. נדרשת גרסה 149 ואילך של Chrome עם תכונות WebMCP מופעלות.
--memoryDebugging או --memory-debugging בוליאני false ההגדרה מפעילה כלים לניפוי באגים בזיכרון.

אפשרויות לצילום מסך

באמצעות האפשרויות האלה אפשר להתאים אישית את האופן שבו הסוכן מצלם צילומי מסך.

דגל סוג ברירת מחדל תיאור
--screenshotFormat או --screenshot-format מחרוזת false החלפת פורמט הפלט שמוגדר כברירת מחדל (png). האפשרויות: jpeg, png ו-webp. הפורמטים jpeg ו-webp קטנים יותר, ולכן הם עוזרים להקטין את גודל ההקשר בשיחות עם AI.
--screenshotQuality או --screenshot-quality number false הגדרה שמשנה את איכות הדחיסה (0-100) של jpeg ו-webp.
--screenshotMaxWidth או --screenshot-max-width number false הרוחב המקסימלי בפיקסלים. צילומי מסך גדולים יותר עוברים הקטנה.
--screenshotMaxHeight או --screenshot-max-height number false הגובה המקסימלי בפיקסלים. צילומי מסך גדולים יותר עוברים הקטנה.

אפשרויות ניסיוניות

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

דגל סוג ברירת מחדל תיאור
--experimentalPageIdRouting או --experimental-page-id-routing בוליאני false החשיפה של pageId בכלי היקף הדף מאפשרת לנתב בקשות בסשנים מקבילים של סוכנים.
--experimentalDevtools או --experimental-devtools בוליאני false הפעלה של אוטומציה ביעדים של כלי הפיתוח.
--experimentalVision או --experimental-vision בוליאני false מאפשר שימוש בכלים מבוססי קואורדינטות (לדוגמה, click_at). בדרך כלל נדרש מודל לשימוש במחשב שיכול להפיק קואורדינטות מדויקות על ידי ניתוח צילומי מסך.
--experimentalStructuredContent או --experimental-structured-content בוליאני false יצירת פלט של תוכן מובנה בפורמט הנכון.
--experimentalIncludeAllPages או --experimental-include-all-pages בוליאני false כולל את כל סוגי הדפים (לדוגמה, תצוגות אינטרנט ודפים ברקע).
--experimentalScreencast או --experimental-screencast בוליאני false חשיפה של כלי Screencast (נדרש ffmpeg בנתיב).
--experimentalFfmpegPath או --experimental-ffmpeg-path מחרוזת false הנתיב לקובץ ההרצה של ffmpeg.

אפשרויות אחרות

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

דגל סוג ברירת מחדל תיאור
--slim בוליאני false כולל קבוצה קטנה של שלושה כלים (ניווט, הפעלת סקריפט וצילומי מסך). שימושי למשימות בסיסיות בדפדפן.
--logFile או --log-file מחרוזת false הנתיב לקובץ שבו ייכתבו יומני ניפוי הבאגים.

משתני סביבה

אפשר גם להשתמש במשתני הסביבה הבאים כדי להגדיר את השרת:

  • ‫CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: אם המאפיין מוגדר, איסוף נתוני השימוש מושבת (שווה ל---no-usage-statistics).
  • ‫CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: אם המדיניות מוגדרת, היא משביתה את הבדיקות התקופתיות של עדכונים.
  • ‫CI: אם המאפיין מוגדר, איסוף נתוני השימוש מושבת.
  • ‫DEBUG: מוגדר ל-* כדי להפעיל רישום מפורט של ניפוי הבאגים ביומן (פועל בשילוב עם --logFile).