• ACTIVE
  • READY
  • OFFLINE
  • MANUAL

How to manage zrok environments with your AI

Connect your zrok infrastructure to your AI client once. From there, you can control your tunnels and machines using simple text.

Ask AI about this page

Short answer

Can I control zrok environments with my AI?

Yes. You can use your agent to see what's running, turn on specific machines, or shut down tunnels. This breakdown shows how your agent handles these requests.

Environment control.

Where your commands land.

Your agent maps your text to specific zrok actions.

ACTIVE

View running tunnels

The AI pulls a list of your current environments so you know what is exposed to the internet.

READY

Start new environments

Your agent triggers the activation of specific machines or containers in your setup.

OFFLINE

Shut down tunnels

You can tell your AI to kill a specific environment to stop sharing a resource.

MANUAL

Human intervention

If a machine fails to respond to an enable command, you'll need to check the local zrok client yourself.

The workflow

What your AI does when the request arrives.

Your agent translates your intent into direct zrok commands.

  1. Inventory check

    When you ask what is currently running, the AI scans your active zrok setup to provide a list.

    list_environments

  2. Environment activation

    If you need to bring a specific container or machine online, the AI sends the command to start it.

    enable_environment

  3. Environment shutdown

    To stop a tunnel, the AI instructs zrok to disable the specified environment.

    disable_environment

  4. Status verification

    The AI checks the results of its actions to confirm if the environment is actually enabled or disabled.

    list_environments

Try it

Copy these to start.

Use these prompts to interact with your zrok setup.

Starting points

Replace the bracketed text with your specific environment names or container IDs.

zrok Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_ClXF7DisyXQ0EoLqQIltNLLkA1JbCPYyg6iY16El/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 — zrok capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "zrok-open-source-tunnel-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ClXF7DisyXQ0EoLqQIltNLLkA1JbCPYyg6iY16El/mcp"
    }
  }
}
Copy into chat04

  • Show me all my active zrok environments.

  • Enable the environment named production-web-server.

  • Disable the container running the database tunnel.

  • List my environments to see if the dev-api is still active.

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

Start here

Connect zrok once, then ask.

Follow the link to connect your zrok credentials. Once connected, your AI client will have direct access to your environments.

Connect zrok to your AI

FAQ

How this task behaves.

  • 01

    Can the AI create new zrok environments from scratch?

    No. The AI can only enable, disable, or list environments that already exist in your zrok infrastructure.

  • 02

    Will the AI delete my zrok configurations?

    No. The available tools only allow for enabling, disabling, or listing environments. No deletion tools are provided.

  • 03

    How do I know if an environment was successfully disabled?

    After the AI runs the command, you can ask it to list your environments to verify the change.

  • 04

    Can I manage my local zrok CLI settings through the AI?

    No. The AI only interacts with the environments through the provided zrok tools, not your local CLI configuration files.

  • 05

    Does the AI need my zrok password?

    No. Your credentials stay encrypted and managed by Vinkius; the AI only uses the authorized tools to act on your behalf.

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

Connect zrok to Claude, Cursor, ChatGPT & more