IDE/Claude Code (Alpha)

Use Aura's Unreal Engine 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 access blueprint generation, analyze UAssets, and even generate images and 3D-assets from any MCP-compatible environment.

This lets you:

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

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.

Config file locations

• 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

When connected, your IDE can access:

• 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

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 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 — 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 setup with one project right now, you will need to manually remove to configure for multiple projects.

Troubleshooting

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

Connection errors: Ensure Aura is running in Unreal with a green connection indicator.

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