How to add EdgeOne Pages MCP to Windsurf
Deploy HTML, folders, or full-stack projects to Tencent EdgeOne Pages and get a public URL. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.
Last updated June 14, 2026 · 420★ · stdio · no auth · official
Windsurf config for EdgeOne Pages MCP
npx edgeone-pages-mcp-fullstack@latest{
"mcpServers": {
"edgeone-pages-mcp": {
"command": "npx",
"args": [
"edgeone-pages-mcp-fullstack@latest"
]
}
}
}Setup steps
- 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
- 2Paste the EdgeOne Pages MCP config below.
- 3Fill in placeholder secrets, then save.
- 4Click Refresh in the MCP panel.
- 5EdgeOne Pages MCP's tools become available to Cascade.
Before you start
- Node.js 18 or higher
- Optional: an EdgeOne Pages API token (legacy package only) for deploying folders or zip files to EdgeOne Pages projects
What EdgeOne Pages MCP can do in Windsurf
deploy_htmlDeploys static HTML content to EdgeOne Pages Functions, stores it in the EdgeOne Pages KV Store for fast edge access, and returns an immediately accessible public URL. Available in the fullstack stdio, legacy stdio, and Streaming HTTP servers.
deploy_folderDeploys complete projects to EdgeOne Pages, including static website projects and full-stack applications, with the option to create a new project or update an existing one. Available in the recommended fullstack stdio server.
deploy_folder_or_zipDeploys folders or zip files to EdgeOne Pages. Available in the legacy edgeone-pages-mcp server (to be deprecated); requires an EdgeOne Pages API token.
Security
The recommended fullstack stdio server requires no authentication. The legacy edgeone-pages-mcp package accepts an optional EDGEONE_PAGES_API_TOKEN (and EDGEONE_PAGES_PROJECT_NAME) env var, needed only for deploying folders or zip files to EdgeOne Pages projects; treat the API token as a secret. Note that the deploy_html tool publishes content to a publicly accessible URL.
EdgeOne Pages MCP + Windsurf FAQ
Where is the Windsurf config file?
Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the EdgeOne Pages MCP config there under the "mcpServers" key and restart the client.
Is EdgeOne Pages MCP safe to use with Windsurf?
The recommended fullstack stdio server requires no authentication. The legacy edgeone-pages-mcp package accepts an optional EDGEONE_PAGES_API_TOKEN (and EDGEONE_PAGES_PROJECT_NAME) env var, needed only for deploying folders or zip files to EdgeOne Pages projects; treat the API token as a secret. Note that the deploy_html tool publishes content to a publicly accessible URL.
Which configuration should I use?
Use the recommended fullstack stdio server (edgeone-pages-mcp-fullstack) for full features including the deploy_folder tool. The legacy edgeone-pages-mcp package (supporting deploy_html and deploy_folder_or_zip) is to be deprecated soon. The Streaming HTTP server only supports deploy_html.
Do I need an API token?
No token is required for the recommended fullstack stdio server. The legacy edgeone-pages-mcp package needs an optional EDGEONE_PAGES_API_TOKEN only when deploying folders or zip files to EdgeOne Pages projects.
How do I deploy to the Tencent Cloud China region?
Add "--region", "china" to the args of the fullstack server, e.g. ["edgeone-pages-mcp-fullstack@latest", "--region", "china"]. The default is Tencent Cloud International.