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

Matthias Rohmer
José Luis Zapata

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

מגדירים את השרת על ידי העברת הגדרות flag בשורת הפקודה במערך 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 לסוכני AI.

הפעלה במצב ללא GUI

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

חיבור לסשן פעיל בדפדפן

כברירת מחדל, כלי הפיתוח לסוכני AI מפעילים מכונה חדשה של 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"]

מתן הרשאת גישה לקבצים מחוץ לספרייה הזמנית

כלים שקוראים או כותבים קבצים (לדוגמה, שמירת צילומי מסך, מעקבים או טעינת תוספים) יכולים לגשת רק לנתיבים בתוך שורשי סביבת העבודה שהוגדרו. השרת משתמש בשורשים שסופקו על ידי לקוח ה-MCP באמצעות היכולת MCP roots, ובכל הספריות שמועברות עם --filesystemRoot (כינוי --workspace). אם הלקוח לא מספק שורשים ולא מוגדר --filesystemRoot, הגישה לקובץ מוגבלת לספרייה הזמנית של מערכת ההפעלה. בקשות לנתיבים אחרים נכשלות עם השגיאה Access denied: ... is not within any of the configured workspace roots.

כדי לאפשר גישה לספריית פרויקט, מוסיפים את --filesystemRoot לארגומנטים של השרת. אפשר לחזור על האפשרות כדי לאפשר כמה ספריות:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

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

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

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

אפשר להשתמש באפשרויות האלה כדי להגדיר את אופן החיבור של השרת ל-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 שצוינו. נדרש Chrome מגרסה 149 ואילך.
--redactNetworkHeaders או --redact-network-headers בוליאני false מצנזר כותרות רשת רגישות לפני שהן מוחזרות ללקוח.
--usageStatistics או --usage-statistics בוליאני true הפעלת איסוף של נתוני שימוש כדי לשפר את הכלי. אפשר גם להשבית את האפשרות הזו באמצעות משתני הסביבה CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS או CI.
--performanceCrux או --performance-crux בוליאני true שליחת כתובות URL ממעקבי ביצועים אל Google CrUX API כדי לאחזר נתונים על חוויית המשתמש בפועל.
--javascriptEvaluation או --javascript-evaluation בוליאני true צריך להגדיר את הערך false כדי להשבית את ההרצה של JavaScript. כשההגדרה מושבתת, כלי ההערכה של הסקריפט מושבתים, הפרמטר initScript של navigate_page מושבת, ואי אפשר לנווט לכתובות URL של javascript:, data: או vbscript:.
‫--filesystemRoot או --filesystem-root
--workspace		 מערך ספרייה זמנית של מערכת ההפעלה ספרייה שכלים לגישה לקבצים יכולים להשתמש בה, בנוסף לספריות הבסיס שסופקו על ידי לקוח ה-MCP. אפשר לציין את הפרמטר הזה יותר מפעם אחת. אפשר לעיין בקטע מתן גישה לקבצים מחוץ לספרייה הזמנית.
--allowUnrestrictedPaths או --allow-unrestricted-paths בוליאני false הוצא משימוש: במקום זאת, צריך להשתמש ב---workspace=/. ההגדרה משביתה את הגבלת הנתיב שחלה כשלקוח MCP לא מספק שורשים.

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

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

דגל סוג ברירת מחדל תיאור
--categoryInput או --category-input בוליאני true מאפשרת כלים שקשורים לקלט.
--categoryNavigation או --category-navigation בוליאני true מפעילה כלים שקשורים לניווט.
--categoryEmulation או --category-emulation בוליאני true מפעילה כלים שקשורים לאמולציה.
--categoryNetwork או --category-network בוליאני true הפעלת כלים שקשורים לרשת.
--categoryPerformance או --category-performance בוליאני true מפעילה כלים שקשורים לביצועים.
--categoryDebugging או --category-debugging בוליאני true הפעלת כלים שקשורים לניפוי באגים.
--categoryMemory או --category-memory בוליאני true הפעלת כלים שקשורים לזיכרון.
--categoryExtensions או --category-extensions בוליאני false הגדרת הכלים שקשורים לתוספים. האפשרות הזו נתמכת רק בחיבור באמצעות צינור עיבוד נתונים.
--categoryPwa או --category-pwa בוליאני false ההגדרה הזו מפעילה כלים לאוטומציה של אפליקציות מסוג Progressive Web App (התקנה, הפעלה, הסרה ומצב מערכת ההפעלה). התמיכה קיימת רק בחיבור צינור.
--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 הגובה המקסימלי בפיקסלים. צילומי מסך גדולים יותר יוקטנו.

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

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

דגל סוג ברירת מחדל תיאור
--experimentalDevtools או --experimental-devtools בוליאני false הפעלת אוטומציה ביעדים של כלי הפיתוח.
--experimentalVision או --experimental-vision בוליאני false הפעלת כלים מבוססי-קואורדינטות (לדוגמה, click_at). בדרך כלל נדרש מודל לשימוש במחשב שיכול להפיק קואורדינטות מדויקות על ידי בחינת צילומי מסך.
--experimentalStructuredContent או --experimental-structured-content בוליאני false יצירת תוכן מובנה בפורמט מסוים.
--experimentalIncludeAllPages או --experimental-include-all-pages בוליאני false הוא כולל את כל סוגי הדפים (לדוגמה, תצוגות WebView ודפי רקע).
--experimentalScreencast או --experimental-screencast בוליאני false חשיפת כלי צילום מסך (נדרש ffmpeg ב-PATH).
--experimentalFfmpegPath או --experimental-ffmpeg-path מחרוזת false הנתיב לקובץ ההפעלה ffmpeg.
--experimentalScreencastFps או --experimental-screencast-fps number false FPS בהקלטת מסך. ערכים נמוכים יותר יכולים להפחית את העומס על הזיכרון בדפים שמפיקים פריימים מהר יותר ממה ש-ffmpeg יכול לקודד אותם.

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

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

דגל סוג ברירת מחדל תיאור
--slim בוליאני false הוא כולל סט מצומצם של שלושה כלים (ניווט, הפעלת סקריפט וצילומי מסך). שימושי למשימות בסיסיות בדפדפן.
--pageIdRouting או --page-id-routing בוליאני true צריך להגדיר את pageId בכלים ברמת הדף, והבקשות מנותבות לפי מזהה הדף. זה שימושי לסשנים בו-זמניים של נציגים. כדי להשבית, אפשר ללחוץ על: --no-page-id-routing.
--sourceMaps או --source-maps בוליאני true מפעיל מפות מקור בכלי הפיתוח. כדי להשבית, אפשר ללחוץ על: --no-source-maps.
--logFile או --log-file מחרוזת false הנתיב לקובץ שבו ייכתבו יומני ניפוי הבאגים. כדי להפעיל יומנים מפורטים, מגדירים את משתנה הסביבה NODE_DEBUG ל-*.
--config מחרוזת false נתיב לקובץ תצורה JSON.

משתני סביבה

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

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