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

Step 1 — Generate a token

  1. Sign in to Devployer
  2. Open Settings → API Tokens
  3. Enter a name (e.g. Cursor MCP) and click Generate token
  4. 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

  1. Save mcp.json
  2. In Cursor: Customize → MCP (or restart Cursor)
  3. The devployer server should show green
  4. Try in chat: “List my Devployer projects”

If it returns your projects, the integration is ready.

Next step

  1. Create and pay for the app in the Devployer portal (MCP does not create apps or take payments)
  2. Deploy from chat → Deploy with MCP

Tools you will see (summary)

ToolWhat it does
list_projectsList projects and environments
list_resourcesList apps in an environment
list_deploy_methodsDockerfile templates per stack
deploy_resourceDeploy (Dockerfile only) + logs
get_deployment_logsRe-read logs after timeout or failure
redeploy_resourceRedeploy app by name (asks for confirmation)
restart_resourceRestart app by name (asks for confirmation)
stop_resourceStop 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

ProblemWhat to do
Red server / 401Invalid or revoked token → generate a new one (Step 1)
Tools missingURL must end with /mcp; MCP enabled in Cursor
Empty project listCreate a project in the Devployer portal first