Agenten

Einen KI-Agenten mit Levee verbinden

Ein KI-Agent kann in Levee mit dir zusammenarbeiten: Claude Code oder jeder andere Agent, der das Model Context Protocol (kurz MCP) unterstützt. Beschreibe in eigenen Worten, was du möchtest, zum Beispiel „Mach die Überschrift auf dem Hero-Board doppelt so groß“, und sieh zu, wie es auf deiner Arbeitsfläche passiert. Verbunden ist der Agent mit einer einzigen Zeile im Terminal.

Bevor du loslegst

Du brauchst Levee auf deinem Rechner. Die Anleitungen für Linux und macOS zeigen dir, wie. Der MCP-Server ist Teil von Levee, du musst also nichts zusätzlich herunterladen. Außerdem brauchst du einen Agenten, den du verbindest. Die Schritte unten nutzen Claude Code, und jeder andere MCP-Host funktioniert genauso.

Dein System

Bei Claude Code registrieren

Linux

claude mcp add --scope user levee -- flatpak run --command=levee-mcp com.deichrakete.Levee//beta

Alles nach dem -- startet den Server: Flatpak führt levee-mcp aus der Installation von Levee aus.

Das //beta am Ende ist der Name, den Flatpak der Beta gibt. Aktuell ist sie die einzige Version.

macOS

claude mcp add --scope user levee -- /Applications/Levee.app/Contents/MacOS/levee-mcp

Alles nach dem -- startet den Server. levee-mcp steckt in der App, und der Agent ruft es über den vollständigen Pfad auf.

Das ist schon die ganze Einrichtung. Mit --scope user steht Levee in Claude Code in jedem Projekt bereit, nicht nur in dem Ordner, in dem du die Zeile eingegeben hast.

Prüfen, ob es funktioniert

claude mcp list

Levee sollte in der Liste stehen und als verbunden markiert sein. Innerhalb einer Claude-Code-Sitzung zeigt /mcp dasselbe.

Probiere es jetzt aus. Öffne ein Dokument in Levee, starte Claude Code und frage nach dem, was du geöffnet hast. „Was ist in meinem Levee-Dokument?“ ist eine gute erste Frage. Solange der Agent arbeitet, erscheint oben rechts in der Kopfleiste von Levee ein kleiner Roboter-Avatar. Zehn Sekunden nach dem letzten Schritt verschwindet er wieder.

Was der Agent kann

  • Sehen, welche Dokumente du geöffnet hast, und jedes davon lesen.
  • Sie ändern. Er kann dieselben Eigenschaften bearbeiten wie du im Inspector, von einer einzelnen Farbe bis zu einem neuen Board, dazu Design-Tokens und Komponenten.
  • Ebenen gruppieren und die Gruppe wieder auflösen.
  • Bilder und SVG-Zeichnungen hinzufügen, aus einer Datei auf deiner Festplatte oder von einer Webadresse.
  • Die Kommentare eines Cloud-Dokuments lesen, mit der Ebene unter jeder Markierung. So kannst du ihn bitten, das Feedback abzuarbeiten.
  • Seine Arbeit prüfen. Er kann ein Board rendern und sich das Bild ansehen, statt zu raten.

Jede Gruppe von Änderungen ist ein Schritt in deinem Verlauf. Gefällt dir das Ergebnis nicht, machst du mit Strg+Z (⌘+Z auf dem Mac) alles auf einmal rückgängig.

Mit offenem Levee oder ohne

Meist arbeitet der Agent im laufenden Levee. Änderungen erscheinen sofort auf der Arbeitsfläche, er kann sich auf deine Auswahl beziehen, und du siehst zu. Läuft Levee nicht, öffnet der Agent eine .levee-Datei über ihren Pfad, ändert sie und rendert sie. Findet er weder ein laufendes Levee noch eine Datei, sagt er dir das.

Andere Agenten

Du brauchst Claude Code nicht zwingend. Jeder Agent, der einen lokalen MCP-Server starten kann, funktioniert und braucht nur den Startbefehl. Viele erwarten ihn in einer Einstellungsdatei. Dort sieht der Eintrag für Levee so aus:

Linux

{ "command": "flatpak", "args": ["run", "--command=levee-mcp", "com.deichrakete.Levee//beta"] }

macOS

{ "command": "/Applications/Levee.app/Contents/MacOS/levee-mcp" }

Optionen oder Umgebungsvariablen gibt es keine. Der Server findet das laufende Levee automatisch.

Gut zu wissen

Der Server läuft mit deinen Rechten und hat kein eigenes Passwort. Er kann mit deinen Dokumenten tun, was du kannst, und du behältst ihn im Levee-Fenster im Blick. Er ist nur mit dem Agenten verbunden, der ihn gestartet hat, und nimmt keine Verbindungen aus dem Netzwerk an.

Die Verbindung trennen

Auch das Trennen der Verbindung ist eine einzige Zeile:

claude mcp remove levee

Levee selbst bleibt, wie es ist. Nur die Verbindung verschwindet.

Etwas funktioniert nicht?

claude mcp list meldet Failed to connect.
Claude Code konnte den Server nicht starten. Prüfe, ob Levee installiert ist: flatpak run com.deichrakete.Levee//beta im Terminal sollte es öffnen. Prüf, ob Levee unter diesem Namen in deinem Programme-Ordner liegt.
Der Agent sagt Levee is not running.
Öffne das Dokument zuerst in Levee. Oder gib dem Agenten den Pfad der Datei, dann arbeitet er direkt daran.
Der Agent hat etwas geändert, das ich nicht wollte.
Drücke Strg+Z (⌘+Z auf dem Mac) in Levee. Das macht alles aus dieser Anfrage auf einmal rückgängig.
Du kommst nicht weiter?
Weitere Antworten findest du auf der Support-Seite. Oder schreib an levee@deichrakete.com, welchen Agenten du nutzt und was er ausgegeben hat. Wir helfen dir weiter.