How do I connect my Coolify instance?

You need your Coolify Instance URL and an API Token. You can find the token in your Coolify dashboard under Keys and Tokens.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

Can I deploy new code using this MCP?

Yes. You can trigger a deployment which fetches the latest Git commit and rebuilds the Nixpacks image.

Does this work with PostgreSQL and Redis?

Yes. The MCP can list and retrieve configuration details for PostgreSQL, MySQL, and Redis instances.

Vinkius hosts the MCP and manages the credentials, allowing you to connect your instance once and use it securely across your AI clients.

Can my agent trigger a new deployment for a Coolify application?

Yes. Use the 'trigger_deployment' capability with the application UUID. The agent will initiate a full build pipeline, fetching the latest commit and rolling out the updated version directly on your server.

How do I retrieve the internal connection string for a managed database?

Provide the database UUID to the 'get_database' capability. Your agent will extrapolate the internal network URI (e.g., for PostgreSQL or MySQL), allowing you to securely link your apps without external port exposure.

Can I restart an application to apply new environment variables?

Absolutely. Use the 'restart_application' capability. The agent will execute an overlapping bounce, destroying old instances and initializing fresh replicas with the latest configuration and environment variables.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Coolify to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage your private cloud through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Coolify.

01
Get database
Retrieves internal configuration arrays for a specific database. Use this to grab connection strings needed to link web apps to backend datastores.
02
Get server
Fetches the configuration schema for a specific Coolify node. It provides IP properties, SSH connection status, and Docker port details.
03
List applications
Lists all frontend and backend applications managed by Coolify. It provides the UUIDs required to perform actions like stopping or restarting apps.
04
List databases
Shows all managed PostgreSQL, MySQL, and Redis instances. This helps you find connection strings and check backup schedules.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Coolify.

05
Get application
Provides detailed topology metrics for a single application. You can see mapped GitHub branches, rollout toggles, and Traefik proxy paths.
06
List servers
Identifies all self-hosted nodes in your instance. Use this to see which physical endpoints are running your Docker swarms.
07
Restart application
Bounces a specific application to recycle its container state. This is useful for applying new environment variables immediately.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Coolify.

08
Start application
Starts a suspended application by its UUID to bring containers back online.
09
Trigger deployment
Starts a raw build pipeline. It fetches the latest Git commit, rebuilds Nixpacks images, and rolls out the new Docker version.
10
Stop application
Halts an application's execution. Use this to pause billing or restrict web access during a security incident.

Real work

What teams actually run

Rapid Debugging

Restart a container immediately after a failed deployment to clear its state.

Environment Linking

Get the exact connection string for a database to link it to a new web app.

Security Response

Stop an application instantly to restrict web access during an incident.

Deployment Automation

Tell your agent to pull the latest Git commit and roll out a new Docker image.

Automate a task

Put Coolify to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Coolify works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Coolify to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

918ms average. Fast in production.

Coolify is checked daily against the live service.

Daily averagePeak 1108ms

Oct 3Today

Fastest day: 763ms
Slowest day: 1108ms
14-day trend: Improving-8%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Coolify, so you can see the experience inside your AI.

It does not authenticate your account with Coolify. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Coolify Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_2OtVSYxP6F0y5CH4pZP2Y6H6N3UqbNzYtv86n8vS/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Coolify capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "coolify-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_2OtVSYxP6F0y5CH4pZP2Y6H6N3UqbNzYtv86n8vS/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Coolify in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Coolify owners hand off.

This MCP is built for technical users who manage their own infrastructure and want to move faster.

01
DevOps Engineers
Monitor node health and manage application lifecycles across environments.
02
Full-stack Developers
Trigger builds and grab database strings without leaving the IDE.
03
Indie Hackers
Deploy new versions of apps to a private cloud via chat.
04
SysAdmins
Audit Docker Swarm configs and verify server connectivity.

FAQ

Questions Coolify owners ask.

01
How do I connect my Coolify instance?
You need your Coolify Instance URL and an API Token. You can find the token in your Coolify dashboard under Keys and Tokens.
02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.
03
Can I deploy new code using this MCP?
Yes. You can trigger a deployment which fetches the latest Git commit and rebuilds the Nixpacks image.
04
Does this work with PostgreSQL and Redis?
Yes. The MCP can list and retrieve configuration details for PostgreSQL, MySQL, and Redis instances.
05
Is my data secure?
Vinkius hosts the MCP and manages the credentials, allowing you to connect your instance once and use it securely across your AI clients.
06
Can my agent trigger a new deployment for a Coolify application?
Yes. Use the 'trigger_deployment' capability with the application UUID. The agent will initiate a full build pipeline, fetching the latest commit and rolling out the updated version directly on your server.
07
How do I retrieve the internal connection string for a managed database?
Provide the database UUID to the 'get_database' capability. Your agent will extrapolate the internal network URI (e.g., for PostgreSQL or MySQL), allowing you to securely link your apps without external port exposure.
08
Can I restart an application to apply new environment variables?
Absolutely. Use the 'restart_application' capability. The agent will execute an overlapping bounce, destroying old instances and initializing fresh replicas with the latest configuration and environment variables.

Explore

More in Loved By Devs

Connect Coolify to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get database

Get server

List applications

List databases

05-07

Get application

List servers

Restart application

08-10

Start application

Trigger deployment

Stop application

What teams actually run

Rapid Debugging

Environment Linking

Security Response

Deployment Automation

Building your own app? The connector is yours to use.

Coolify Connector

Claude Desktop

DevOps Engineers

Full-stack Developers

Indie Hackers

SysAdmins

How do I connect my Coolify instance?

Which AI clients can I use with this MCP?

Can I deploy new code using this MCP?

Does this work with PostgreSQL and Redis?

Is my data secure?

Can my agent trigger a new deployment for a Coolify application?

How do I retrieve the internal connection string for a managed database?

Can I restart an application to apply new environment variables?

Cockpit (Self-hosted Headless CMS API) AI Connector

Flightcontrol (AWS PaaS Deployments) AI Connector

Porter PaaS AI Connector

Codefresh AI Connector

Suggestions

Dokku AI Connector

Cloudflare AI Connector

Render AI Connector

Coder (Remote Dev) AI Connector