Einen Agenten deinen Arbeitsbereich sicher nutzen lassen

Echolot ist ein MCP-Server für deinen Arbeitsbereich: Ein KI-Agent wie Claude Code kann deine Anfragen auflisten, senden und die Antworten lesen. Du bestimmst, was er ohne Nachfrage darf, wofür er fragen muss und was er nie darf. Geheime Werte erreichen ihn nie. In diesem Tutorial verbindest du Claude Code mit Alpenglow, genehmigst und verweigerst seine Sendungen, schützt eine Umgebung und machst dann dasselbe mit Echolots eingebautem Assistenten.

• Dauer: 20 Minuten.
• Du brauchst: den Arbeitsbereich Alpenglow und einen MCP-Client: Claude Code (claude im Terminal), Claude Desktop, Cursor, VS Code oder Codex. Für den letzten Teil einen API-Schlüssel für einen Modellanbieter oder ein lokales Modell in Ollama.
• Du lernst: Einstellungen › Agenten, Genehmigungen, die Agentenregeln des Arbeitsbereichs, geschützte Umgebungen und was Agenten statt Secrets sehen.

1. Agenten einschaltenCopy Anchor Link

1. Wähle Echolot › Einstellungen … (⌘,) und öffne Agenten.
2. Schalte unter Zugriff Agenten geöffnete Arbeitsbereiche nutzen lassen ein.
3. Lass unter Tools für Agenten Anfragen und Flows an. Anfragen lässt einen Agenten Anfragen auflisten, lesen, anlegen und senden; Flows führt die Flows aus, die du Agenten anbietest. Die anderen (Arbeitsbereich, Umgebungen, Specs, Mocks, MCP-Server, Verlauf, Flows bearbeiten) sind aus, bis du sie einschaltest.

Einige Tools werden nie angeboten, egal was du einschaltest: die Richtlinie selbst, Proxys, Zertifikate, Auth-Einstellungen, Skripte und das Starten von Flows, die du nicht angeboten hast.

2. Claude Code verbindenCopy Anchor Link

1. Wähle im Fenster von Alpenglow oben auf der Seite Agenten.

2. Suche unter Client verbinden Claude Code und wähle Befehl kopieren. Der Befehl sieht so aus:

   Text kopieren

   claude mcp add --scope user echolot-alpenglow -- /Applications/Echolot.app/Contents/Helpers/echolot mcp serve /Users/you/Projects/Alpenglow.echolot

3. Füge ihn ins Terminal ein und führe ihn aus.

Die anderen Clients haben einen eigenen Knopf: Zu Cursor hinzufügen und Zu VS Code hinzufügen öffnen einen Installationslink, config.toml-Eintrag kopieren ist für Codex, JSON kopieren gibt einen mcpServers-Block für jeden anderen Client, und Zu Claude hinzufügen von Claude Desktop installiert eine Erweiterung. Jeder Client führt echolot mcp serve aus, das seine Aufrufe an das geöffnete Fenster übergibt, sodass deine Genehmigungen und die Umgebung des Fensters gelten.

3. Lesen und senden lassenCopy Anchor Link

1. Starte claude im Terminal und frage:

   Using echolot-alpenglow, list the requests in the Catalog folder, send List products, and tell me the most expensive tent in stock.

2. Er listet die Anfragen auf und sendet List products, ohne dich zu fragen: Standardmäßig darf ein Agent den Arbeitsbereich lesen und sichere Anfragen senden (GET, GraphQL-Queries, MCP-Lesezugriffe).

3. In Echolot steht auf dem Knopf Agenten jetzt Agenten · 1. Sein Popover listet den Client unter Letzte Aufrufe, mit einem Schalter Erlaubt, um ihn abzuschneiden.

Die Sendungen des Agenten werden im Verlauf aufgezeichnet, mit dem Absender (⌘Y).

4. Eine Sendung genehmigen, die Daten ändertCopy Anchor Link

1. Frage:

   Place an order for one TNT-MH-2P with Create order.

2. Echolot zeigt ein Blatt: Claude Code möchte eine Anfrage senden, die Daten ändern kann, mit der Anfrage und einer Vorschau dessen, was hinausgeht. Der Header Authorization erscheint als Bearer ••••••.

3. Wähle eines:

   • Einmal erlauben (↩): nur diese Sendung.
   • Für diese Sitzung erlauben: Sendungen wie diese, bis das Fenster geschlossen wird.
   • Ablehnen (Esc): Dem Agenten wird gesagt, dass du verweigert hast.

4. Wähle Einmal erlauben. Der Shop antwortet mit 201 Created, und der Agent meldet die neue Bestellung.

5. Secrets außer Reichweite haltenCopy Anchor Link

Frage den Agenten:

What is the value of the token variable?

Er kann es dir nicht sagen. Der Wert einer geheimen Variablen erreicht einen Agenten nie: Wo er auftauchen würde, in einer Anfrage, einer Antwort oder einem Fehler, sieht der Agent ••••••. Das gilt für den Wert, wie er geschrieben ist, und in seinen JSON-, Prozent- und Base64-Formen. Auch Suchen durch Antwort-Bodys zählen oder platzieren nie einen Treffer auf einem Secret.

6. Die Regeln des Arbeitsbereichs festlegenCopy Anchor Link

Die Standards sind ein Ausgangspunkt. Jeder Arbeitsbereich kann eigene Regeln festlegen, und sie landen in workspace.toml, reisen also mit dem Arbeitsbereich durch Git.

1. Öffne das Menü des Arbeitsbereichs am Fuß der Seitenleiste und wähle Arbeitsbereichseinstellungen …, dann den Tab Agenten.
2. Agenten dürfen diesen Arbeitsbereich nutzen schaltet Agenten nur für diesen Arbeitsbereich aus.
3. Unter Was Agenten dürfen hat jede Art von Aktion Erlauben, Fragen oder Verweigern (oder Standard): Anfragen und Umgebungen lesen, Sichere Anfragen (GET, GraphQL-Queries, MCP-Lesezugriffe), Andere Anfragen, Anfragen an geschützte Umgebungen, Anfragen an neue Hosts, Änderungen am Arbeitsbereich und Löschen. Setze Andere Anfragen auf Verweigern.
4. Liste unter Hosts und Limits die Erlaubten Hosts auf und setze Anfragen pro Sitzung oder Anfragen pro Minute.
5. Wähle Fertig und bitte den Agenten, eine weitere Bestellung aufzugeben. Sie wird ohne Blatt verweigert.

Eine Regel, die strenger ist als der Standard, gilt sofort. Eine Regel, die etwas ohne Nachfrage erlauben würde, etwa in einem Arbeitsbereich, den du aus Git geholt hast, wartet auf dich: Das Popover Agenten sagt, was sie erlauben würde, Agenten fragen weiter, bis du den Regeln vertraust, und Diesen Regeln vertrauen akzeptiert sie auf diesem Mac.

Anfragen an geschützte Umgebungen und Anfragen an neue Hosts bieten nur Fragen oder Verweigern: Keine Regel lässt einen Agenten dort ungefragt senden. Eine Weiterleitung bei der Sendung eines Agenten trägt nie einen geheimen Header zu einem Host, den der Arbeitsbereich nicht kennt.

7. Eine Umgebung schützenCopy Anchor Link

1. Wähle im Umgebungsmenü des Seitenkopfs Production. Sie ist geschützt, daher ist sie rot mit einem Schloss markiert.
2. Bitte den Agenten, List products erneut zu senden. Das Blatt sagt Claude Code möchte an eine geschützte Umgebung senden, und ↩ bewirkt darauf nichts: Du musst wählen. Wähle Ablehnen. (Production in Alpenglow ist eine fiktive Adresse, die Sendung würde also ohnehin fehlschlagen.)
3. Sende List products selbst. Der Knopf zeigt An Production senden …, und ein Hinweis fragt An Production senden?. Abbrechen ist die Vorgabe; Nicht mehr fragen, bis ich die Umgebung wechsle stoppt die Fragen, bis du eine andere Umgebung wählst. Wähle Abbrechen.
4. Wechsle zurück zu Keine Umgebung.

Markiere eine Umgebung als geschützt mit dem Schalter Geschützt auf der Seite „Umgebungen“. Siehe Geschützte Umgebungen.

8. Ohne die App: RichtlinienCopy Anchor Link

echolot mcp serve läuft auch allein, für einen Agenten auf einem Server oder in CI, wo niemand etwas genehmigen kann. Dort entscheidet die Richtlinie, und alles, was fragen würde, wird verweigert:

echolot mcp serve Alpenglow.echolot --policy readonly

Ohne App läuft nur, was der Arbeitsbereich beim Start an Skripten hatte. Mehr unter Agenten und echolot mcp.

9. Der eingebaute AssistentCopy Anchor Link

Echolots eigener Assistent arbeitet über dieselben Tools und dieselben Genehmigungen, in einem Panel neben jeder Seite.

1. Wähle Echolot › Einstellungen … › Assistent. Wähle unter Anbieter hinzufügen einen Anbieter (Anthropic, OpenAI, Google Gemini oder einen OpenAI-kompatiblen Server wie Ollama), gib den API-Schlüssel oder die Adresse ein und wähle Hinzufügen. Schlüssel liegen im Schlüsselbund.
2. Drücke im Fenster von Alpenglow ⌘J (oder wähle den Zauberstab am Ende des Seitenkopfs).
3. Tippe in Frag den Assistenten …: Send every request in Catalog and tell me which checks fail.
4. Bevor zum ersten Mal etwas aus dem Arbeitsbereich an einen Anbieter geht, fragt Echolot An Anthropic senden? (oder den Anbieter, den du gewählt hast). Abbrechen ist die Vorgabe; wähle Erlauben. Es fragt einmal pro Anbieter, und Einstellungen › Assistent kann es zurücknehmen. Modelle auf deinem Mac oder auf einem lokalen Server fragen nie.
5. Seine Sendungen laufen über dasselbe Blatt, das Der Agent möchte … zeigt.

Was das Modell sieht im Kopf des Panels zeigt genau, was an das Modell gesendet wurde. Siehe Der Assistent.

Nächste SchritteCopy Anchor Link

• Agenten: alle Einstellungen, Tool-Sets und andere Clients.
• Mit einem Flow automatisieren: Biete Agenten einen Flow als ein Tool an, mit einem Approve-Block, der einen Menschen fragt.
• Datenschutz und Sicherheit: was deinen Mac verlässt und wann.