Integrations
MCP
Connect Cursor to Devployer so you can list projects and deploy from chat.
This page covers connection only. To deploy, follow Deploy with MCP.
What you need
- A Devployer account
- Cursor (or another MCP Streamable HTTP client)
- Access to Settings → API Tokens
Step 1 — Generate a token
- Sign in to Devployer
- Open Settings → API Tokens
- Enter a name (e.g.
Cursor MCP) and click Generate token - Copy the full token (
dply_...) right away — it is shown only once
Treat it like a password. If it leaks, revoke it on the same screen.
Step 2 — Configure Cursor
Create or edit one of these files:
- Global:
~/.cursor/mcp.json - This project only:
.cursor/mcp.json
Paste:
{
"mcpServers": {
"devployer": {
"url": "https://api-devployer-panel.app.devployer.com/mcp",
"headers": {
"Authorization": "Bearer dply_YOUR_TOKEN_HERE"
},
"documentation": "https://devployer.com/docs/mcp-deploy",
"homepage": "https://devployer.com/docs/mcp"
}
}
}
Replace dply_YOUR_TOKEN_HERE with your token.
Tip: you can use an environment variable:
"Authorization": "Bearer ${env:DEPLOAI_MCP_TOKEN}"
Step 3 — Verify the connection
- Save
mcp.json - In Cursor: Customize → MCP (or restart Cursor)
- The
devployerserver should show green - Try in chat: “List my Devployer projects”
If it returns your projects, the integration is ready.
Next step
- Create and pay for the app in the Devployer portal (MCP does not create apps or take payments)
- Deploy from chat → Deploy with MCP
Tools you will see (summary)
| Tool | What it does |
|---|---|
list_projects | List projects and environments |
list_resources | List apps in an environment |
list_deploy_methods | Dockerfile templates per stack |
deploy_resource | Deploy (Dockerfile only) + logs |
get_deployment_logs | Re-read logs after timeout or failure |
redeploy_resource | Redeploy app by name (asks for confirmation) |
restart_resource | Restart app by name (asks for confirmation) |
stop_resource | Stop app by name (asks for confirmation) |
AI IDEs: follow the full playbooks, confirmation rules, and argument schemas in Deploy with MCP (section For AI agents). That page is the canonical source when documentation in mcp.json points here.
Security
- Use only your
dply_...token - Do not commit it to a public repo
- Revoke unused tokens under Settings → API Tokens
If something fails
| Problem | What to do |
|---|---|
| Red server / 401 | Invalid or revoked token → generate a new one (Step 1) |
| Tools missing | URL must end with /mcp; MCP enabled in Cursor |
| Empty project list | Create a project in the Devployer portal first |