• DEPLOY
  • MONITOR
  • CONTROL
  • HUMAN

How to deploy and manage docker containers with your AI

Connect Portainer to your AI client to turn chat commands into container actions. You'll manage your Docker environment without touching a terminal.

Ask AI about this page

Short answer

How can I use my AI to run Docker containers?

Your AI client uses Portainer to execute commands like creating, starting, and listing containers. You get a direct line from your chat interface to your Docker engine. This setup lets you handle container lifecycles through natural language.

Container outcomes

Where your container actions land.

The AI translates your requests into specific Portainer operations.

DEPLOY

New containers live

The AI builds and launches containers based on your specs. You get a running service without writing YAML.

MONITOR

Real-time status

Your agent pulls the current state of your environment. You'll see exactly what is running and what isn't.

CONTROL

Lifecycle management

Start or stop specific containers through chat. The AI handles the execution while you watch the results.

HUMAN

Manual oversight

You stay in control of the high-level logic. The AI handles the Docker commands, but you decide which images to pull.

The workflow

What your AI does when a request arrives.

The AI acts as a bridge between your intent and the Portainer API.

  1. Inventory check

    The AI checks what is already running to avoid conflicts or duplicates.

    list_docker_containers

  2. Provisioning

    The AI builds the container environment based on the image and configuration you provide.

    create_docker_container

  3. Activation

    Once the container is created, the AI triggers the startup process to get the service online.

    start_docker_container

  4. Verification

    The AI confirms the container is active and running as expected by checking the current state.

    list_docker_containers

Try it

Copy these to start.

Use these prompts to kick off your first container tasks.

Starting points

These are opening lines. Swap out the container names or image names for your specific needs.

Portainer Connector

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

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

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Portainer capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "portainer-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vAtyUqdwLcdumic07vZOqC4647ETb6UK429Uaxij/mcp"
    }
  }
}
Copy into chat04

  • List all my currently running Docker containers.

  • Create a new container using the nginx:latest image.

  • Start the container named 'web-server-01'.

  • Show me a list of all containers so I can see what's active.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Portainer once, then ask.

Just link your Portainer instance to Vinkius. Your credentials stay encrypted, and you can start managing containers immediately.

Connect Portainer to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete my containers?

    No. The current tools only allow for creating, starting, and listing containers. Deletion must be done manually.

  • 02

    Can the AI change my existing container configurations?

    No. The AI can create new containers or start existing ones, but it cannot modify the settings of a container that is already created.

  • 03

    Do I need to use the command line?

    No. Once connected, you can perform all these actions through your AI client's chat interface.

  • 04

    Can the AI pull images from a private registry?

    The AI can create containers using images, but it relies on the underlying Portainer/Docker configuration to access private registries.

  • 05

    Will the AI stop my containers automatically?

    No. The AI only starts or lists containers. It does not have a tool to stop or remove them.

  • More questions about Portainer? The Connector page answers them. See everything the Portainer Connector can do

Connect Portainer to Claude, Cursor, ChatGPT & more