KI-Agenten

Verbinden Sie Ihren KI-Agenten mit einem Projekt in der LAY7 cloud. Der Agent kann dann Ressourcen ansehen, anlegen und ändern, zum Beispiel eine Datenbank erstellen, eine Domain mit einer Anwendung verbinden oder den Status Ihrer Backups prüfen. Sie bestimmen, was er darf, und sehen jede seiner Aktionen.

Die Verbindung nutzt das Model Context Protocol (MCP). Unterstützt werden unter anderem:

• Claude und Claude Code
• ChatGPT
• Cursor
• VS Code
• eigene Agenten, etwa mit einem Agent-SDK oder in einer CI-Pipeline

Eine Verbindung, ein Projekt

Jede Verbindung gehört zu genau einem Projekt und hat eine eigene MCP-URL. Der Agent sieht nur die Ressourcen dieses Projekts. Andere Projekte, Ihr Konto, Rechnungen, Zahlungsmittel und API-Tokens bleiben für ihn gesperrt.

Sollen mehrere Projekte erreichbar sein, legen Sie pro Projekt eine Verbindung an. Im KI-Client erscheint jedes Projekt dann als eigener Connector.

Agent verbinden

1. Wählen Sie oben das Projekt aus
2. Öffnen Sie KI-Agenten → Agent verbinden
3. Wählen Sie Ihren Agenten aus
4. Folgen Sie der Anleitung für Ihren Agenten

Für Claude, ChatGPT, Claude Code, Cursor und VS Code melden Sie sich im Agenten bei der LAY7 cloud an. Danach legen Sie fest, was der Agent darf, und bestätigen mit Zugriff erlauben.

Claude

1. Fügen Sie in Claude unter claude.ai/customize/connectors einen benutzerdefinierten Connector hinzu
2. Tragen Sie den angezeigten Namen und die MCP-URL ein
3. Wählen Sie als OAuth-Client die automatische Registrierung und fügen Sie den Connector hinzu
4. Melden Sie sich an und legen Sie die Berechtigungen fest

In Team- und Enterprise-Organisationen fügt ein Owner den Connector in den Organisationseinstellungen hinzu. Mitglieder verbinden ihn danach unter claude.ai/customize/connectors.

ChatGPT

1. Fügen Sie in ChatGPT unter chatgpt.com/plugins einen eigenen MCP-Server hinzu
2. Tragen Sie den angezeigten Namen und die MCP-URL ein
3. Bestätigen Sie den Hinweis und legen Sie den Server als Plugin an
4. Melden Sie sich an und legen Sie die Berechtigungen fest

Claude Code

Führen Sie den angezeigten Befehl im Verzeichnis Ihres Projekts aus, zum Beispiel:

claude mcp add --transport http lay7-mein-shop https://mcp.lay7.cloud/p/12345

Öffnen Sie anschließend in Claude Code /mcp, melden Sie sich an und legen Sie die Berechtigungen fest.

Cursor und VS Code

Tragen Sie die angezeigte Konfiguration in .cursor/mcp.json bzw. .vscode/mcp.json ein. In VS Code starten Sie den Server anschließend in der mcp.json. Beim ersten Zugriff melden Sie sich an und legen die Berechtigungen fest.

Eigener Agent per Token

Für Agenten ohne Anmeldung, zum Beispiel Agent-SDKs oder CI-Pipelines, erstellen Sie einen Token:

1. Wählen Sie Eigener Agent
2. Vergeben Sie einen Namen und wählen Sie, wann der Token abläuft
3. Legen Sie die Berechtigungen fest und klicken Sie auf Token erstellen
4. Kopieren Sie den Token oder die fertige Konfiguration

Der Token wird nur einmal angezeigt. Bewahren Sie ihn wie ein Passwort auf. Der Agent sendet ihn als Authorization: Bearer … an die MCP-URL.

Berechtigungen

Beim Verbinden wählen Sie eine Vorlage:

Mit Benutzerdefiniert stellen Sie den Zugriff pro Ressource ein, etwa für Datenbanken, Domains oder Backups: Kein Zugriff, Lesen oder Ändern. Für Kritische Aktionen wählen Sie jeweils Erlaubt, Mit Freigabe oder Gesperrt:

• Destruktive Aktionen – zum Beispiel Ressourcen löschen, Backups wiederherstellen, Passwörter und Keys rotieren oder Befehle in einem Container ausführen
• Bestellungen – Domains registrieren oder transferieren, Paket wechseln. Bestellungen sind nie ohne Ihre Freigabe möglich, hier gibt es nur Mit Freigabe oder Gesperrt
• Domain-Kontakte – Namen und Adressen der Domaininhaber in Ihrem Konto. Mit Suche mit Freigabe findet der Agent einen Kontakt nur über eine Suche, die Sie freigeben

Die Berechtigungen einer Verbindung ändern Sie jederzeit unter KI-Agenten → Verbindungen → Verbindung → Berechtigungen → Bearbeiten. Sie gelten ab der nächsten Ausführung.

Secrets

Alles, was der Agent liest, geht an den Anbieter Ihres KI-Agenten. Passwörter und Zugangsdaten, etwa von Datenbanken und Caches, sowie Variablen und Secrets von Containern sieht der Agent deshalb standardmäßig nur maskiert. Umgebungsvariablen einer Anwendung, die Sie als Secret markiert haben, gibt die LAY7 cloud grundsätzlich nicht aus.

Braucht der Agent die Werte trotzdem, aktivieren Sie unter Benutzerdefiniert die Option Secrets im Klartext zeigen.

Freigaben

Ist eine Aktion freigabepflichtig, führt die LAY7 cloud sie nicht sofort aus. Der Agent erhält stattdessen eine kurze Zusammenfassung und einen Link zur Freigabe, zum Beispiel „Datenbank shop-prod löschen“.

1. Öffnen Sie den Link oder KI-Agenten → Aktivität. Offene Anfragen stehen dort oben unter Wartet auf Ihre Freigabe
2. Prüfen Sie die Anfrage: Zusammenfassung, betroffene Ressource, die genauen Daten des Requests und bei Bestellungen den Preis
3. Klicken Sie auf Freigeben und ausführen oder Ablehnen

Freigegeben wird genau diese eine Anfrage. Der Agent kann sie nachträglich nicht verändern. Offene Freigaben verfallen nach 15 Minuten. Bei Bestellungen gilt der Preis, den Sie freigegeben haben.

Zahlen Sie nicht auf Rechnung, wartet eine freigegebene Bestellung auf Ihre Zahlung. Klicken Sie dafür in der Freigabe auf Jetzt bezahlen. Erst danach wird sie ausgeführt.

Aktivität verfolgen

Unter KI-Agenten → Aktivität sehen Sie jede Ausführung Ihrer Agenten:

• den Code, den der Agent ausgeführt hat
• jeden einzelnen Request mit Methode, Pfad und Status
• das Ergebnis oder den Fehler

Über den Filter grenzen Sie den Verlauf auf einen Status oder eine Verbindung ein. Die Aktivität einer einzelnen Verbindung finden Sie auch auf ihrer Detailseite.

Warteschlange

Kann eine Ausführung nicht sofort starten, etwa in einem neuen Projekt, kommt sie in die Warteschlange und startet automatisch, sobald es möglich ist. Der Agent holt das Ergebnis später selbst ab. Solange eine Ausführung In Warteschlange steht, können Sie sie in der Aktivität abbrechen.

Pro Verbindung warten höchstens 5 Ausführungen. Startet eine Ausführung nicht innerhalb von 30 Minuten, verfällt sie.

Verbindung widerrufen

Öffnen Sie KI-Agenten → Verbindungen, wählen Sie die Verbindung und klicken Sie auf Widerrufen. Der Agent verliert sofort den Zugriff auf das Projekt, Ausführungen in der Warteschlange werden verworfen.

Verbindungen mit Ablaufdatum enden automatisch. Möchten Sie einen Agenten danach weiter nutzen, verbinden Sie ihn erneut.

Sicherheit

• Jede Aktion des Agenten ist ein regulärer Request an die API der LAY7 cloud und wird dort geprüft und protokolliert.
• Der Code des Agenten läuft in einer abgeschotteten Umgebung, die ausschließlich die API der LAY7 cloud erreicht. Dauerhafte Zugangsdaten liegen dort nicht, jede Ausführung erhält einen eigenen Zugang, der danach verfällt.
• Ein KI-Agent kann sich durch manipulierte Inhalte, etwa in einer Webseite oder einem Dokument, zu ungewollten Aktionen verleiten lassen. Wählen Sie deshalb nur so viele Berechtigungen wie nötig und lassen Sie destruktive Aktionen freigeben.

Limits

• 30 Sekunden Laufzeit pro Ausführung
• 50 Requests pro Ausführung, davon 6 gleichzeitig
• 60 Aufrufe pro Minute und Verbindung

Für Entwickler

Der MCP-Server stellt dem Agenten vier Tools bereit:

Statt eines Tools pro Endpunkt schreibt der Agent kurzen Code gegen die reguläre API der LAY7 cloud. So erledigt er auch Aufgaben mit vielen Schritten in einer Ausführung:

const { data: dbs } = await lay7.get('/databases');
const runs = await Promise.all(
    dbs.map((db) => lay7.get(`/databases/${db.id}/backup-runs`))
);
return dbs.map((db, i) => ({
    name: db.name,
    lastBackup: runs[i].data[0]?.finished_at ?? null,
}));

• Verfügbar sind lay7.get(path, query), lay7.post/put/patch/delete(path, body), sleep(ms) und console.log. Pfade sind relativ, das Projekt wird automatisch gesetzt.
• Fehlgeschlagene Requests werfen Lay7ApiError mit status und errors.
• Freigabepflichtige Requests werfen Lay7ApprovalRequired mit approval.summary und approval.url.
• Der Rückgabewert kommt als JSON zurück, zusammen mit der Konsolenausgabe und der Liste der Requests.