Einen externen Agenten verbinden

Nutze das Ennea-Plugin in einem unterstützten Assistenten oder die private Entwickler-CLI aus deinem Ennea-Checkout/Paket. Beide nutzen die Stufen unter Externe Agenten. Beginne mit Lesen und wähle den genauen Bereich und benötigte Datensatztypen.

Ennea für Codex installieren

Das öffentliche Ennea-Pluginprojekt liefert den Marketplace. Zugriff auf Enneas Anwendungsrepository ist unnötig. In einem Host mit Codex-Plugin-CLI:

codex plugin marketplace add AlaaSubora/ennea-codex-plugin --ref main
codex plugin add ennea@ennea

1. Starte den Desktop-Host nach der Installation neu und öffne einen neuen Chat mit aktiviertem Ennea.
2. Nutze die Ennea-Verbindung des Hosts. Melde dich im Browser bei Ennea an und wähle Organisation, Standort, Umgebung, Zugriffsstufe und Datensatztypen.
3. Führe den Setup-Skill aus. ennea_context und ennea_capabilities sollen tatsächliche Identität/Bereich und verfügbare Aktionen liefern.
4. Frage lesend nach höchstens zehn erlaubten Materialien. Prüfe Bereich und Quellen vor Änderungsaufträgen.

Der gehostete Dienst ist https://api.ennea-ai.com/mcp; für andere Bereitstellungen gilt der mitgeteilte Endpunkt. Der Host verwaltet OAuth-Zugangsdaten. Hierfür benötigst du weder Token im Chat noch lokalen MCP-Prozess.

Zur Einrichtung des Marketplace und zur Installation im jeweiligen Host siehe OpenAIs Anleitung zu Plugins. Nutze eine Clientversion, die die gezeigten Befehle unterstützt.

Entwickler-CLI aus privatem Checkout

Das Adapterpaket ist privat und kein öffentlicher npm-Download. Beziehe geprüften Quelltext oder ein Release-Archiv über deinen Implementierungskontakt. Für einen Checkout brauchst du Node.js 24 und pnpm:

pnpm install
pnpm --filter @ennea/agent-adapter cli --help

Erstelle unter Betriebsstudio → Integrationen → KI-Agenten → Agentenzugriff einen begrenzten Entwicklerzugang. Wähle Lesen, deinen Testbereich und gegebenenfalls Material. Bewahre die Zugangsdaten über den vorgesehenen Prozess in einer privaten Datei auf. Setze Pfad und API-Ursprung; diese Beispiele enthalten keinen Token:

export ENNEA_URL="https://api.ennea-ai.com"
export ENNEA_TOKEN_FILE="/absolute/private/path/ennea-token"
pnpm --filter @ennea/agent-adapter cli context
pnpm --filter @ennea/agent-adapter cli capabilities material
pnpm --filter @ennea/agent-adapter cli query --file /absolute/path/agent-query.json

Lade vor dem letzten Befehl agent-query.json herunter:

{ "entityType": "material", "limit": 10 }

Die Datei fordert nur einen Lesezugriff an. context muss den richtigen Verbindungsbereich zeigen. capabilities material beschreibt aktuelle Aktionen/Schemata; query liefert zugängliche Materialien bis zur gewählten Grenze. Null Treffer können gültig sein. Prüfe Bereich/Zugriff, bevor du fehlende Daten annimmst.

Die CLI gibt ein JSON-Objekt aus. Exit 0 bedeutet abgeschlossener Befehl; 1 Eingabe-/Transportfehler vor strukturiertem Ergebnis; 2 ein Ergebnis mit Handlungsbedarf. Lies den sicheren Fehlercode. Ein Ergebnis mit Handlungsbedarf belegt keine Veröffentlichung oder Ausführung.

Vom Lesen zum Entwurf

Verbinde erneut oder erstelle einen separaten Entwürfe bearbeiten-Zugang, wenn Entwurfsarbeit gewünscht und erlaubt ist. Lies Zielentwurf und genaue expectedVersion, bearbeite mit dem entdeckten Schema und prüfe den gespeicherten Entwurf im Studio. Eine eigene ausdrückliche Veröffentlichung benötigt Veröffentlichen, aktuelle fachliche Rechte und die genaue Version. Externe Agenten erklärt Aktionen, Pakete und dauerhafte Belege.

Verbindung wiederherstellen

Symptom	Vorgehen
Plugin sichtbar, Werkzeuge fehlen	Ennea aktivieren, Marketplace aktualisieren, Host neu starten und neuen Chat prüfen.
HTTP 401 / Anmeldung erforderlich	Über den Host neu verbinden oder CLI-Ablauf und ausstellende Sitzung prüfen.
Aktion/Datensatztyp verweigert	Freigegebene Stufe/Typen und aktuelle Fachrechte prüfen.
Falscher Bereich	Mit gewünschtem Bereich neu verbinden; Werkzeugargumente ändern ihn nicht.
Schreibergebnis unbekannt	Ursprünglichen Aktionsbeleg prüfen und Aufruf-/Idempotenzkennung behalten.

Refresh-Tokens wechseln. Die Verbindung bleibt an ausstellende Sitzung, Ablauf und aktuelle Rechte gebunden. Widerruf stoppt künftige Zugriffe und erhält abgeschlossene Datensätze/Historie. Unter Support steht, welche sicheren Nachweise helfen.