• READY
  • SECURE
  • SYNCED
  • HUMAN

How to add and manage remote endpoints with your AI

Connect new Docker or Kubernetes environments to your Portainer instance using your AI. Once linked, your agent handles the setup and authentication for you.

Ask AI about this page

Short answer

How do I add remote endpoints to Portainer using AI?

Tell your agent to add a new endpoint or authenticate an existing one. It uses the Portainer MCP to execute the connection commands and verify access. You get a fully managed environment ready for container management.

The end state.

Where your connections land.

The AI handles the heavy lifting of the handshake so you can focus on your containers.

READY

New environments live

The AI uses add_endpoint to register your Docker or Kubernetes host. The new environment shows up immediately in your Portainer dashboard.

SECURE

Authenticated access

Your agent runs authenticate to validate credentials. You get a secure link between your AI client and the remote environment.

SYNCED

Unified management

All remote endpoints are added to your existing Portainer instance. You can manage multiple clusters from one place via chat.

HUMAN

Manual oversight needed

You must provide the specific connection details like IP addresses or API keys. The AI cannot guess your private network credentials.

The workflow

What your AI does when the request arrives.

The AI translates your plain English instructions into specific Portainer API calls.

  1. Receive connection details

    Your agent parses the host information and environment type you provide in the chat.

    authenticate

  2. Register the host

    The AI sends the necessary data to Portainer to create the new endpoint entry.

    add_endpoint

  3. Verify credentials

    The agent runs a check to ensure the provided authentication tokens work with the new environment.

    authenticate

  4. Confirm setup

    The AI reports back once the endpoint is successfully added and reachable.

    add_endpoint

Try it

Copy these to start.

Use these prompts to trigger the Portainer connection process.

Starting points

Replace the bracketed text with your actual IP addresses, environment types, or API keys.

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

  • Add a new Docker endpoint at 192.168.1.50 to my Portainer instance.

  • Authenticate my existing Kubernetes cluster using this API token: [token].

  • Connect a new remote environment to Portainer using the following details: [details].

  • Can you add a new edge agent endpoint for my local Docker setup?

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

Start here

Connect Portainer once, then ask.

Click the link to connect your Portainer instance to Vinkius. Your credentials stay encrypted and your agent can start managing endpoints immediately.

Connect Portainer to your AI

FAQ

How this task behaves.

  • 01

    Can the AI create new Docker containers for me?

    No. This specific task is limited to adding and authenticating endpoints. It cannot manage individual containers or images.

  • 02

    Do I need to manually log in to Portainer every time?

    No. Once you connect the Portainer MCP, your agent handles the authentication through the established connection.

  • 03

    Can the AI delete my existing environments?

    No. The current tools only allow for adding and authenticating endpoints. Deletion is not a capability of this connector.

  • 04

    Will my Portainer password be visible to the AI?

    No. Authentication is handled through secure tool calls, and your sensitive credentials are managed by the MCP.

  • 05

    Can I add a Kubernetes cluster if I don't have the API URL?

    No. You must provide the specific connection details for the AI to successfully run the add_endpoint tool.

  • More questions about Portainer? See everything the Portainer Connector can do

Connect Portainer to Claude, Cursor, ChatGPT & more