Somni Game Studios를 포함한 Godot 개발자 및 팀들이 사용하고 있습니다.

Fennara는 AI 어시스턴트에게 Godot와의 실시간 연결을 제공합니다. Codex, Claude, Cursor, Gemini, Antigravity와 같은 MCP 지원 앱이나, 선택 사항인 에디터 내 채팅 독(chat dock)에서 사용할 수 있습니다.

에이전트(Agents)는 단순히 프로젝트 파일만 보고 추측하는 대신, 씬(scene)을 검사하고, 스크립트를 확인하며, 스크린샷을 캡처하고, 런타임 에러(runtime errors)를 읽고, 에디터 내부의 변경 사항을 검증할 수 있습니다.

|
|
시청하기: Fennara와 다른 Godot MCP 비교 - Fennara의 Godot 피드백 루프가 명령 전용 MCP 워크플로우와 어떻게 다른지 확인해 보세요. |

• MCP를 통해 외부 AI 앱에 Godot 인지 도구(Godot-aware tools)를 노출합니다.
• Godot 에디터 내부에 선택 사항인 로컬 채팅 독(chat dock)을 추가합니다.
• 실제 Godot 피드백을 반환합니다: 씬 트리(scene trees), 진단(diagnostics), 스크린샷, 런타임 로그(runtime logs) 및 검증 결과.
• 에이전트가 파일 시스템에만 의존하는 대신 열려 있는 에디터에 책임을 갖도록 유지합니다.

외부 MCP 앱과 내장 채팅은 별도의 모델 설정을 사용합니다. MCP Apps And Built-In Chat 및 Built-Built Chat Providers를 참조하세요.

• Godot 4.5 이상.
• 지원되는 데스크톱 OS: Windows x86_64, Linux x86_64 또는 macOS arm64.
• Claude, Codex, Cursor, Gemini, Antigravity 또는 다른 외부 AI 앱에서 Fennara를 사용하려는 경우에만 MCP 지원 코딩 앱이 필요합니다.
• 내장된 Fennara 채팅 독을 사용하려는 경우에만 채팅 제공자(chat provider)가 필요합니다. 이는 클라우드 제공자 키이거나 Ollama / LM Studio와 같은 로컬 제공자일 수 있습니다.

전체 설치 절차는 Setup을 참조하세요.

• 소형 fennara CLI - AI 코딩 앱에서 사용되는 로컬 MCP 서버

• MCP/채팅 요청을 열려 있는 Godot 에디터로 연결하는 로컬 데몬(daemon)

• res://addons/fennara/에 복사되는 Godot 애드온(addon)

• AI 에이전트를 위해 생성된 프로젝트 가이드

내장 채팅 독은 플랫폼 웹뷰(webview)를 사용합니다: Windows에서는 Microsoft Edge WebView2, macOS에서는 WKWebView/WebKit, Linux에서는 Fennara가 관리하는 공유 CEF 런타임을 사용합니다. 선택 사항인 채팅 독을 시작할 수 없더라도 MCP 도구는 여전히 작동합니다.

먼저 CLI와 Godot 애드온을 설치한 다음, MCP 앱 경로, 내장 채팅 경로 또는 두 가지 모두를 선택하세요.

Windows:

irm https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.sh | sh

설치 확인:

fennara doctor

Godot 프로젝트 폴더에서 다음을 실행하세요:

cd path/to/your-godot-project
fennara install

C# 프로젝트의 경우:

fennara install --csharp

--csharp은 Fennara의 관리형 csharp-ls 언어 서버 (language server) 지원을 설치하여, script_diagnostics, 런타임 사전 점검 (runtime preflight checks), 그리고 C# 피드백이 실제 C# 파서 (parser)/타입 (type) 문제를 보고할 수 있도록 합니다.

그 다음 Godot에서 프로젝트를 여세요.

fennara install은 AI 코딩 에이전트 (AI coding agents)를 위한 프로젝트 가이드도 작성합니다:

AGENTS.md
addons/fennara/ai/guidelines.md

내장된 Fennara 채팅 독 (chat dock)만 사용하려는 경우 이 단계를 건너뛰세요.

Claude Code 및 Claude Desktop:

fennara mcp-setup --claude

Gemini 및 Antigravity:

fennara mcp-setup --gemini

Cursor:

fennara mcp-setup --cursor

Codex:

fennara mcp-setup --codex

기타 대상:

fennara mcp-setup --help

설정 후에는 Fennara 서버를 다시 로드할 수 있도록 MCP 앱을 재시작하세요.

사용 중인 앱이 목록에 없거나 MCP 설정을 수동으로 편집해야 하는 경우, MCP Setup을 참조하세요.

이 단계는 외부 MCP 앱만 구성합니다. 내장된 Fennara 채팅 모델은 구성하지 않습니다. mcp-setup --claude를 실행한 후에도 왜 독 (dock)에서 프로바이더 (provider)를 요청하는지 궁금하다면 MCP Apps And Built-In Chat을 참조하세요.

Godot 프로젝트가 열려 있는 상태에서, MCP 앱에 다음과 같이 물어보세요:

Use Fennara MCP to run fennara_status and tell me which Godot project is connected.

프로젝트 경로가 올바르다면, MCP 서버와 Godot 플러그인이 통신하고 있는 것입니다.

둘 이상의 Godot 프로젝트가 열려 있는 경우, Fennara 독의 MCP 대상 제어 (MCP target control)를 사용하여 어떤 프로젝트가 외부 MCP 도구 호출 (tool calls)을 받을지 선택하세요.

Godot 프로젝트 폴더에서 다음을 실행하세요:

cd path/to/your-godot-project
fennara update

fennara update

fennara update는 릴리스 매니페스트 (release manifest)를 읽고, 더 새로운 릴리스가 필요한 경우 설치된 CLI를 업데이트한 다음, 프로젝트 애드온 (addon), 로컬 런타임 패키지 (local runtime package), 생성된 Fennara 가이드 파일, 그리고 현재 플랫폼에서 필요한 릴리스 관리형 공유 웹뷰 (shared webview) 런타임을 새로고침합니다. Windows/macOS에서는 플랫폼 웹뷰 (webview) 필수 요구 사항을 확인하며, 내장된 채팅 독 (chat dock)이 시작되지 않을 수 있음을 경고합니다. 선택한 릴리스 또는 설치 위치에 대해 CLI 자체 업데이트 (self-update)를 사용할 수 없는 경우에만 설치 스크립트를 다시 실행하세요.

Fennara는 Godot를 인식하는 소수의 도구 세트를 제공합니다:

• 프로젝트 파일을 작성하거나 업데이트하고 진단 결과 (diagnostics) 반환
• 일회성 씬 편집 스크립트 (scene edit scripts) 실행
• 씬 트리 (scene trees), 노드 (nodes), 리소스 (resources), 그리고 Godot 클래스 (classes) 조사
• 씬 검증 (validate scenes)
• 스크린샷 캡처
• 런타임 세션 (runtime sessions) 시작 및 런타임 로그 읽기
• 라이브 씬을 대상으로 소규모 런타임 스크립트 실행

목표는 에이전트의 일반적인 파일 도구를 대체하는 것이 아닙니다. Fennara는 누락된 Godot 피드백 루프 (feedback loop)를 제공합니다.

Fennara 독 (dock)에는 Godot 내부에 네이티브 웹 채팅 인터페이스가 포함되어 있습니다. 이는 호스팅된 Fennara 백엔드가 아닌 로컬 데몬 (local daemon)과 통신합니다.

• 본인의 모델 제공자 키 (model provider key)를 사용하거나, 로컬 Ollama / LM Studio를 사용하세요
• /provider 및 /model을 사용하여 Godot 내부에서 모델을 전환하세요 - 선택한 스크립트 범위와 지원되는 이미지 컨텍스트 (image context)를 첨부할 수 있습니다
• 채팅 기록, 제공자 키, 로컬 URL을 사용자의 기기에 유지합니다
• Godot에 내장된 채팅 또는 시스템 브라우저에서 채팅을 엽니다

상세 정보: 내장 채팅 제공자 (Built-In Chat Providers), 내장 채팅 슬래시 명령어 (Built-In Chat Slash Commands).

Fennara 실습 가이드를 시청하세요:

더 많은 영상:

• I Gave Codex an AI Game Image and It Built This in Godot
• Fennara MCP Builds a Katamari-Style Godot Game
• This Godot Plugin Transforms AI Game Development Forever

Fennara 채널의 더 많은 영상을 보려면 Demos를 확인하세요.

유용한 시작 지점:

• Setup (설정)
• MCP setup (MCP 설정)
• Repo map (리포 맵)
• Architecture (아키텍처)
• Tools (도구)
• FAQ (자주 묻는 질문)
• Demos (데모)
• Manual install notes (수동 설치 노트)
• Release process (릴리스 프로세스)
• Contributing (기여하기)
• Security (보안)

질문, 설정 도움말 및 초기 피드백은 Discord에서 환영합니다:

LICENSE.md를 참조하세요.