Getting Started
Create and deploy your first MCP server in minutes
Prerequisites
Before starting, make sure you have:
- Node.js v22+ (download here)
- Git for version control
- Code editor (we recommend Cursor for AI-powered development)
- Basic TypeScript knowledge – The project is TypeScript-heavy, so familiarity with TS is important (if you’re new, see the official TypeScript docs for a primer).
Creating a new App
npm create deco@latest This may open your browser to authenticate. You can create a new account if you don’t have one.
You will be prompted to link this app to a deco CMS project that you’re part of.
cd <your-app-name>
npm install
npm run dev Your app’s local server will start with hot reload enabled. Copy the preview URL from the terminal output. The preview URL is accessible anywhere on the internet now.
The local server can be accessed on port 8787 and serves
both a MCP app at /mcp , and a React view front-end at / .
Test your MCP
Test your MCP server:
- Go to your team on the deco CMS
- Click Add Integration → Custom Integration
- Paste your preview URL +
/mcp(e.g.,https://localhost-abc123.deco.host/mcp) - Save and test the default tools that come from the template
Your MCP server is now running locally and connected to deco! 🎉
Deploy to production
When ready to share your MCP:
npm run deploy We deploy your app to Cloudflare Workers and becomes available on the private registry of your Team.
Found an error or want to improve this page?
Edit this page