Erstan Agent Tools Beta

Vorläufige Erstan-Beta-Integration für KI-Agenten-Codierungstools. Dieses Repository bündelt ein breites Plugin, das Beta-Nutzern Zugang zur isolierten QA-Umgebung von Erstan verschafft und gezielte Anweisungen für das Erstellen, Überprüfen und Optimieren von Agents und Skills, das Ausführen von Runs sowie die Arbeit mit autorisierten Workspace-Inhalten bereitstellt.

Beta-Umgebung: Daten und OAuth-Genehmigungen in diesem Plugin sind von der Produktion getrennt. Installieren Sie das Produktions-Plugin erstan, wenn Ihr Workspace migriert ist. Dieses Repository wird dann stillgelegt.

Das Plugin enthält keinen Erstan-API-Schlüssel. Jeder Benutzer meldet sich bei https://api-qa.erstan.com/v1/mcp mit OAuth über seinen KI-Host an. Die serverseitige Beta-Zugriffsrichtlinie von Erstan bleibt die Zugriffsgrenze; die Sichtbarkeit des Repositories gewährt keinen Produktzugriff.

Was enthalten ist

• erstan-agent-builder – Agent-Graphen erstellen, überarbeiten, validieren, testen und veröffentlichen.

• erstan-agent-optimizer – einen vorhandenen Agenten abrufen und den kleinsten versionskorrelierten Optimierungsvorschlag erstellen.

• erstan-agent-review – Agent-Definitionen überprüfen und Runs anhand dauerhafter Beweise diagnostizieren.

• erstan-run-operator – veröffentlichte Agents starten und sicher mit Wartezeiten, Genehmigungen und Traces umgehen.

• erstan-skill-manager – vollständige, versionierte Erstan-Skill-Pakete verwalten.

• erstan-skill-optimizer – ein vollständiges Workspace-Skill-Paket abrufen und optimieren, ohne Geschäftsregeln, Dateien oder Aktionsmetadaten zu verlieren.

• erstan-work-manager – mit autorisierten Aufgaben, Projekten, Dokumenten, Ordnern und Dateien arbeiten.

Die konzeptionellen Operationen agent:optimize und skill:optimize sind als die Skills $erstan-agent-optimizer und $erstan-skill-optimizer verteilt. Sie sind keine npm-CLI-Befehle. Standardmäßig stoppen sie bei einem evidenzgestützten lokalen Vorschlag und Validierungsergebnis; Updates, Live-Agent-Vorschauen und Veröffentlichungen erfordern jeweils eine separate ausdrückliche Autorisierung.

Related MCP server: mcp-testing-tools

Berechtigungsmodell

Erstan ist die maßgebliche Quelle dafür, worauf die Verbindung zugreifen darf. Benutzer verwalten verbundene Apps, Workspace-Bereich, zulässige Tool-Familien, Projekt- oder Team-Allowlists und die Erstan-seitige Genehmigungsrichtlinie unter Einstellungen > Verbundene Apps.

Die Erstautorisierung verwendet standardmäßig das empfohlene Build-Profil. Es umfasst Agents anzeigen, Agents erstellen, Agents ausführen, Agents veröffentlichen sowie die schreibgeschützten Berechtigungen Runs anzeigen, Arbeiten anzeigen, Dokumente anzeigen und Dateien anzeigen. Es erlaubt keine Schreibvorgänge auf Aufgaben, Dokumente oder Dateien. Verwenden Sie Review für schreibgeschützten Zugriff. Für Schreibvorgänge verwenden Sie Custom mit der entsprechenden Berechtigung Manage work, Edit documents oder Edit files oder wählen Sie Full access.

Benutzer verwalten und widerrufen die Verbindung unter Settings > Connected apps. Eine Einschränkung der Zugriffe wirkt sich direkt aus. Das Erhöhen von Berechtigungen oder der Wechsel zu einem erweiterten Profil erfordert eine explizite OAuth-Neuauthorisierung, damit ein Hintergrundagent seine eigene Freigabe nicht erweitern kann.

Claude, Codex, ChatGPT oder ein anderer MCP-Host besitzt die lokale Verbindungssitzung und seine eigenen Bestätigungssteuerungen. Ein Host kann den Zugriff einschränken oder eine zusätzliche Bestätigung verlangen, aber er kann keine Berechtigungen erteilen, die Erstan verweigert hat. Das Widerrufen der Verbindung in Erstan macht sie für jeden Host ungültig, der sie verwendet.

Dieses zweischichtige Modell hält die Zugriffskontrolle klar:

1. Erstan entscheidet über die maximal autorisierten Daten und Aktionen.

2. Der KI-Host entscheidet, ob er eine Aktion innerhalb dieser Grenzen ausführt.

In Codex installieren

erstan-beta@erstan-beta bedeutet plugin-name@marketplace-name; es ist weder ein Konto-ID noch ein Geheimnis.

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

Öffnen Sie eine neue Codex-Sitzung, verwenden Sie /plugins, um die Installation zu bestätigen, verbinden Sie den erstan-beta-MCP-Server, wenn Sie dazu aufgefordert werden, und schließen Sie die Browser-Anmeldung ab. Das Plugin verwendet die Remote-Serverkonfiguration unter plugins/erstan-beta/.mcp.json.

In Claude installieren (Code)

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

Führen Sie /reload-plugins aus, dann /mcp, um erstan-beta zu verbinden und die OAuth-Autorisierung abzuschließen. Claude Code initiiert die Remote-MCP-Autorisierung; das Plugin fordert den Benutzer nicht auf, einen Bearer-Token oder API-Schlüssel einzufügen.

In Claude Cowork / Desktop installieren

Öffnen Sie Anpassen > Plugins > Plugins durchsuchen, wählen Sie Marktplatz hinzufügen und geben Sie Folgendes ein:

https://github.com/erstanai/erstan-agent-tools-beta

Installieren Sie Erstan Beta und schließen Sie die Browser-Anmeldung ab, wenn Sie dazu aufgefordert werden. Plugins sind in Claude Cowork und Claude Code verfügbar, nicht in der Desktop-App.

Aktualisieren oder entfernen

Verwenden Sie den Host, um Erstan Beta zu aktualisieren, zu deaktivieren oder zu deinstallieren. Das Widerrufen einer bestehenden Erstan-OAuth-Genehmigung über die Plugin-Verwaltung des Hosts entfernt das Plugin nicht automatisch. Überprüfen oder widerrufen Sie Genehmigungen unter Einstellungen > Verbundene Apps in Erstan.

Veröffentlichte Versionen und Assets sind auf der Release-Seite verfügbar.

Aktualisieren oder entfernen

Verwenden Sie die Host-Verwaltung, um Erstan Beta zu aktualisieren oder zu deinstallieren. Das Entfernen des Plugins widerruft nicht eine bereits erteilte Erstan-OAuth-Genehmigung. Verwalten Sie Genehmigungen unter Einstellungen > Verbundene Apps.

Veröffentlichte Versionen und Prüfsummen sind unter Releases verfügbar.

ChatGPT und andere Hosts

Das Beta-Plugin wird nicht im universellen ChatGPT- und Codex-Plugin-Marktplatz eingereicht. Es enthält keine .app.json-Datei, da eine solche nur mit einer registrierten plugin_asdk_app_...- oder asdk_app_...-Kennung erstellt werden darf, die bei der Veröffentlichung zugewiesen wird. Andere MCP-Clients können sich direkt verbinden über:

https://api-qa.erstan.com/v1/mcp

Der Server muss eine standardkonforme OAuth-Discovery und -Autorisierung bereitstellen. Es gibt keinen statischen Schlüssel oder API-Key.

Lokal testen

Voraussetzungen: Node.js 20 oder höher und Claude Code für den nativen Skill-Validator. Führen Sie den Skill-Validator einmal für jedes Verzeichnis unter skills aus. CI führt denselben Validator für jede Skill-Datei aus. Die nativen Codex- und Claude-Validatoren sind separate Veröffentlichungsschritte.

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

Aus der Produktion synchronisieren

Die Beta-Distribution wird aus einem überprüften Produktions-Checkout mit einer expliziten Identität und Endpoint-Zuordnung synchronisiert. Verwenden Sie:

npm run sync:production -- --source ../erstan-agent-tools

Der Befehl kopiert die neuesten überprüften Agents und Skills, aktualisiert Metadaten, behält die Plugin-Identität erstan-beta bei und schreibt die Endpoint-URL https://api-qa.erstan.com/v1/mcp neu. Der manuelle Workflow Sync production distribution führt dieselben Schritte aus und öffnet einen Pull Request. Er führt keine Veröffentlichung oder Zusammenführung der Beta-Version durch. Bestehen Sie --prerelease nur, wenn eine neue Vorabversion benötigt wird; die Version muss der Produktionsversion entsprechen.

Tool-Trennung

Dieses Repository ist die Endbenutzer-Distribution. Wartungs- und Veröffentlichungswerkzeuge befinden sich im separaten Repository erstanai/erstan-agent-tools. Enterprise-Kunden können die Veröffentlichung über einen privaten Kanal erhalten.

Lizenz

Apache License 2.0. Siehe LICENSE.