IDE/Claude Code (Alpha)

Use Aura's Unreal and Unity intelligence from your favorite IDE or AI coding assistant.

Overview

One-click integration with Claude Code, VS Code, Cursor, Rider, and Junie. Aura exposes its tools via MCP (Model Context Protocol), letting you drive Unreal or Unity from any MCP-compatible environment — generate blueprints, analyze UAssets, edit scenes and prefabs, run C# editor scripts, and generate images and 3D assets.

This lets you:

• Use your existing AI subscriptions (Claude Code, Copilot, etc.) with Aura's engine tools
• Work in your preferred IDE while controlling Unreal or Unity
• Save 50-75% on non-essential tasks by using your own AI subscription

Aura for Unreal

Quick Setup

1. Open Aura in Unreal
2. Click the Settings icon
3. Click MCP Configuration
4. Click Add to Editor
5. Select your IDE (Claude Code, VS Code, Cursor, or Rider)
6. Restart your IDE completely before using

⚠️ If you have existing MCP configurations or non-default settings, the one-click install may not work. Follow the manual setup below instead.

Manual Setup

If one-click doesn't work, copy the MCP config manually. All MCP-compatible IDEs use the same basic structure:

{
  "servers": {
    "aura": {
      "type": "stdio",
      "command": "path/to/python.exe",
      "args": ["path/to/Aura/MCP/aura_mcp.py"]
    }
  }
}

The command and args values come from Aura's Settings → MCP Configuration page.

Aura for Unity

Quick Setup

1. Open AuraForUnity and connect it to your Unity project
2. Click the Settings icon
3. Click MCP Configuration
4. Copy the displayed aura-unity server block into your IDE's MCP config (see locations below)
5. Restart your IDE completely before using

Manual Setup

Add the following server block to your IDE's MCP config:

{
  "servers": {
    "aura-unity": {
      "type": "stdio",
      "command": "path/to/AuraForUnity/python/python.exe",
      "args": ["-m", "aura_unity_mcp.server"]
    }
  }
}

The exact command path is shown on AuraForUnity's Settings → MCP Configuration page. On Windows the Python executable typically lives at %LOCALAPPDATA%\Programs\AuraForUnity\python\python.exe.

ℹ️ AuraForUnity must be running and connected to your Unity project for the MCP tools to respond. If the connection drops, the IDE will see tool errors until you reopen the project in AuraForUnity.

Config file locations

Both the aura (Unreal) and aura-unity (Unity) server blocks go into the same per-IDE MCP config file:

• VS Code — .vscode/mcp.json in workspace, or user settings
• Cursor — .cursor/mcp.json in workspace, or global settings
• Claude Code — ~/.claude/mcp.json
• Rider / JetBrains — Settings → Tools → AI Assistant → MCP Servers

After adding the config, restart your IDE completely and verify Aura tools appear in your AI assistant's tool picker.

Available Tools

From aura (Unreal)

• get_asset_meta — Get metadata for any asset
• get_asset_structs — Get struct metadata for assets
• get_asset_graph — Get detailed asset graph info
• review_blueprint — AI-powered blueprint code review
• edit_todo_list — Manage todo items
• create_new_todo_list — Create task lists
• launch_unreal_project — Launch Unreal Engine in headless mode. Auto-discovers the .uproject file from your working directory if no path is provided
• get_headless_status — Check the current connection state (editor connected, headless running, launching, or disconnected)
• shutdown_headless — Gracefully shut down the headless Unreal Engine instance

From aura-unity (Unity)

Exposes the full Unity editor surface — scene and GameObject CRUD, components, prefabs and variants, materials, terrain, animation, Input System, UI, packages, profiler, and execute_script for arbitrary C# editor scripts — plus server-side image, 3D-model, and screenshot generation. See the Unity Scene & Prefab, Unity Coding (C#), and Unity Editor Agent pages for the full list.

Caveats

Billing: Subagents like Python Execution and Blueprints use Aura's specialized intelligence and are charged to your Aura subscription, not your IDE's AI subscription. Your API costs for other platforms may increase signficantly while using Aura's intelligence.

Requirements:

• Aura (Unreal) or AuraForUnity must be running. Unreal can be launched automatically via the launch_unreal_project tool if not already open
• Requires a paid Aura subscription or active trial

Limitations:

• Less seamless than using Aura directly in Unreal or Unity — you need to know which tools to invoke
• Existing MCP Configurations including Auto-generated comments in some IDE MCP configs can break the one-click install
• MCP server removal must be done manually in your IDE's config
• Integrations are only set up with one project at a time — to switch, remove the existing server block and re-add it from the new project.

Troubleshooting

Tools not appearing: Restart your IDE completely after adding the MCP config.

Connection errors: Ensure Aura (Unreal) has a green connection indicator, or that AuraForUnity shows your Unity project as connected.

Config conflicts: If you have other MCP servers configured, add Aura manually to avoid conflicts.