SSyncDev

Flockbay MCP Server

Connects Claude Code, Codex, Cursor or Gemini CLI to a live Godot 4 editor inside the Flockbay app.

Local server

What is the Flockbay MCP Server?

Game code is hard for an agent to judge from source alone. It needs to run the thing, see the errors and look at the screen. The Flockbay MCP server opens that loop for Godot 4 projects by connecting your coding agent to a live Godot editor running inside the Flockbay desktop app.

What the agent can do in a game project

Once connected, the agent works against the open project rather than a static folder of files:

  • edit scenes and GDScript
  • run the game headless and read Godot's output, including parse errors
  • send input events to the running game
  • capture the viewport to see what is actually rendered

That combination is what makes playtesting possible: change a script, run it, press a key, look at the frame, read the error log, try again.

How the pieces fit

The plugin itself is thin, and the Flockbay MCP server does the real work. It only registers one MCP server, named flockbay, by running flockbay mcp. All the tools come from the Flockbay app, so the app must be installed and your game open in it before anything works. This is a local setup; the plugin collects nothing and only starts the app's server on your machine.

Setup by client

Client Route
Claude Code Install the plugin from its marketplace, or add flockbay mcp as a user-scope server
Codex Add the plugin marketplace, or codex mcp add flockbay -- flockbay mcp
Cursor Add a flockbay entry running flockbay mcp to ~/.cursor/mcp.json
Gemini CLI Install it as a Gemini extension

After installing in Claude Code, start a new session in the game's folder; the /mcp command should list flockbay.

Windows first, for now

The Windows app puts the flockbay command on your PATH, so open a fresh terminal after installing it. On macOS and Linux the app does not yet do that, which means the plugin cannot launch the server. There, open Connectors in the app, choose to connect your agent over MCP, switch it on and copy the line it generates for your machine instead.

Godot is the only engine covered. If you work in other engines, compare it with the Unity AI Bridge or see the full games and game development category.

How to install the Flockbay MCP Server

claude mcp add --scope user flockbay -- flockbay mcp

Frequently asked questions

Yes. The plugin only registers the server; every tool comes from the Flockbay app, and your game must be open in it.