Kurskapitel
Schulung · Reihe 5. Teams und Administration · Kapitel 5.4 von 6
5.4 API-Token und Claude verbinden 2:39
Persönliche Zugriffstoken, Claude mit OAuth verbinden und prüfen, was es vorschlägt.
Zeigt Holarch 1.7.
Das lernen Sie
- Ein persönliches Zugriffstoken mit eingeschränktem Zugriff, Projekten und Ablaufdatum erstellen
- Claude mit Anmeldung auf dem Zustimmungsbildschirm mit Holarch verbinden
- Einen Vorschlag eines KI-Clients prüfen und nur die gewünschten Änderungen anwenden
- Ein Token widerrufen und eine App trennen
Lassen Sie Skripte und KI-Werkzeuge sicher mit Ihren Projekten arbeiten: ein persönliches Zugriffstoken mit Umfang, Projekten und Ablaufdatum erstellen; Claude mit OAuth auf dem Zustimmungsbildschirm verbinden; verbundene Apps verwalten; einen Vorschlag eines KI-Clients prüfen und anwenden; und der API-Schalter der Organisation.
Projektdateien
- Startprojekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)
Das Video wird von holarch.app abgespielt; siehe Datenschutzerklärung.
Übung
Führen Sie dies selbst in Holarch durch, am Demoprojekt CubeSat EO-1.
- Öffnen Sie Kontoeinstellungen → API-Token. Nennen Sie es unter Neues Token
EO-1 report, wählen Sie Nur lesen, 30 Tage und Ausgewählte Projekte mit aktiviertem EO-1 und klicken Sie auf Token erstellen; kopieren Sie das Token. - Führen Sie das
curl-Beispiel aus Token erstellt aus, um Ihre Projekte aufzulisten, und prüfen Sie, dass nur EO-1 zurückkommt. - Klicken Sie auf KI-App verbinden…, wählen Sie Claude und folgen Sie den Schritten. Wählen Sie unter Claude mit Holarch verbinden Lesen und Änderungen vorschlagen, Gewählte Projekte mit EO-1 und ein Ende nach 30 Tagen und klicken Sie dann auf Zulassen.
- Fragen Sie in Claude:
Propose a test case in EO-1 that verifies requirement 2.4 Target Slew. - Öffnen Sie EO-1, wählen Sie ✦ KI ▾ → „…“ prüfen…, deaktivieren Sie alles, was Sie nicht wollen, und klicken Sie auf Auswahl anwenden.
- Klicken Sie zurück in API-Token bei
EO-1 reportauf Widerrufen und unter Verbundene Apps auf Trennen, wenn Sie Claude nicht verbunden brauchen.
Sie sind fertig, wenn EO-1 den neuen Testfall aus dem Vorschlag hat und das Token aus Ihrer Liste verschwunden ist.
Selbsttest
- Wann verwenden Sie ein Token und wann eine verbundene App?
- Sie sind Reviewer in einem Projekt und verwenden ein Token mit Lese- und Schreibzugriff. Kann ein Skript dieses Projekt ändern?
- Claude schlägt fünf Änderungen vor. Was hat sich im Projekt geändert?
- Wie sperren Sie alle Token und Apps auf einmal?
Antworten anzeigen
Wann verwenden Sie ein Token und wann eine verbundene App?
Ein Token ist für Skripte und Clients, die einen festen Header senden; es wird einmal angezeigt, und Sie speichern es. Eine verbundene App meldet sich ohne eingefügtes Token auf dem Zustimmungsbildschirm von Holarch an, endet nach höchstens einem Jahr und wird unter „Verbundene Apps“ aufgeführt.
Sie sind Reviewer in einem Projekt und verwenden ein Token mit Lese- und Schreibzugriff. Kann ein Skript dieses Projekt ändern?
Nein. Ein Token handelt als Sie, innerhalb Ihrer Rolle in jedem Projekt, daher liest ein Reviewer oder Betrachter nur.
Claude schlägt fünf Änderungen vor. Was hat sich im Projekt geändert?
Noch nichts. Die Änderungen warten als Vorschlag; Sie prüfen sie, deaktivieren, was Sie nicht wollen, und „Auswahl anwenden“ macht den Rest zu einem Rückgängig-Schritt. Löschungen und Änderungen an genehmigten oder in Baselines aufgenommenen Elementen beginnen deaktiviert.
Wie sperren Sie alle Token und Apps auf einmal?
„Überall abmelden“ oder ein Zurücksetzen des Passworts trennt jede verbundene App und widerruft jedes Token. Ein Organisationsadmin kann außerdem den API- und MCP-Zugriff für die Projekte der Organisation ausschalten.
Weiterlesen
Transkript
Transkript anzeigen (Erzählung und Bildschirminhalt)
Introduction
Chapter four: API tokens and connecting Claude. Holarch has an API for scripts and reports, and an MCP endpoint that lets AI tools such as Claude work with your model.
Personal access tokens
Whatever connects, the same rules apply.
On screen: Rules card.
API tokens come with the Individual and Team plans. For a script, create a personal access token: in Account Settings, open AI and API, give the token a name, choose Read only, an expiry of ninety days, and create it.
On screen: API tokens → name → Read only → 90 days → Create Token.
The token is shown once. Copy it now, and store it where your script can read it. Holarch keeps only a fingerprint of it, and lists the token with when it was last used.
On screen: The new token; the list.
Connect Claude
To connect Claude, add Holarch as a connector in Claude's settings with the address app dot holarch dot app slash mcp, and click Connect. For this recording, a test client stands in for Claude, using the same steps.
On screen: Card: in Claude; then the consent screen.
Holarch opens its consent screen. It names the app and where it returns you, and you choose what it may do: read only, or read and propose changes; all your projects or chosen ones; and when it ends.
On screen: Consent screen.
Keep read and propose changes, and click Allow. Claude is now connected, and you get an email about it.
On screen: Allow.
Connected apps
Connected apps, in the same section, lists every app with its access, its projects and when it was last used. Disconnect cuts it off at once.
On screen: Account Settings → Connected apps.
Review a proposal
When Claude suggests changes to your model, nothing changes yet. They arrive as a proposal. Open the project: the AI menu shows the proposal waiting for review.
On screen: A proposal arrives; ✦ AI ▾.
Review it. You see each change, can edit it, and untick what you do not want. Apply Selected makes it one step you can undo.
On screen: Review → Apply Selected.
For the organization
An org admin can turn off API and AI-tool access for all of the organization's projects in Organization Settings. Tokens and connected apps then cannot reach them.
On screen: Organization Settings → API access.
Recap
Let's recap. Tokens are for scripts: scoped, limited to projects, and shown once. Claude connects with OAuth on a consent screen, appears under Connected apps, and its changes arrive as proposals you review.
Next, you set up AI for the organization.