Files
playwriter/extension/welcome.html
2025-12-18 15:43:53 +01:00

335 lines
9.2 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Welcome to Playwriter MCP</title>
<style>
:root {
--color-bg: #ffffff;
--color-text: #262626;
--color-heading: #171717;
--color-border: #d4d4d4;
--color-code-bg: #f5f5f5;
--color-link: #0969da;
--color-link-hover: #0550ae;
--color-success: #16a34a;
--color-muted: #737373;
--max-width: 640px;
--spacing: 1.5rem;
}
@media (prefers-color-scheme: dark) {
:root {
--color-bg: #0a0a0a;
--color-text: #e5e5e5;
--color-heading: #fafafa;
--color-border: #404040;
--color-code-bg: #171717;
--color-link: #4493f8;
--color-link-hover: #539bf5;
--color-success: #22c55e;
--color-muted: #a3a3a3;
}
}
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans",
Helvetica, Arial, sans-serif;
font-size: 16px;
line-height: 1.6;
color: var(--color-text);
background-color: var(--color-bg);
padding: 2rem 1rem;
}
main {
max-width: var(--max-width);
margin: 0 auto;
}
h2 {
font-size: 1.75rem;
font-weight: 600;
color: var(--color-heading);
margin-top: 2rem;
margin-bottom: 1rem;
padding-bottom: 0.5rem;
border-bottom: 1px solid var(--color-border);
}
h3 {
font-size: 1.25rem;
font-weight: 600;
color: var(--color-heading);
margin-top: 1.5rem;
margin-bottom: 0.75rem;
}
p {
margin-bottom: 1rem;
}
a {
color: var(--color-link);
text-decoration: none;
}
a:hover {
color: var(--color-link-hover);
text-decoration: underline;
}
code {
font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas,
"Liberation Mono", monospace;
font-size: 0.875em;
background-color: var(--color-code-bg);
padding: 0.2em 0.4em;
border-radius: 6px;
}
pre {
background-color: var(--color-code-bg);
padding: 1rem;
border-radius: 6px;
overflow-x: auto;
margin-bottom: 1rem;
border: 1px solid var(--color-border);
}
pre code {
background-color: transparent;
padding: 0;
font-size: 0.875rem;
}
ol,
ul {
margin-bottom: 1rem;
padding-left: 2rem;
}
li {
margin-bottom: 0.5rem;
}
strong {
font-weight: 600;
color: var(--color-heading);
}
.step-number {
color: var(--color-link);
font-weight: 700;
font-size: 1.125rem;
margin-right: 0.75rem;
flex-shrink: 0;
line-height: 1.6;
}
.step {
display: flex;
align-items: flex-start;
margin-bottom: 1.5rem;
}
.step-content {
flex: 1;
}
.install-button {
display: inline-flex;
align-items: center;
gap: 0.5rem;
padding: 0.5rem 1rem;
background-color: #262626;
color: #fff;
border-radius: 0.5rem;
text-decoration: none;
transition: background-color 0.15s;
font-size: 0.875rem;
font-weight: 500;
margin-top: 0.5rem;
}
.install-button:hover {
background-color: #404040;
color: #fff;
text-decoration: none;
}
.install-button svg {
width: 1.25rem;
height: 1.25rem;
}
footer {
margin-top: 3rem;
padding-top: 2rem;
border-top: 1px solid var(--color-border);
text-align: center;
color: var(--color-muted);
font-size: 0.875rem;
}
</style>
</head>
<body>
<main>
<section>
<h2>Getting Started with Playwriter MCP</h2>
<p>
Control your browser via extension instead of spawning a full new
Chrome window. Uses less context window by running Playwright CDP
protocol directly. Collaborate with your agent and help get it
unstuck when needed.
</p>
<h3>Quick Start</h3>
<div class="step">
<span class="step-number">1</span>
<div class="step-content">
<strong>Pin this extension on Chrome toolbar</strong>
<p>
Click the puzzle icon in your Chrome toolbar and pin the
Playwriter MCP extension for easy access.
</p>
</div>
</div>
<div class="step">
<span class="step-number">2</span>
<div class="step-content">
<strong>Click the extension icon</strong>
<p>
Click the Playwriter MCP extension icon in your browser toolbar
to attach the debugger to the current tab. The icon will turn
green when successfully connected.
</p>
</div>
</div>
<div class="step">
<span class="step-number">3</span>
<div class="step-content">
<strong>Add the MCP to your agent</strong>
<p>
Add the following configuration to your MCP client settings (e.g.,
Claude Desktop's <code>claude_desktop_config.json</code>):
</p>
<pre><code>{
"mcpServers": {
"playwriter": {
"command": "npx",
"args": [
"playwriter"
]
}
}
}</code></pre>
<p>
Or install directly in Cursor:
</p>
<a
href="https://cursor.com/en/install-mcp?name=playwriter&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJwbGF5d3JpdGVyQGxhdGVzdCJdfQ%3D%3D"
target="_blank"
rel="noopener noreferrer"
class="install-button"
>
<svg viewBox="0 0 466.73 533.32" xmlns="http://www.w3.org/2000/svg">
<path d="m233.37 266.66 231.16 133.46c-1.42 2.46-3.48 4.56-6.03 6.03l-216.06 124.74c-5.61 3.24-12.53 3.24-18.14 0l-216.06-124.74c-2.55-1.47-4.61-3.57-6.03-6.03z" fill="#72716d"/>
<path d="m233.37 0v266.66l-231.16 133.46c-1.42-2.46-2.21-5.3-2.21-8.24v-250.44c0-5.89 3.14-11.32 8.24-14.27l216.05-124.74c2.81-1.62 5.94-2.43 9.07-2.43z" fill="#55544f"/>
<path d="m464.52 133.2c-1.42-2.46-3.48-4.56-6.03-6.03l-216.06-124.74c-2.8-1.62-5.93-2.43-9.06-2.43v266.66l231.16 133.46c1.42-2.46 2.21-5.3 2.21-8.24v-250.44c0-2.95-.78-5.77-2.21-8.24z" fill="#43413c"/>
<path d="m448.35 142.54c1.31 2.26 1.49 5.16 0 7.74l-209.83 363.42c-1.41 2.46-5.16 1.45-5.16-1.38v-239.48c0-1.91-.51-3.75-1.44-5.36l216.42-124.95h.01z" fill="#d6d5d2"/>
<path d="m448.35 142.54-216.42 124.95c-.92-1.6-2.26-2.96-3.92-3.92l-207.39-119.74c-2.46-1.41-1.45-5.16 1.38-5.16h419.65c2.98 0 5.4 1.61 6.7 3.87z" fill="#fff"/>
</svg>
Install in Cursor
</a>
<p style="margin-top: 1rem;">
This will enable your AI assistant to control the browser through
the extension.
</p>
</div>
</div>
</section>
<section>
<h2>How It Works</h2>
<ul>
<li>
<strong>No new Chrome instances:</strong> Works with your current
browser session
</li>
<li>
<strong>No CDP mode required:</strong> No need to restart Chrome
with special flags
</li>
<li>
<strong>Full CDP access:</strong> Complete Chrome DevTools Protocol
capabilities
</li>
<li>
<strong>Visual feedback:</strong> Extension icon changes color to
indicate connection status
</li>
</ul>
</section>
<section>
<h2>Icon States</h2>
<ul>
<li><strong>Gray:</strong> Not connected to any tab</li>
<li><strong>Green:</strong> Successfully connected and ready</li>
<li><strong>Orange badge (...):</strong> Connecting to relay server</li>
<li><strong>Red badge (!):</strong> Error occurred</li>
</ul>
</section>
<section>
<h2>Privacy &amp; Security</h2>
<p>
Playwriter MCP runs locally in your browser and does not send any
data to external servers. All browser control happens through the
standard Chrome DevTools Protocol on your machine.
</p>
</section>
<section>
<h2>Need Help?</h2>
<p>
For issues, feature requests, or contributions, visit the
<a
href="https://github.com/remorses/playwriter"
target="_blank"
rel="noopener noreferrer"
>
GitHub repository
</a>
.
</p>
</section>
<footer>
<p>
Playwriter MCP &copy; Microsoft Corporation &middot; Licensed under
Apache-2.0
</p>
</footer>
</main>
</body>
</html>