AI 비서에게 Godot 편집기에 대한 완전한 접근 권한을 주세요.

Claude, 커서 또는 MCP 호환 AI로 게임을 더 빠르게 만들 수 있습니다 — 복사 붙여넣기나 컨텍스트 전환 없이요. AI가 장면, 스크립트, 노드, 프로젝트 설정을 직접 읽고 쓰고 조작합니다.

Godot 4.4+ · 69개의 도구 · 되돌리기/다시 하기 · 인터랙티브 프로젝트 시각화 · MIT 라이선스

현재 Godot 자산 스토어에서 Godlink MCP로 출시 중입니다. 도움이 된다면 리뷰를 남겨주세요. 다른 Godot 개발자들이 주로 이 사이트를 찾는 방법입니다.

---

퀵 스타트

0. 설치 Node.js (일회성 설정)

설치 프로그램을 nodejs.org(LTS 버전)에서 다운로드하여 실행하세요. 표준 설치 프로그램이며 터미널이 필요하지 않습니다.

1. Godot 플러그인을 설치하세요

Godot 4.7 및 이후 버전: Godot 편집기 내에서 상단의 Asset Store 탭을 클릭→ **“Godlink”**를 검색→ “Godlink MCP” → 설치를 찾으세요. (스토어 페이지)

Godot 4.6 이상 버전: 대신 AssetLib 탭을 클릭→ “mcp” 검색→ “Godot AI Assistant tools MCP” → 설치를 찾으세요.

**수동 설치: ** 이 저장소에서 addons/godot_mcp/ 폴더를 프로젝트의 addons/ 폴더로 복사하세요.

그 다음 프로젝트 → 프로젝트 설정 → 플러그인으로 가서 Godot MCP 플러그인을 활성화하세요.

Godot MCP

Give your AI assistant full access to the Godot editor.

Build games faster with Claude, Cursor, or any MCP-compatible AI — no copy-pasting, no context switching. AI reads, writes, and manipulates your scenes, scripts, nodes, and project settings directly.

Godot 4.4+ · 69 tools · Undo/redo · Interactive project visualizer · MIT license

Now on the Godot Asset Store as Godlink MCP. If it helps you, please leave a review there. It’s the main way other Godot developers find it.

---

Quick Start

0. Install Node.js (one-time setup)

Download and run the installer from nodejs.org (LTS version). It’s a standard installer — no terminal needed.

1. Install the Godot plugin

Godot 4.7 and newer: inside the Godot editor, click the Asset Store tab at the top → search “Godlink” → find “Godlink MCP” → Install. (Store page)

Godot 4.6 and older: click the AssetLib tab instead → search “mcp” → find “Godot AI Assistant tools MCP” → Install.

Manual install: copy the addons/godot_mcp/ folder from this repo into your project’s addons/ folder.

Then go to Project → Project Settings → Plugins and enable the Godot MCP plugin.

2. Add the server config to your AI client

Claude Desktop — Settings → Developer → Edit Config → open the config file and paste:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Settings → MCP → Add Server:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — run in terminal:

claude mcp add godot -- npx -y godot-mcp-server

Works with any MCP-compatible client (Cline, Windsurf, etc.)

3. Restart your AI client

Close and reopen Claude Desktop / Cursor / your client so it picks up the new config.

4. Restart your Godot project

Hit Restart Project in the Godot editor. Check the top-right corner — once your AI client is running you should see MCP: Agent Active in green. You’re ready to go.

If it shows MCP: No Agent in orange, Godot found the server but no AI client is using it yet. Restart your AI client. MCP: Disconnected in red means the server isn’t running. Check that Node.js is installed and the config from step 2 is saved.

---

What Can It Do?