Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Playwright MCP on Render Open news.ycombinator.com and get the top 3 story titles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
把微软官方 @playwright/mcp 部署到 Render，得到一个公网可访问的 MCP URL，用于 Cursor / Cline / Claude / VS Code 等客户端的 streamable_http / http / sse 方式连接。
当前版本组合：
Docker 基础镜像：
mcr.microsoft.com/playwright:v1.62.1-nobleMCP 包：
@playwright/mcp@0.0.79Node.js：基础镜像内置
playwright-mcp-render/
├── Dockerfile
├── package.json
├── auth-proxy.js
├── render.yaml
├── .dockerignore
└── README.mdRelated MCP server: Playwright MCP
新建一个 GitHub 仓库，例如 playwright-mcp-render。
把本项目所有文件 push 到仓库根目录。
打开 Render：New + → Blueprint。
选择这个 GitHub 仓库。
Render 会读取 render.yaml 并创建 Web Service。
等待部署完成，得到类似：
https://playwright-mcp-render-xxxx.onrender.comRender → New + → Web Service。
选择 GitHub 仓库。
Runtime 选 Docker。
Dockerfile path 填：./Dockerfile。
Health Check Path 填：/healthz。
Environment 里添加：
Key | Value | 说明 |
| 生成一个强密码 | 开启公网鉴权，强烈建议 |
|
| 内部 MCP 服务端口 |
|
| 可选，传给 playwright-mcp 的额外参数 |
Deploy。
部署后你的根地址假设是：
https://playwright-mcp-render-xxxx.onrender.com优先尝试 Streamable HTTP 端点：
https://playwright-mcp-render-xxxx.onrender.com/mcp如果客户端连接失败，再试旧 SSE 端点：
https://playwright-mcp-render-xxxx.onrender.com/sse不同 MCP 客户端对
streamable_http、http、sse命名不完全一致。Playwright MCP 新版本通常支持/mcp，老式客户端可能要/sse。
本项目默认通过 MCP_TOKEN 开启鉴权。推荐客户端请求头：
Authorization: Bearer 你的_MCP_TOKEN如果你的 MCP 客户端不支持自定义请求头，可以临时用 query token：
https://playwright-mcp-render-xxxx.onrender.com/mcp?token=你的_MCP_TOKEN或：
https://playwright-mcp-render-xxxx.onrender.com/sse?token=你的_MCP_TOKEN注意：query token 可能出现在日志、浏览器历史、分享链接里，安全性不如 Authorization header。
如果支持请求头：
{
"mcpServers": {
"playwright-render": {
"type": "streamableHttp",
"url": "https://playwright-mcp-render-xxxx.onrender.com/mcp",
"headers": {
"Authorization": "Bearer 你的_MCP_TOKEN"
}
}
}
}如果不支持 headers：
{
"mcpServers": {
"playwright-render": {
"type": "streamableHttp",
"url": "https://playwright-mcp-render-xxxx.onrender.com/mcp?token=你的_MCP_TOKEN"
}
}
}{
"mcpServers": {
"playwright-render": {
"type": "streamableHttp",
"url": "https://playwright-mcp-render-xxxx.onrender.com/mcp?token=你的_MCP_TOKEN"
}
}
}一般填 URL 型 MCP：
https://playwright-mcp-render-xxxx.onrender.com/mcp?token=你的_MCP_TOKEN如果报 transport 不兼容，把路径换成：
https://playwright-mcp-render-xxxx.onrender.com/sse?token=你的_MCP_TOKENdocker build -t playwright-mcp-render .
docker run --rm -p 8931:8931 -e MCP_TOKEN=dev-token playwright-mcp-render健康检查：
curl http://localhost:8931/healthz测试 MCP 端点是否有响应：
curl -i http://localhost:8931/mcp -H "Authorization: Bearer dev-token"
curl -i http://localhost:8931/sse -H "Authorization: Bearer dev-token"看到非 401 响应，就说明鉴权和代理通了。MCP 正常握手通常要由 MCP 客户端发 JSON-RPC 请求完成。
变量 | 默认值 | 说明 |
|
| Render 注入的公网监听端口 |
| 空 | 设置后启用鉴权代理 |
|
| 鉴权代理后面的内部 MCP 端口 |
| 空 | 额外传给 |
例如：
MCP_EXTRA_ARGS=--isolated --browser=chromium可用参数例子：
参数 | 作用 |
| 无头浏览器，Render 必须用 |
| 每次会话隔离，不复用登录态 |
| 指定 Chromium |
| 开启网络相关工具（如版本支持） |
不要裸奔公网。一定设置 MCP_TOKEN。
不要让陌生人拿到你的 MCP URL。别人可以消耗你的 Render 资源并操控云端浏览器。
Playwright 官方 Docker 镜像主要用于测试/开发，不建议访问不可信网页。
Render 免费层容易休眠，首次连接可能要等 30 秒以上；浏览器自动化建议用 1GB+ 内存实例。
问题 | 处理 |
连接 401 | token 不对，检查 |
连接 404 |
|
502 Bad gateway | Playwright MCP 还没启动完，等几秒重试；看 Render logs |
浏览器启动失败 | 确认使用 Docker 镜像 |
OOM / 崩溃 | 升级 Render 实例内存，浏览器自动化不适合太小内存 |
如果不设置 MCP_TOKEN，Dockerfile 会直接运行：
./node_modules/.bin/playwright-mcp --port $PORT --host 0.0.0.0 --headless公网 URL 不需要 token，但非常不安全，只建议临时测试。
This server cannot be deployed
Deploy AI-generated HTML/CSS/JS to instant public HTTPS URLs from any MCP-compatible agent.
MCP server for Mint — AI-powered QA that runs your app in a real browser on every PR.
Screenshot, PDF and HTML-to-image rendering API so Claude and Cursor can see any web page.
Screenshot, PDF and HTML-to-image rendering API so Claude and Cursor can see any web page.
