• READ
  • WRITE
  • SYNC
  • HUMAN

How to update virtual room settings with your AI

Connect WorkAdventure to your AI client to manage your virtual space. Once connected, you can change room properties just by asking.

Ask AI about this page

Short answer

How can I change my WorkAdventure room settings with AI?

You tell your AI client what you want to change, and it uses the WorkAdventure MCP to modify the room's state. It can read current settings and then apply new values to specific variables. You'll see the changes reflected in your virtual world immediately.

The outcomes

What you can do in the virtual world

Your AI handles the technical configuration of the room.

READ

Check current state

The AI looks up existing room variables to understand the current environment. This ensures it knows exactly what it's changing.

WRITE

Modify variables

The AI applies new values to room settings. This changes things like lighting, speed, or specific interactive triggers.

SYNC

Real-time updates

Changes happen in the virtual room as soon as the AI executes the command. You don't need to touch the code.

HUMAN

Manual overrides

You still control the core map design and assets. The AI only touches the variables exposed through the MCP.

The workflow

What your AI does when you ask for a change.

The AI acts as a bridge between your chat and the WorkAdventure engine.

  1. Inspect the room

    The AI first checks the current environment to see what variables are active and what their values are.

    get_room_variables

  2. Validate the request

    It compares your natural language request against the data it just pulled to make sure the change is valid.

    get_room_variables

  3. Apply the update

    The AI sends the new value to the room to trigger the change you asked for.

    update_room_variable

  4. Confirm success

    The AI verifies the variable was updated and tells you the new state of the room.

    get_room_variables

Try it

Copy these to start.

Use these prompts to begin interacting with your virtual space.

Starting points

These are examples. Swap out the variable names for the specific ones used in your WorkAdventure map.

WorkAdventure Connector

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

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

  • What are the current room variables in my WorkAdventure space?

  • Change the room variable 'ambient_light' to 0.5.

  • Set the 'player_speed' variable to 2 to make everyone move faster.

  • Update the 'is_event_active' variable to true.

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

Start here

Connect WorkAdventure once, then ask.

Click the link below to link the MCP to your client. Your credentials stay encrypted and secure. You can find the full technical details on the Connector page.

Connect WorkAdventure to your AI

FAQ

Common questions

  • 01

    Can the AI change the actual map tiles or sprites?

    No. The AI can only modify variables that are exposed through the room settings.

  • 02

    Does the AI need permission for every single change?

    No. Once you connect the MCP, the AI can execute any variable update you authorize through your chat interface.

  • 03

    Can the AI delete the entire room?

    No. The tools only allow for reading and updating specific variables, not deleting the room itself.

  • 04

    How do I know which variables I can change?

    You can ask your AI to list all available room variables first.

  • 05

    Will these changes affect other people in the room?

    Yes. Updating a room variable changes the state for everyone currently in that virtual space.

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

Connect WorkAdventure to Claude, Cursor, ChatGPT & more