Connect your AI client

Unreal AI Workbench is a remote MCP server. Your AI client connects to it over HTTP and signs in with OAuth — no API keys, no tokens to paste, no secrets stored on your machine.

Before you start

• No pre-setup needed — the first connection walks you through it: your client opens a browser window on spaghetti.gg where you sign in (account created with welcome credits) and approve the connection.

Install the Agent Plugin (recommended)

The Agent Plugin configures supported clients in one command:

# Universal installer (detects Claude Code, Cursor, Codex, VS Code, ...)
npx plugins add Tinirau/unreal-workbench

# Or, inside Claude Code:
/plugin marketplace add Tinirau/unreal-workbench

Add the server manually

Clients without Agent Plugins support can connect directly:

• Transport: Streamable HTTP
• URL: https://mcp.spaghetti.gg/api/mcp/agentic-engine/mcp

Example config for a client that supports custom headers (the headers are optional — see Teams and projects):

{
  "mcpServers": {
    "workbench": {
      "url": "https://mcp.spaghetti.gg/api/mcp/agentic-engine/mcp",
      "headers": {
        "x-spaghetti-team": "your-team-uuid",
        "x-spaghetti-project": "your-project-uuid"
      }
    }
  }
}

Sign in and verify

1. Start the connection in your client. It opens a browser window.
2. Sign in with your account and approve the access request.
3. Ask your client:

List the available tools.

You should see the Workbench tools — analyze_logs, tidy_assets, make_tool, topup, and the research tools listed in the Tools reference.

Clients that support standard MCP OAuth discovery (RFC 9728 protected-resource metadata) resolve the sign-in page on their own — beyond the URL, there's nothing to configure.

Project context (optional)

Team and project context is delivered to the server as x-spaghetti-team and x-spaghetti-project headers. In a UE project, the durable form is the engine's own Project Settings — the Spaghetti section of Config/DefaultGame.ini — and your AI client carries the same values as headers in its config. Context, not credentials; both are safe to commit. See Teams and projects.

One path wires it for you:

• Ask your AI client. The server tells clients to run setup_spaghetti before anything else — it walks you through picking or creating a team and project, writes the Project Settings and its own config, then asks you to restart the client (and the editor, if it's open).

Next steps

• Run your first analysis
• Install the UE connector — optional editor integration