Auralis für KI-Assistenten (MCP)

Damit erzeugt deine KI-Assistentin Auralis-Bilder, -Videos und -Sprachausgabe direkt im Gespräch — ohne dass du die Weboberfläche öffnen musst.

Einrichten

1. Schlüssel erstellen unter https://auralis.s-theempire.at/settings/api-keys. Er wird dir genau einmal angezeigt — kopiere ihn an einen sicheren Ort.

2. Server herunterladen und vorbereiten. Einmalig:

git clone <dieses-verzeichnis>   # oder den Ordner mcp-server kopieren
cd mcp-server
npm install

3. In den Assistenten eintragen. Bei Claude Desktop in claude_desktop_config.json — Pfad anpassen:

{
  "mcpServers": {
    "auralis": {
      "command": "node",
      "args": ["C:/pfad/zu/mcp-server/index.js"],
      "env": {
        "AURALIS_API_KEY": "sk_auralis_live_..."
      }
    }
  }
}

Sobald das Paket auf npm veröffentlicht ist, geht stattdessen auch "command": "npx", "args": ["-y", "@auralisai/mcp"] ohne lokale Installation.

4. Assistenten neu starten. Danach kannst du im Gespräch sagen: „Erzeug mir ein Bild von einem Fuchs im Nebelwald" oder „Lies mir diesen Text vor".

Windows Schritt für Schritt

Getestet unter Windows 10 und 11.

1. Node.js installieren. Benötigt wird Version 18 oder neuer. Lade den Installer der aktuellen LTS-Fassung von https://nodejs.org und führe ihn mit den Voreinstellungen aus. Prüfsummen und Signaturen findest du dort ebenfalls — sie sind maßgeblich.

Danach ein neues PowerShell-Fenster öffnen und prüfen:

node --version

Erwartet wird v18. oder höher. Erscheint stattdessen eine Fehlermeldung, war das Fenster schon vor der Installation offen — neu öffnen.

2. Ordner ablegen. Entpacke mcp-server an einen Ort ohne Leer- und Sonderzeichen im Pfad, zum Beispiel:

C:\Tools\auralis-mcp

3. Abhängigkeiten installieren. In PowerShell:

cd C:\Tools\auralis-mcp
npm install

4. Probelauf ohne Assistenten. So siehst du sofort, ob Schlüssel und Verbindung stimmen, statt im Assistenten zu raten:

$env:AURALIS_API_KEY = "sk_auralis_live_..."
node index.js

Erwartet wird eine Zeile wie Auralis MCP läuft. Basis: https://.... Der Server wartet danach auf Eingaben — das ist richtig so. Mit Strg + C beenden.

5. In den Assistenten eintragen. Die Konfigurationsdatei liegt unter Windows hier:

| Programm | Datei | |---|---| | Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json | | Codex | %USERPROFILE%\.codex\config.toml |

Pfadangaben in der JSON-Datei mit Schrägstrichen oder doppelten Rückstrichen schreiben — C:/Tools/auralis-mcp/index.js oder C:\\Tools\\auralis-mcp\\index.js. Ein einfacher Rückstrich macht die Datei ungültig, und die meisten Programme melden das nicht, sondern zeigen den Server einfach nicht an.

6. Assistenten vollständig beenden und neu starten. Nicht nur das Fenster schließen — unter Windows läuft er im Infobereich der Taskleiste weiter.

Wenn es nicht geht

| Symptom | Ursache | |---|---| | Server taucht im Assistenten nicht auf | JSON ungültig (meist ein einfacher Rückstrich im Pfad) oder Assistent nicht wirklich neu gestartet | | node wird nicht gefunden | PowerShell-Fenster war vor der Node-Installation offen | | Meldung zum Schlüssel | AURALIS_API_KEY fehlt, ist abgelaufen oder wurde widerrufen | | Aufruf abgelehnt | Tageslimit des Schlüssels erreicht, Guthaben leer, oder die Absenderadresse steht nicht auf der erlaubten Liste |

Ein Firewall-Eintrag ist nicht nötig: Der Server öffnet keinen Port, er spricht nur nach außen mit https://auralis.s-theempire.at.

Werkzeuge

| Werkzeug | Was es tut | Kostet | |---|---|---| | auralis_guthaben | Coin-Stand und Tageslimit | nichts | | auralis_modelle | verfügbare Modelle mit Preis | nichts | | auralis_bild | Bild erzeugen | 8–30 Coins | | auralis_video_starten | Video-Auftrag starten | ab 40 Coins | | auralis_video_zustand | Zustand abfragen | nichts | | auralis_sprache | Text vorlesen lassen | 12 Coins | | auralis_verlauf | zuletzt Erzeugtes | nichts |

Videos sind zweistufig: Erst starten, dann nachfragen. Sie brauchen ein bis zehn Minuten — so lange kann kein Werkzeugaufruf warten.

Welches Modell nimmt der Assistent?

Er waehlt selbst — die Werkzeuge geben ihm eine feste Auswahl und sagen, wofuer sich welches eignet. Eine eigene Kennung kann er nicht erfinden.

Bild

| Modell | Coins | wofuer | |---|---|---| | google/nano-banana-2-lite | 8 | Standard, Vorgabe | | google/nano-banana-2 | 15 | Referenzbilder, 2K/4K | | google/nano-banana-pro | 30 | beste Qualitaet, Schrift im Bild, bis 14 Referenzbilder | | openai/gpt-image-2.5-sunburst | 30 | anderer Anbieter, andere Bildsprache |

Video — alle mit Tonspur

| Modell | Coins | wofuer | |---|---|---| | google/veo-3.1-lite | 40 (4 s) | Standard, Vorgabe | | google/veo-3.1 | 300 (4 s) | hoechste Qualitaet | | alibaba/happyhorse-1.1 | 120 (3 s) | Clips ueber 8 Sekunden, Referenzbild |

Du kannst jederzeit selbst eines nennen („nimm Nano-Banana Pro"), dann hat das Vorrang.

Gut zu wissen

Es kostet echtes Guthaben. Der Assistent kann Coins ausgeben. Setz dir ein Tageslimit am Schlüssel (Voreinstellung 2000 Coins) — dann ist der Schaden begrenzt, falls er sich verrennt.

Der Schlüssel gehört in die Konfiguration, nicht in den Chat. Schreib ihn nie in eine Nachricht an den Assistenten: Gesprächsverläufe werden gespeichert.

Dieser Server prüft nichts selbst. Preise, erlaubte Modelle, Tageslimit und die Kennzeichnung nach EU-KI-Verordnung liegen auf dem Auralis-Server und lassen sich von hier aus nicht umgehen.

Erzeugte Inhalte sind KI-Inhalte und tragen eine Kennzeichnung in den Metadaten (Art. 50 KI-VO). Diese darf nicht entfernt werden.

Einstellungen

| Variable | Bedeutung | |---|---| | AURALIS_API_KEY | dein Schlüssel — Pflicht | | AURALIS_API_URL | andere Basisadresse, etwa für Tests. Ohne Angabe https://auralis.s-theempire.at | | AURALIS_MCP_VORSCHAU | 1 schickt Bilder, Video-Standbilder und Audio direkt im Gespräch mit |

Zur Vorschau

Standardmäßig kommen nur die Adressen zurück, keine Bilddaten.

Grund: Nicht jedes Programm stellt Bilder aus einem MCP-Server dar. Bei der ChatGPT-Desktop-App wurde am 28.09.2026 geprüft, dass sie es nicht tut — dort würde ein Vorschaubild rund 8.000 Zeichen Gesprächsspeicher pro Bild kosten, ohne dass man etwas sieht.

Wenn dein Programm es kann, schalt es ein:

"env": {
  "AURALIS_API_KEY": "sk_auralis_live_...",
  "AURALIS_MCP_VORSCHAU": "1"
}

Videos lassen sich nie im Gespräch abspielen — das MCP-Protokoll kennt nur Text, Bild und Audio, keinen Video-Typ. Mit eingeschalteter Vorschau kommt immerhin ein Standbild aus dem Video.