Skip to content
Vinkius

Portainer Connector for AI agents.

6 live capabilities

Manage Docker containers and Kubernetes environments through a unified chat interface.

Live agent request Portainer / Connector

Waiting for input…

AI Agent

Why people use Portainer

Portainer for Faster Docker Container Management

This Connector changes that by letting you ask your agent for a status update. You get a plain text list of what's running and what's down in seconds, keeping your focus on solving the problem.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a direct chat interface for your entire Docker and Kubernetes infrastructure.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Checking cluster health

    An engineer asks the agent to show all running containers on a dev cluster.

  2. Real-world use case 02

    Rapid staging deployment

    A developer needs a new redis instance on a specific port.

  3. Real-world use case 03

    Multi-cluster management

    A sysadmin wants to add a new production endpoint.

Complete set · 6capabilities

The complete Portainer capability set.

These are the exact actions your AI can choose when you ask it to work with Portainer.

Capability set01 / 02

01—03

3 capabilities in this set.

Part of 6 available through Portainer.

  1. 01 Capability

    Init admin

    Set the initial admin password for a fresh Portainer installation. It speeds up the initial setup process.

  2. 02 Capability

    List docker containers

    See all containers currently running in a specific environment. Use this to get a quick status overview.

  3. 03 Capability

    Add endpoint

    Add a new Docker or Kubernetes environment to your Portainer setup. This helps you manage multiple clusters in one place.

Capability set02 / 02

04—06

3 capabilities in this set.

Part of 6 available through Portainer.

  1. 04 Capability

    Authenticate

    Get a secure JWT token to authorize your agent's actions. This keeps your connection private and valid.

  2. 05 Capability

    Create docker container

    Deploy a new container from a specific image with custom settings. You can define ports and host configurations easily.

  3. 06 Capability

    Start docker container

    Turn on a container that is currently stopped. This is useful for restarting services after maintenance.

Set up in minutes

One URL. Then ask Portainer to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Portainer from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_vAtyUqdwLcdumic07vZOqC4647ETb6UK429Uaxij/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it Portainer, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable Portainer for the conversation.

Where the request belongs

Work Portainer can move forward.

Built around the request

DevOps engineers who need to manage production clusters without the friction of constant tab-switching, and developers who want to spin up test environments on demand.

01

DevOps Engineer

Checks container health and restarts services during incidents without leaving the terminal or chat.

02

Software Developer

Deploys new test images and manages local Docker environments while staying inside the code editor.

03

System Administrator

Manages multiple remote endpoints and handles admin account initialization across various clusters.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
Rancher logo
01 10 capabilities

Rancher

Equip your AI to manage Kubernetes environments directly through Rancher, overseeing clusters, namespaces, and active pods.

View Connector
Dokku logo
02 10 capabilities

Dokku

Manage self-hosted apps via Dokku. monitor containers, scale processes, handle environment variables, and stream logs directly from any AI agent.

View Connector
Qovery logo
03 10 capabilities

Qovery

Bring effortless Kubernetes and cloud deployment management to your IDE. List environments, check application states, restart pods, and deploy exact Git commits via chat.

View Connector
Porter PaaS logo
04 10 capabilities

Porter PaaS

Orchestrate Kubernetes clusters via Porter. manage apps, projects, container tags, and enforce rollouts directly with your AI.

View Connector
Argo CD (GitOps) logo
05 13 capabilities

Argo CD (GitOps)

Manage Kubernetes deployments via Argo CD. sync applications, check logs, and manage clusters/repositories directly from your AI agent.

View Connector
Argo Workflows logo
06 6 capabilities

Argo Workflows

Automate Kubernetes orchestrations via Argo Workflows. monitor, list, and inspect active pods, crons, and workflow templates directly from any AI agent.

View Connector

Bring your own AI

Change the model, client or framework. Keep Portainer connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about Portainer.

The practical details behind the request, access and result.

Does Portainer MCP work with my existing Docker setup?

Yes, it connects to your current Portainer instance. You just need to provide your URL and API key to give your agent the necessary permissions.

Can I manage multiple remote servers with Portainer MCP?

Yes, you can use the add_endpoint capability to bring new remote Docker or Kubernetes environments into your management workflow.

Is it safe to use Portainer MCP for production?

Yes, it uses the authenticate capability to handle secure JWT tokens. This ensures that your agent's actions are authorized and encrypted.

Can I deploy new images using Portainer MCP?

Yes, you can tell your agent to deploy a new image using the create_docker_container capability, specifying your desired ports and host settings.

How do I set up the first admin for Portainer MCP?

You can use the init_admin capability to set the initial admin password for a fresh Portainer installation directly through your agent.

What happens if a container stops?

Your agent can check the status via list_docker_containers and you can tell it to restart the service using the start_docker_container capability.

How do I see all containers running in a specific environment?

Use the list_docker_containers capability by providing the specific endpoint_id. The agent will return a list of all containers managed within that Portainer environment.

Can I add a new remote Docker endpoint through the AI?

Yes! Use the add_endpoint action. You can specify the name, set the type to 2 (Remote), and provide the URL (e.g., tcp://10.0.0.1:2375) to connect a new environment.

Is it possible to deploy a container with specific port mappings?

Yes. When using create_docker_container, you can provide a config_json string containing standard Docker API parameters like ExposedPorts or HostConfig to define your network and port requirements.

One connection away

Give your agent a direct line to Portainer.

Connect Portainer once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available