• CONFIG
  • VARS
  • AUDIT
  • HUMAN

How to configure repository environments with your AI

Connect Gitpod to your AI client to manage dev environments through chat. Once connected, you can handle configurations and variables without touching the Gitpod UI.

Ask AI about this page

Short answer

How do I set up Gitpod environments using AI?

You tell your AI client what configuration or variable you need, and it executes the changes in Gitpod for you. This covers everything from creating new environment variables to updating existing repository settings.

Environment management outcomes

Where your settings land

Your AI handles the heavy lifting of repo setup.

CONFIG

Updated repo settings

The AI modifies your Gitpod configurations based on your instructions. You get a consistent environment without manual YAML editing.

VARS

Managed environment variables

Add or remove secrets and variables instantly. Your AI keeps your environment state in sync with your commands.

AUDIT

Current state visibility

Ask your AI to list all active configurations or variables. You'll see exactly what is currently set in your Gitpod workspace.

HUMAN

Manual oversight required

You decide when to delete sensitive variables or wipe configurations. The AI won't make destructive changes without your direct command.

The workflow

What your AI does when the command arrives.

The AI translates your intent into specific Gitpod API calls.

  1. Inspect current state

    Your AI checks your existing Gitpod setup to understand the current environment context.

    list_configurationslist_environment_variables

  2. Apply changes

    The AI creates or updates the specific configurations or variables you requested.

    create_configurationupdate_configurationcreate_environment_variable

  3. Verify setup

    The AI pulls the latest data to confirm the new settings are active and correct.

    get_configuration

  4. Cleanup

    If you need to reset an environment, the AI removes the specified variables or configs.

    delete_configurationdelete_environment_variable

Try it

Copy these to start.

Use these prompts to trigger Gitpod actions immediately.

Starting points

Replace the bracketed text with your specific repo names or variable keys.

Gitpod Connector

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

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

  • List all the environment variables for my 'frontend-app' repository.

  • Create a new environment variable named API_KEY with the value 'secret_123' in the 'backend-service' repo.

  • Update the configuration for the 'data-pipeline' repository to include a new build step.

  • Delete the environment variable 'OLD_TOKEN' from my 'mobile-api' repo.

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

Start here

Connect Gitpod once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can immediately start managing repos from your chat interface.

Connect Gitpod to your AI

FAQ

How the Gitpod Connector behaves

  • 01

    Can the AI change my Gitpod user permissions?

    No. The AI only manages configurations and environment variables within the scope of the provided tools.

  • 02

    Will the AI delete my configurations automatically?

    No. The AI only deletes configurations or variables when you explicitly tell it to do so.

  • 03

    Can I see what variables are set without changing anything?

    Yes. You can ask the AI to list your environment variables or configurations to view the current state.

  • 04

    Does the AI handle my Gitpod login credentials?

    No. You connect the MCP through Vinkius, and your AI client uses that secure connection to perform tasks.

  • 05

    Can the AI create new repositories?

    No. The tools are limited to managing configurations and variables for existing repositories.

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

Connect Gitpod to Claude, Cursor, ChatGPT & more