•
GitHub Copilot Coding Agent Playwright MCP 外部主機存取設定教學
4 分鐘閱讀 •
為 Playwright MCP 開外網存取(含萬用字元)
- 到儲存庫設定頁新增 MCP 設定
在 GitHub 儲存庫的 Settings Copilot Coding agent 頁面,找到 MCP configuration 區塊,貼上這段 JSON,然後儲存: 1
{
"mcpServers": {
"playwright": {
"type": "local",
"command": "npx",
"args": ["@playwright/mcp@latest", "--allowed-hosts", "*"],
"tools": ["*"]
}
}
}
說明:
--allowed-hosts *會解除伺服器的主機檢查,允許從任意主機提供內容(你也可以改成逗號分隔的網域清單,例如cdn.jsdelivr.net,unpkg.com)。這個旗標是 Playwright MCP 內建的參數。 2- Copilot coding agent 只支援 MCP 的「工具」;上面用
tools: ["*"]全開,如果你想更安全,可改成只列你需要的工具名稱。 1
為什麼要自己加這段?因為預設的 Playwright MCP 只看得到
localhost / 127.0.0.1,要連外部主機就要自行加上如上設定。 3
- (選用)精準允許特定外站
如果你不想用萬用字元,而是只開特定 CDN,可以改成:
{
"mcpServers": {
"playwright": {
"type": "local",
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--allowed-hosts", "cdn.jsdelivr.net,unpkg.com,static.cloudflareinsights.com",
"--allowed-origins", "https://cdn.jsdelivr.net;https://unpkg.com;https://*.cloudflare.com"
],
"tools": ["*"]
}
}
}
--allowed-origins是以分號分隔的清單,用來限制瀏覽器實際可發出的請求來源;預設是全允許,你也可以明確列出。 2
- 驗證是否生效
建立一個 Issue 指派給 Copilot,等它開好 PR 之後,點進 View session 檢查「Start MCP Servers」步驟的日誌,應能看到你的 Playwright MCP 工具已啟動。 1
和防火牆、組織政策的關係(重要)
- Agent 防火牆不會管 MCP 伺服器。 Copilot 的代理防火牆只會限制透過 Bash 工具啟動的行程,不套用到 MCP 伺服器;所以要讓 Playwright MCP 出網,不需要改 agent 防火牆,重點是上面那段 MCP 設定。 4
- 組織有 MCP 允許清單政策時。 若你們的 Enterprise/Organization 啟用了 MCP registry 與「Registry only」政策,你也要確保
@playwright/mcp在允許名單中,否則 IDE/代理可能擋住執行。管理員可在 AI controls MCP(企業)或 Organization Settings Copilot Policies(組織)設定。 5
常見加強與除錯
- 內網或自簽憑證的 CDN 需要放寬 TLS 驗證時,可追加
--ignore-https-errors(僅測試用途,務必審慎)。 2 - Playwright MCP 的更多參數(例如
--host、--port、--blocked-origins等)都可用同樣方式放進args。 2
Extending GitHub Copilot coding agent with the Model Context Protocol (MCP) - GitHub Docs ↩ ↩2 ↩3
GitHub - microsoft/playwright-mcp: Playwright MCP server ↩ ↩2 ↩3 ↩4
Model Context Protocol (MCP) and GitHub Copilot coding agent - GitHub Docs ↩
Customizing or disabling the firewall for GitHub Copilot coding agent - GitHub Docs ↩
Configure MCP server access for your organization or enterprise - GitHub Docs ↩