Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Portainer with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage Docker containers and environments via Portainer. list, create, and start containers directly from your AI agent.

Included with plan

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.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 6 capabilities

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

    List docker containers

    List Docker containers in an environment

  2. 02

    Start docker container

    Start a Docker container

  3. 03

    Add endpoint

    Add a new environment (endpoint) to Portainer

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through Portainer.

  1. 04

    Authenticate

    Authenticate to receive a JWT token

  2. 05

    Create docker container

    Create a new Docker container

  3. 06

    Init admin

    Initialize Portainer admin password

Observed, not estimated

857ms average. Fast in production.

Portainer is checked daily against the live service.

Daily averagePeak 1053ms
Aug 20Today
Fastest day
725ms
Slowest day
1053ms
14-day trend
Slowing+19%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 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 Portainer, so you can see the experience inside your AI.

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

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"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

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

FAQ

Questions Portainer owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Ship It

Suggestions