Nova wird als Windows-Anwendung installiert. Nach der Installation kommt zuerst die Lizenzanmeldung, bevor Agenten und MCP-Verbindungen sinnvoll nutzbar sind.
Die MCP-Verbindung bleibt standardmäßig lokal. Claude Code und Codex nutzen sie, um Nova-Werkzeuge aufzurufen, während Browseraktionen, Freigaben und Agentenstatus in Nova sichtbar bleiben.
Für eine normale Einrichtung installierst du zuerst Nova, aktivierst anschließend die Lizenz und verbindest externe Agent-Clients erst danach über MCP. So bleiben Kontoaktivierung, Browserfreigaben und Agentenzugriff an einer sichtbaren Stelle.
Kurz gesagt
- Führe den Nova-Installer aus und starte danach die installierte Anwendung.
- Gib die E-Mail-Adresse und den Lizenzschlüssel aus deinem Nova-Konto oder deiner Lizenzmail ein.
- Lasse Nova geöffnet, während ein externer Agent die MCP-Verbindung nutzt.
- Behandle das MCP-Token wie ein Passwort und schreibe es nie in ein Repository.
Installation und Lizenz
- Installer ausführen Starte den heruntergeladenen Nova-Installer und schließe die Windows-Installation ab. Wenn Windows eine Sicherheitsmeldung zeigt, fahre nur fort, wenn die Datei aus der erwarteten Nova-Quelle stammt.
- Nova starten Öffne Nova Browser nach der Installation. Warte beim ersten Start, bis Browser-Oberfläche und Einstellungen geladen sind.
- Lizenzdaten eingeben Nutze die E-Mail-Adresse und den Lizenzschlüssel, die zu deinem Konto gehören. Nova prüft, ob dieser Build mit deiner Lizenz verwendet werden darf.
- Agenten vorbereiten Öffne die KI-Agenten-Einstellungen und verbinde die Anbieter, die du nutzen möchtest. Claude kann per API-Schlüssel oder CLI-Setup laufen; Codex nutzt den Codex-Account-Login.
Wann brauche ich das?
Diese Seite ist vor allem relevant, wenn Nova auf einem neuen Gerät installiert wird, nach Update oder Neuinstallation erneut aktiviert werden muss oder Claude Code beziehungsweise Codex die Nova-Werkzeuge wieder sehen sollen.
MCP-Verbindung
MCP ist die lokale Brücke zwischen Nova und externen Agent-Clients. Nova veröffentlicht für die laufende App einen localhost-Endpunkt und ein Bearer-Token. Nutze die Werte aus Nova oder aus der lokalen Discovery-Datei, statt Port oder Token fest einzutragen.
- Discovery-Datei
- %LOCALAPPDATA%\NovaBrowser\mcp.json enthält den aktuellen Endpunkt und das Bearer-Token.
- Endpunkt
- Sieht typischerweise aus wie http://127.0.0.1:<port>/mcp und kann wechseln, wenn Nova einen anderen Port nutzt.
- Token
- Wird für HTTP-Clients benötigt. Erzeuge es in Nova neu, wenn es versehentlich geteilt wurde.
- Reichweite
- Standardmäßig lokal. Remote-Zugriff sollte nur bewusst und mit klarem Sicherheitsgrund aktiviert werden.
MCP Client Setup
Es gibt drei Einrichtungswege: Nova schreibt die Client-Konfiguration, Claude Code oder Codex schreiben ihre eigene Konfiguration, oder du bearbeitest die Dateien manuell, wenn du volle Kontrolle brauchst.
Installation über Nova
Empfohlen für die meisten Nutzer. Aktiviere in den Nova-Einstellungen die automatische MCP-Synchronisierung und nutze Agent-Dateien, wenn ein Projekt die kompakte Nova-MCP-Referenz erhalten soll. Nova schreibt nur markierte Abschnitte und lässt vorhandene Agent-Notizen stehen.
Claude Code
Claude Code kann eine .mcp.json im Projekt oder eine nutzerweite MCP-Konfiguration lesen. Für Nova ist eine nutzerweite oder lokale Einrichtung meist besser, solange du keine Umgebungsvariablen nutzt, weil das Bearer-Token nicht ins Repository gehört.
Manuelle .mcp.json-Struktur
{
"mcpServers": {
"novabrowser": {
"type": "http",
"url": "<endpoint from Nova>",
"authorizationType": "none",
"headers": {
"Authorization": "Bearer <token from Nova>"
}
}
}
}
Claude-Code-Befehl
claude mcp add-json novabrowser "{\"type\":\"http\",\"url\":\"<endpoint from Nova>\",\"headers\":{\"Authorization\":\"Bearer <token from Nova>\"}}" --scope user
claude mcp get novabrowser
Codex
Codex liest MCP-Konfiguration aus config.toml. Nova kann einen stdio-Proxy eintragen, der Endpunkt und Token zur Laufzeit aus Nova liest. Dadurch muss das Bearer-Token nicht in der Codex-Konfiguration stehen.
Bevorzugter Codex-Proxy-Eintrag
[mcp_servers.novabrowser]
command = "node"
args = ["C:/Path/To/Nova/tools/novabrowser-mcp-stdio-proxy.mjs"]
Direkte HTTP-Alternative
[mcp_servers.novabrowser]
url = "<endpoint from Nova>"
http_headers = { Authorization = "Bearer <token from Nova>" }
Manuell über Dateien
Bearbeite die Client-Konfiguration selbst, wenn du einen besonderen Scope brauchst, temporär testen willst oder jeden Wert vor dem Speichern prüfen möchtest.
Nutze den Endpunkt und das Token aus Nova oder lies sie aus der lokalen Discovery-Datei. Bearer-Token gehören nie in ein Repository.
Verbindung prüfen
- Nova läuft, ist lizenziert und MCP ist in den Einstellungen aktiv.
- Claude Code: claude mcp list ausführen oder /mcp in Claude Code öffnen.
- Codex: codex mcp list ausführen oder /mcp in der Codex-TUI öffnen.
- Wenn ein Client weiterhin keine Werkzeuge sieht, Terminal oder IDE neu starten und die Nova-Konfiguration erneut synchronisieren.
Grenzen und Sicherheit
- Lizenzschlüssel, Bearer-Token und private Kontodaten gehören nicht in öffentliche Doku, Repositories, Screenshots oder Support-Tickets.
- Füge Nova MCP nur Projekten hinzu, in denen der Agent mit Browserinhalten arbeiten darf.
- Browser-verändernde Aktionen können je nach Sicherheitseinstellung weiterhin Freigaben in Nova benötigen.
- Wenn die Lizenzprüfung scheitert, prüfe Internetverbindung, Systemzeit und ob der installierte Build zu deiner Lizenz passt.