MCP-Tools

Sobald sich Ihr Agent mit dem MCP-Endpunkt von nyxory verbindet, bekommt er die unten aufgeführten nyx_-Tools: ausrollen, untersuchen, Secrets verwalten, Infrastruktur steuern, jeweils beschränkt auf die Projekte, auf die Sie Zugriff haben. Rufen Sie bei jedem Deploy zuerst nyx_brain auf. Es liefert das Deploy-Cookbook plus einen Live-Schnappschuss des aktuellen Projektzustands und sagt dem Agenten, welche Form von project er für den Rest des Laufs verwenden soll.

Gehirn

Tool

Zweck

nyx_brain

Der erste Aufruf jedes Deploys. Liefert das Deploy-Cookbook plus einen Live-Schnappschuss des Projektzustands zu einem Repo. Nimmt optional repo_url, project und agent_briefing. Ohne repo_url beginnt die Antwort damit, wie man ein Repository anlegt. Auf einer dedizierten Instanz mit Architekturvorgaben enthält die Antwort außerdem data.reference_architectures mit data.ranking (model oder keyword), data.cloud_strategy und data.requirements. Ist reference auf die id einer Referenzarchitektur gesetzt, liefert es die Bauanleitung dieser Vorlage mit den eingesetzten Werten des Projekts.

Architektur

Tool

Zweck

nyx_exception_request

Beantragt für ein Projekt eine Ausnahme von einer Architekturvorgabe, auf einer dedizierten Instanz. Nimmt project, subject (technology:<name> oder einen Baustein: postgres, bucket, storage, public_url, custom_domain, images, memory), reason und optional duration (30, 90, 365 oder unlimited, Standard 90). Liefert den Antrag mit seinem Status und created. Statt eines zweiten Antrags kommt derselbe offene Antrag zurück. Ein Mensch entscheidet, nie der Agent. Siehe Architekturvorgaben.

Workspace

Tool	Zweck
nyx_shell	Führt einen Shell-Befehl im Projekt-Workspace des Agenten aus (Standard-cwd /workspace/repo, Standard-Timeout 120 s, maximal 600 s). Liefert stdout, stderr und Exit-Code getrennt zurück.
nyx_read_file	Liest eine UTF-8-Datei aus dem Workspace (über 2 MiB schlägt fehl, nutzen Sie dann nyx_shell mit grep/head/tail).
nyx_write_file	Schreibt oder überschreibt eine Datei unter /workspace, atomar.
nyx_edit_file	Ersetzt einen eindeutigen Teilstring in einer Datei. Der Teilstring muss genau einmal vorkommen und wird wörtlich verglichen, ohne Regex.

Secrets

Tool	Zweck
nyx_set_secret	Verschlüsselt einen Wert und speichert ihn als Projekt-Secret oder App-Secret. Der Operator stellt es bereit und rollt betroffene Workloads automatisch neu aus.

Build und Deploy

Tool	Zweck
nyx_build_and_push_image	Baut ein Container-Image aus dem Repo (Buildpacks oder Dockerfile) und pusht es, als eigener Build-Job. Liefert die image_ref für das Manifest. Läuft der Build nach etwa 45 Sekunden noch, kommt stattdessen status: building mit einem build_job, den Sie mit nyx_build_status verfolgen.
nyx_build_status	Prüft Builds, ohne einen zu starten. Nur mit project listet es jeden Build im Projekt, auch Auto-Deploy-Builds. Zusätzlich mit job ({"project":"…","job":"…"}) beobachtet es diesen Build und liefert seine Phase, die image_ref, sobald gepusht, und die letzten Logzeilen.
nyx_deploy_manifests	Wendet die App-CRD und zugehörige Ressourcen atomar an: beim ersten Deploy das vollständige app_manifest plus rest_manifests, bei einem Update nur die geänderten rest_manifests.

Apps

Tool	Zweck
nyx_app_list	Listet jede App in allen Projekten, auf die der Nutzer Zugriff hat: der persönliche Workspace und jeder geteilte Workspace, der ihm gehört oder in dem er Mitglied ist. Jede Zeile nennt ihren workspace und workspace_name.
nyx_app_get	Details zu einer App, einschließlich ihrer Ingress-Hosts. Mit view: deployments ihre Rollout-Historie, mit view: uptime ihre Verfügbarkeit, ein Wert pro Tag, bis zu 90 Tage zurück.
nyx_app_logs	Liest die Container-Logs einer App direkt, ohne Umweg über nyx_shell und kubectl. Strukturierte Zeilen mit RFC3339-Zeitstempel, filterbar nach tail, since, grep, container, pod und previous.
nyx_app_security	Behebbare CVEs im ausgerollten Image der App, aus dem Scan der Registry und der Stückliste (Bill of Materials), die der Build angehängt hat. Trennt die Funde nach Ihren eigenen Abhängigkeiten und dem Basis-Image. Siehe Security-Scans.

Betrieb

Tool	Zweck
nyx_ops_events	Liest den Betriebs-Feed eines Projekts: was die Plattform erkannt hat, was sie daraufhin getan hat und mit welcher Befugnis sie gehandelt hat.
nyx_runs	Listet die Agentenläufe eines Projekts, die neuesten zuerst, mit Status, Dauer, Kosten und dem Ein-Wort-Urteil der Plattform (loop, budget80, baseline:2.1x). Ohne project listet es Läufe über alle Projekte, die Sie sehen können. Mit run (einer ID aus der Liste) zeigt es diesen Lauf Schritt für Schritt, mit seinen Warnungen und dem typischen Lauf des Projekts. Hält fest, womit jedes Tool aufgerufen wurde, nicht was es zurückgab.

Projektdokumente

Tool	Zweck
nyx_doc_list	Listet die Dokumente des Projekts: die, die nyxory pro App führt, und Ihre eigenen. Mit query durchsucht es sie, nach Relevanz sortiert.
nyx_doc_get	Liest ein Dokument per slug, wie von nyx_doc_list aufgeführt. Mit question befragt es stattdessen die Dokumente des Projekts und liefert eine Antwort mit ihren Quellen. Eine Frage, die sie nicht beantworten können, wird als Lücke markiert, mit einem Entwurf, den eine Person freigibt.
nyx_doc_write	Schreibt oder aktualisiert ein Dokument (slug, body, optional title und app). Dauerhaft und versioniert, anders als Dateien im Workspace des Agenten, der im Leerlauf geleert wird.

Backup und Wiederherstellung

Tool	Zweck
nyx_backup_list	Listet die Backups einer App und die Keep-N-Plätze ihres Tarifs: Auslöser, Phase, Größe, festgehaltenes Image.
nyx_backup	action: create erstellt ein crash-konsistentes Backup einer App zu einem Zeitpunkt: CSI-Volume-Snapshots, Manifeste und Image-Referenz. action: restore stellt eine App aus einem Backup im Modus data, app oder full wieder her. Es erstellt vorher automatisch einen Sicherheits-Snapshot und pausiert Auto-Deploy bei app/full.

Datenbanken und Buckets

Tool	Zweck
nyx_data	Entfernt eine Postgres-Datenbank (type: postgres) oder löscht einen Bucket mit allen Objekten darin (type: bucket). Nimmt project, name und confirm (den Namen noch einmal eingetippt). Erfordert die Freigabe des Eigentümers. Die Datei aus deploy/ zu nehmen, entfernt keines von beiden. Siehe App aus dem Repo konfigurieren.

Projekte

Tool	Zweck
nyx_project_list	Das ganze Bild in einem Aufruf: das Konto (account: Tarif, RAM-Kontingent mit Grundkontingent und zusätzlichen Paketen, Budget), die Workspaces, in denen der Nutzer handeln kann, mit seiner Rolle (owner, admin, member), und jedes Projekt, auf das er Zugriff hat. Jedes Projekt trägt workspace (ID) und workspace_name. Die Workspace-ID ist das Argument workspace von nyx_project_add.
nyx_project_state	Liefert die RAM-Zuteilung eines Projekts, die aktuellen Pod-Reservierungen und den verbleibenden Spielraum im Kontingent des Kontos. Mit view: map stattdessen die Systemkarte des Projekts als kompakten Text: jede App mit Zustand, Image, Ports, Volumes und Einstiegspunkten, die gemessenen Verbindungen zwischen Apps und im Code belegte Aufrufe externer Systeme.
nyx_project_add	Legt ein neues Projekt an. Nimmt name (Anzeigename, den Namespace vergibt der Server) und, wenn der Nutzer mehr als einen Workspace hat, workspace. Fehlt es, wird der Aufruf mit der Liste der Workspaces abgelehnt, statt stillschweigend im persönlichen Workspace zu landen.
nyx_project	Ändert ein Projekt per action: rename ändert seine Anzeigebezeichnung (die ID bleibt gleich), ram setzt seine RAM-Zuteilung in MB (auf 256-MB-Schritte gerundet), delete entfernt es (destruktiv, erfordert die Freigabe des Eigentümers).

Domains

Tool	Zweck
nyx_domain_list	Listet die eigenen Domains des Nutzers, über alle Projekte oder gefiltert. Mit host die Phase dieser Domain und den nächsten nötigen Schritt.
nyx_domain	action: add registriert einen eigenen Hostnamen für eine App. action: remove löscht eine Domain samt Ingress und Zertifikat (erfordert die Freigabe des Eigentümers).

Git-Quellen

Tool	Zweck
nyx_github_install_url	Erzeugt eine signierte Installations-URL für die nyxory GitHub App, 10 Minuten gültig.
nyx_clone_repo	Klont ein Repository in den Workspace des Agenten: über eine verbundene GitHub-Installation, eine freigegebene HTTPS-Git-Verbindung (connection_id) oder ein gehostetes nyxory-Git-Remote. Nimmt repo_url, optional branch, depth, installation_id. Liefert den Checkout-Pfad und den Commit-SHA. Siehe Aus einem privaten Repo ausrollen.
nyx_github_list	Listet die verbundenen GitHub-App-Installationen des Nutzers. Mit kind: repos die Repos, die eine Installation sehen kann.
nyx_git_remote_create	Legt ein gehostetes nyxory-Git-Remote und ein kurzlebiges Push-Credential für ein Projekt an, für lokale Quellen, die nicht von GitHub kommen.

Eine GitHub-Installation trennen Sie ebenfalls selbst. Das geschieht in der Console, siehe Aus einem privaten Repo ausrollen. API-Tokens verwalten Sie, nicht Ihr Agent. Sie erstellen und widerrufen sie mit nyx token (siehe nyx-CLI-Referenz).