# Getting started

> Connect your AI client to a Godot project in a few minutes.

Source: https://www.godotmcpstudio.com/docs/getting-started

Godot MCP Studio is a small desktop app that connects your AI client (Claude
Code, Cursor, Cline and others) to your Godot project through a local MCP
server. Here's the whole flow, start to finish.

## 1. Install the desktop app

Download Godot MCP Studio from the [download page](https://www.godotmcpstudio.com/download) and open it.
Lite is free and needs no license. For Pro, activate your license with the code
from your [dashboard](https://www.godotmcpstudio.com/dashboard). See [Installation](https://www.godotmcpstudio.com/docs/installation) for
platform notes and [Editions & pricing](https://www.godotmcpstudio.com/docs/editions-pricing) to compare the
two.

## 2. Pick your Godot project

The app detects your project by its `project.godot` file and shows the project
name. The full path lives under Advanced.

## 3. Install the editor addon

Click **Install addon**. This copies the Godot MCP Studio dock into
`addons/godot_mcp_studio/` in your project. Enable it in Godot under
Project → Project Settings → Plugins.

## 4. Generate your AI client config

Choose your client (Claude Code, Cursor, Cline, …) and copy the generated MCP
configuration. Godot MCP Studio can also write `AGENTS.md` / `CLAUDE.md` into
your project so your AI knows the house rules. Full walkthrough:
[Connect your AI client](https://www.godotmcpstudio.com/docs/connect-ai-client).

## 5. Choose a permission mode

Start in **Safe Edit** if you're unsure: it can create and edit, and asks before
destructive actions or running code. See [Permission modes](https://www.godotmcpstudio.com/docs/permission-modes).

## 6. Test the connection

Press **Test connection**. When Godot is open with the addon enabled, live
tools like `get_scene_tree` work. You're ready to build.

![The Pro desktop app connected to a Godot project and Codex, with permission controls and generation approvals.](https://www.godotmcpstudio.com/product/desktop-connected-light.png "Connected-state example. This screenshot has Full Control selected; choose Safe Edit if you want confirmation for destructive actions and code execution.")

## Where to next

- [Connect your AI client](https://www.godotmcpstudio.com/docs/connect-ai-client): per-client setup
- [Permission modes](https://www.godotmcpstudio.com/docs/permission-modes): what each mode allows
- [Live editing & the running game](https://www.godotmcpstudio.com/docs/live-editing): the good stuff
- [Image Studio](https://www.godotmcpstudio.com/docs/image-studio): artwork tools, animation, tiles, and export
- [Prompting for game art](https://www.godotmcpstudio.com/docs/image-studio-prompting): write clearer image requests