AetherAether

Claude Code MCP Setup

Configure Claude Code (or any MCP-compatible client) to connect to the Aether MCP server.

ℹ️Coming Soon: CLI Setup for Claude Code

In a future release, npx aether-init --client claude will automate this setup. For now, follow the manual WebSocket configuration below.

Prerequisites

  • Claude Code or another MCP client
  • Aether bridge running (see Quickstart)
  • Unity project with Aether SDK installed

Configuration

Claude Code

Claude Code uses a similar configuration to Cursor. Create a configuration file in your project:

Location: .claude/mcp.json or project settings

1{ 2 "mcpServers": { 3 "aether": { 4 "url": "ws://localhost:7891" 5 } 6 } 7}

Generic MCP Client

For any MCP client that supports WebSocket connections:

Connection Details:

  • Protocol: WebSocket (WS)
  • URL: ws://localhost:7891
  • Format: JSON-RPC 2.0

Example Connection (Node.js):

1const WebSocket = require('ws'); 2const ws = new WebSocket('ws://localhost:7891'); 3 4ws.on('open', () => { 5 // Send initialize request 6 ws.send(JSON.stringify({ 7 jsonrpc: "2.0", 8 id: 1, 9 method: "initialize", 10 params: { 11 protocolVersion: "2024-11-05", 12 capabilities: {}, 13 clientInfo: { 14 name: "your-client", 15 version: "1.0.0" 16 } 17 } 18 })); 19});

MCP Protocol

Aether implements the Model Context Protocol (MCP) specification. The server exposes:

Tools

All tools follow the MCP tools/call pattern:

1{ 2 "jsonrpc": "2.0", 3 "id": 1, 4 "method": "tools/call", 5 "params": { 6 "name": "aether_snapshot", 7 "arguments": { 8 "include_ui": true, 9 "event_count": 10 10 } 11 } 12}

Available Tools

Aether exposes 20 MCP tools. Core examples:

  • aether_snapshot - Current Unity state + recent events + console
  • aether_tail - Events + state changes over last N seconds
  • aether_console - Query Unity stdout logs
  • aether_last_run_answer - Answer engine for the last run
  • aether_mark / aether_clip / aether_getClip - Clip capture + replay
  • aether_package / aether_viewCapsule - Capsules (Pro/Studio)
  • aether_recon / aether_instrument / aether_window - Two-run debugging
  • aether_observe / aether_inspect - Deep inspection tools
  • aether_proofclip_draft / aether_proofclip_export - Proof clips (Pro/Studio)
  • aether_verify / aether_vision_observe - Fix verification + VLM analysis (Pro/Studio)

See the Tools Reference for full schemas and parameters.

Verification

Test the connection:

  1. Connect to ws://localhost:7891
  2. Send an initialize request
  3. Call tools/list to see available tools
  4. Call tools/call with aether_snapshot to test
ℹ️Testing with curl

You can test the WebSocket connection using wscat:

1npm install -g wscat 2wscat -c ws://localhost:7891

Troubleshooting

Connection Issues

  • Verify bridge is running on port 7891
  • Check firewall settings
  • Ensure WebSocket protocol (not HTTP)

Protocol Errors

  • Verify JSON-RPC 2.0 format
  • Check request/response structure
  • Review MCP specification compliance

For more help, see the Troubleshooting Guide.

PreviousCursor
NextUnity SDK