@vertracloud/mcp

Official MCP server for Vertra Cloud: gives your AI assistant (Claude, Cursor, VS Code, n8n) the tools to deploy applications, read logs, create databases and restore snapshots — on your own account, with your own API key.

Quick start · Connect from claude.ai · Tools · Prompt ideas · Common issues

Quick start

Prerequisite: Node 18 or newer.

1. In the dashboard, go to Settings → API keys, create a key and check the scopes the assistant will need (start with the read-only ones).
2. Copy the key — it’s shown only once.
3. Configure your client:

Claude Code

claude mcp add vertracloud -e VERTRA_API_KEY=your_key -- npx -y @vertracloud/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vertracloud": {
      "command": "npx",
      "args": ["-y", "@vertracloud/mcp"],
      "env": { "VERTRA_API_KEY": "your_key" }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "vertracloud": {
      "command": "npx",
      "args": ["-y", "@vertracloud/mcp"],
      "env": { "VERTRA_API_KEY": "your_key" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "vertracloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vertracloud/mcp"],
      "env": { "VERTRA_API_KEY": "your_key" }
    }
  }
}

Restart the client and ask something like “list my apps on Vertra”.

Connect from claude.ai

In the browser there’s nothing to install:

1. Open Settings → Connectors → Add custom connector.
2. Enter the URL https://mcp.vertracloud.app/mcp.
3. Click Connect and sign in to your Vertra account.
4. Check the scopes you want to grant and confirm.

Tools marked “local only” in the table below don’t show up here: they read and write files on your computer, which only makes sense in Claude Desktop, Claude Code or Cursor.

Tools

Folders and favorites are preferences persisted on the server: tools with personal change the account’s own organization, and tools with workspace change only the user’s organization within that workspace. They organize applications and databases, with no relation to Flow’s groups, layout or local storage.

Documentation

Applications