Werkzeuge bauen

Den Arbeitsplatz einrichten

Ein Befehl klont das Repository der Werkzeuge und meldet deine Instanz beim Agenten an.

Der Arbeitsplatz ist ein Verzeichnis auf deinem Rechner: ein Klon des Repositorys, in dem die Werkzeuge deiner Instanz liegen, und daneben die Anmeldung für deinen Agenten. Du brauchst git, curl und ein Zugriffstoken.

Mit einem Befehl einrichten

Nach dem Ausstellen zeigt die Seite Zugriffstoken den Kasten Nur einmal sichtbar. Darin steht unter Arbeitskopie einrichten ein fertiger Befehl, der dein Token schon enthält:

 FLOW_TOKEN=flowpac_pat_... sh -c 'curl -fsSL https://<instanz>/setup.sh | sh'

Kopiere ihn und führe ihn in dem Verzeichnis aus, in dem der Arbeitsplatz entstehen soll. Das Token steht in der Umgebung des Befehls, nie in einer Adresse. Was in einer Adresse steht, landet in den Protokollen jedes Servers auf dem Weg.

Das Skript enthält kein Geheimnis. Du kannst es vor dem Ausführen lesen:

curl -fsSL https://<instanz>/setup.sh -o setup.sh && less setup.sh && sh setup.sh

Ohne FLOW_TOKEN fragt das Skript im Terminal nach dem Token.

Was dabei entsteht

Das Skript legt das Verzeichnis flow-tools an. Einen anderen Namen gibst du als Argument mit (sh setup.sh <verzeichnis>).

Der Klon steht auf dem Zweig draft. Ein git push geht damit in den Entwurf.

Den Agenten neu starten

Starte Claude Code im neuen Verzeichnis neu. Eine laufende Sitzung liest .mcp.json nicht nach. Danach erreicht der Agent die Instanz. Wie du mit ihm arbeitest, steht unter Mit dem Agenten arbeiten.

Von Hand einrichten

Wenn du dein Verzeichnis selbst einrichtest, klonst du nur. Den Befehl mit deinem Token zeigt derselbe Kasten unter Oder nur klonen:

git clone https://flow:<token>@<instanz>/git/tools
cd tools
git switch draft || git switch -c draft

Der Benutzername ist beliebig, das Passwort ist das Token. Gibt es den Zweig draft noch nicht, legt der zweite Befehl ihn an.

Für den Agenten legst du .mcp.json selbst an. Der Kasten zeigt den Eintrag in zwei Fassungen: Eintrag für .mcp.json liest das Token aus der Umgebungsvariablen FLOW_TOKEN, … oder mit dem Token darin enthält es direkt.

{
  "mcpServers": {
    "flow-backend": {
      "type": "http",
      "url": "https://<instanz>/mcp",
      "headers": { "Authorization": "Bearer ${FLOW_TOKEN}" }
    }
  }
}

Mit der Umgebungsvariablen steht das Token in keiner Projektdatei. Trage .mcp.json trotzdem nie in ein Repository ein, wenn das Token darin steht.

Wenn das Token abläuft

Stelle ein neues Token aus und ersetze es in .env, in .mcp.json und in der Adresse des Klons (git remote set-url origin ...). Widerrufe das alte Token in der Liste Deine Token.