Handbuch

Mit der Claude-Integration fügen Sie der Claude-Desktop-App (Windows, macOS) eine Erweiterung hinzu und steuern GeckoFlag im Gespräch mit Claude. Sie können Vorgänge, Projekte, Wiki-Seiten und Notizen suchen, anzeigen, erstellen und aktualisieren sowie Gantt-Diagramme als Excel-Datei exportieren. Die Erweiterung läuft auf dem PC des Benutzers und kommuniziert direkt und ausschließlich mit dessen GeckoFlag-Instanz. Alle Aktionen laufen mit den Benutzerrechten des Token-Inhabers.

Einstellungen für Administratoren

1. 1Öffnen Sie in der Seitenleiste Einstellungen und klicken Sie auf der Karte Claude-Integration auf Bearbeiten.
2. 2Aktivieren Sie Claude-Integration aktivieren (standardmäßig deaktiviert). Soll Claude auch anlegen und ändern dürfen, aktivieren Sie zusätzlich Schreiben erlauben und speichern Sie. Ohne Schreibberechtigung sind alle Token schreibgeschützt.
3. 3Öffnen Sie unter Benutzer beim gewünschten Benutzer Bearbeiten, aktivieren Sie Claude-Integration (API) erlauben und klicken Sie auf Aktualisieren. Diese Einstellung ist unabhängig von „KI-gestützte Erfassung erlauben“. Wird die Berechtigung entzogen, werden alle API-Token dieses Benutzers gelöscht.

API-Token erstellen

1. 1Öffnen Sie in der Seitenleiste Profil und legen Sie im Abschnitt API-Token Token-Name, Gültigkeit (30, 90 oder 365 Tage oder unbegrenzt; Standard: 90 Tage) und Berechtigung (Lesen oder Lesen und Schreiben) fest. Erstellen Sie dann den Token.
2. 2Kopieren Sie den angezeigten Token (eine Zeichenfolge, die mit gfk_ beginnt). Der Token wird nur einmal direkt nach der Erstellung angezeigt. Notieren Sie sich auch die im selben Abschnitt angezeigte „URL für die Erweiterung“.

• Jede Person kann bis zu 5 Token erstellen; nicht mehr benötigte Token lassen sich jederzeit im Profil löschen.
• Bei der Erstellung eines Tokens erhält der Inhaber eine Benachrichtigungs-E-Mail. Bei einer Passwortänderung werden alle Token dieser Person gelöscht.

Claude-Desktop-App einrichten

1. 1Öffnen Sie in der Claude-Desktop-App Settings (Einstellungen) → Extensions (Erweiterungen), ziehen Sie die GeckoFlag-Erweiterungsdatei (.mcpb) per Drag-and-drop hinein und klicken Sie auf Install (Installieren). Sie können die Datei auch doppelklicken oder über Advanced settings (Erweiterte Einstellungen) installieren. Die Erweiterungsdatei ist im Download enthalten, den Sie nach dem Kauf von GeckoFlag erhalten.
2. 2Füllen Sie im Einstellungsbildschirm die folgenden Felder aus und klicken Sie auf Save (Speichern).
   • GeckoFlag URL (Pflicht): Die notierte URL. https:// ist erforderlich (http:// nur für localhost, *.test und *.local).
   • API token (Pflicht): Der kopierte Token. Er wird maskiert gespeichert.
   • Export folder (optional): Speicherort für die Excel-Dateien der Gantt-Diagramme. Bleibt das Feld leer, wird im Ordner „Downloads“ gespeichert.
   
3. 3Bitten Sie Claude „Prüfe, ob die Verbindung zu GeckoFlag funktioniert“. Werden Token-Inhaber, GeckoFlag-Version und Schreibmöglichkeit angezeigt, ist die Einrichtung abgeschlossen.

Eine ausführliche Anleitung mit Screenshots finden Sie in der Einrichtungsanleitung der Claude-Integration. Wir empfehlen, Schreibaktionen in den Einstellungen der Claude-Erweiterung auf „Immer nachfragen“ zu stellen.

Funktionen

• Vorgänge: Suchen (nach Projekt, Status, Verantwortlichem, Ersteller, Priorität, Stichwort, Fälligkeit, übergeordnetem Vorgang), Details und Kommentare anzeigen, anlegen (auch mit übergeordnetem Vorgang und zu benachrichtigenden Personen), Felder ändern, Kommentare schreiben, Status ändern.
• Projekte: Liste und Details anzeigen, anlegen (alle außer Gästen), Name, Beschreibung, Eigentümer und Zeitraum ändern, zwischen abgeschlossen und offen wechseln, Mitglieder hinzufügen und entfernen (Eigentümer und Administratoren).
• Wiki: Anzeigen, Titel und Text neu schreiben, am Ende ergänzen (Projektmitglieder und Administratoren).
• Notizen: Eigene Notizen auflisten, durchsuchen, anzeigen, erstellen, neu schreiben und ergänzen.
• Stammdaten: Vorgangstypen, Status, Prioritäten und Positionen (Abteilungen) hinzufügen sowie Namen und Farben ändern (Administratoren).
• Gantt-Diagramm: Die Vorgänge eines Projekts (bis zu 5.000) als Excel-Datei auf dem PC speichern. Bei mehr als 120 Tagen gilt 1 Spalte = 1 Woche.
• Benutzersuche: Benutzer nach Namen suchen (nur ID und Rolle; E-Mail-Adressen werden nicht zurückgegeben).

Vorgänge lassen sich über Schlüssel wie „WEB-12“ ansprechen. Zum Schreiben sind sowohl ein Token mit „Lesen und Schreiben“ als auch „Schreiben erlauben“ für die Website erforderlich.