# Mit Claude Code an Elementen arbeiten

> **Zielgruppe & Rolle**
>
> **Rolle**: Mitarbeitende mit Zugriff auf Forge (Recht `tenant:forge:write` zum Schreiben); Administrierende (`identity:admin`) für Service-Konten | **Voraussetzung**: [Claude Code](https://claude.com/claude-code) ab Version 2.1.224 auf Ihrem Rechner

# Mit Claude Code an Elementen arbeiten

Claude Code kann einen Forge-Vorgang (zum Beispiel `APP-12`) lesen, einen Plan in die Abschnitte des Vorgangs schreiben, kommentieren, den Status
ändern und den Code dazu umsetzen. Dazu verbindet sich Claude Code über das Portal mit ConnectCLOUD – mit einer **Anmeldung**, ohne dass Sie
einen API-Schlüssel kopieren müssen. Claude arbeitet dabei **mit Ihren Rechten** und nur in dem Mandanten, den Sie bei der Anmeldung wählen.

## Einrichten

1. Öffnen Sie **Einstellungen › Anmeldung & Sicherheit** und den Abschnitt **Claude Code**.
2. Kopieren Sie die beiden Befehle in Ihr Terminal. Sie fügen das Plugin Ihres Portals als Marketplace hinzu und installieren es:

   ```bash
   claude plugin marketplace add https://<Ihr Portal>/claude/marketplace.json
   claude plugin install <Plugin-Name>@<Plugin-Name>
   ```

   Auf lokalen Adressen (`localhost`) akzeptiert Claude Code keine Archiv-Adressen; dort bietet der Abschnitt das Plugin als Download an,
   das Sie entpacken und mit `claude --plugin-dir <Ordner>` starten.
3. Beim ersten Gebrauch öffnet Claude Code den Browser. Auf der **Zustimmungsseite** sehen Sie, welche Anwendung zugreifen möchte, und
   bestätigen den Zugriff für Ihren Mandanten.

Das Plugin enthält den MCP-Server des Portals (`/mcp`) und die Fertigkeit **forge**.

## Einen Vorgang an Claude übergeben

Öffnen Sie den Vorgang und wählen Sie **Für Claude kopieren**. Die Zwischenablage enthält einen Auftrag mit Kennung, Titel, Link und
Mandant. Fügen Sie ihn in Claude Code ein (er beginnt mit dem Aufruf der Fertigkeit `forge`) und ergänzen Sie, was Claude tun soll.

Claude

- prüft, dass der Mandant der Anmeldung zum Vorgang passt (sonst bittet es Sie, sich neu zu verbinden),
- liest Vorgang, Kommentare, Verknüpfungen, Unteraufgaben, Projektkonfiguration und die verknüpften Branches und Pull Requests,
- schreibt Pläne in die Abschnitte **Plan**, **Akzeptanzkriterien** oder **Notizen für Agenten** (mit Versionsprüfung, ohne fremde Texte
  stillschweigend zu überschreiben),
- kommentiert und ändert Titel, Beschreibung, Status oder Schätzung,
- setzt den Code in Ihrem Repository um.

Änderungen laufen **direkt** unter Ihrem Namen und erscheinen im Verlauf des Vorgangs als Änderung durch eine Integration. Claude Code fragt
vor Schreibaktionen bei Ihnen nach, wie Sie es in Claude Code eingestellt haben. Prüfen Sie Pläne und Notizen, bevor Sie sie an weitere
Agenten übergeben.

> [!NOTE] Planungsagent
> Der [Planungsagent](/knowledge/docs/base/planungsagent-forge.md) im Vorgang ist etwas anderes: Er läuft im Portal auf Ihrem eigenen KI-Zugang und schlägt nur
> Entwürfe vor. Claude Code läuft auf Ihrem Rechner und schreibt direkt.

## Verbundene Anwendungen verwalten und widerrufen

Unter **Einstellungen › Anmeldung & Sicherheit › Verbundene Anwendungen** sehen Sie jede Anwendung, die in Ihrem Namen zugreifen darf.
**Entfernen** trennt sie sofort: Sie kann sich nicht mehr erneuern; ein bereits ausgestelltes Zugriffstoken gilt höchstens 15 Minuten
weiter. Verbinden Sie eine Anwendung erneut, ersetzt der neue Zugriff den alten. Wird Ihr Konto deaktiviert oder ändert sich Ihre E-Mail-Adresse,
werden Ihre Verbindungen automatisch getrennt. Ohne Nutzung läuft eine Verbindung nach 30 Tagen ab.

## Andere MCP-Clients

Jeder MCP-Client mit Unterstützung für OAuth (zum Beispiel Cursor oder ChatGPT) trägt die Adresse `https://<Ihr Portal>/mcp` als
Server vom Typ „Streamable HTTP“ ein und meldet sich selbst an; eine vorherige Registrierung ist nicht nötig. Clients ohne OAuth nutzen
einen [API-Schlüssel](/knowledge/docs/base/ki-assistenten-mcp.md) im Header `Authorization: Bearer cck_…`.

## Service-Konten

Administrierende (`identity:admin`) können auf der Zustimmungsseite statt für sich selbst für ein **Service-Konto** zustimmen. Die Anwendung
arbeitet dann mit den Rechten dieses Kontos und erscheint unter dessen Namen, zum Beispiel für einen gemeinsamen Coding-Agenten. Die Verbindungen
eines Service-Kontos sehen und entfernen Administrierende in dessen Detailansicht unter **Einstellungen › Anmeldung & Berechtigungen**.

> [!WARNING]
> Die Anwendung kann alles, was die gewählte Person oder das Service-Konto in ConnectCLOUD darf. Verbinden Sie nur Anwendungen, denen Sie
> vertrauen, und entfernen Sie Verbindungen, die Sie nicht mehr brauchen.
