Holarch
Rozdziały kursu

Szkolenia · Ścieżka 5. Zespoły i administracja · Rozdział 5.4 z 6

5.4 Tokeny API i łączenie z Claude 2:39

Korzysta z funkcji planów Individual i Team:

Osobiste tokeny dostępu, łączenie Claude przez OAuth i przegląd jego propozycji.

Pokazuje Holarch 1.7.

Czego się nauczysz

  • Tworzenie osobistego tokenu dostępu z ograniczonym dostępem, projektami i terminem ważności
  • Łączenie Claude z Holarch przez logowanie na ekranie zgody
  • Przegląd propozycji od klienta AI i stosowanie tylko wybranych zmian
  • Unieważnianie tokenu i odłączanie aplikacji

Pozwól skryptom i narzędziom AI bezpiecznie pracować z twoimi projektami: utwórz osobisty token dostępu z zakresem, projektami i terminem ważności; połącz Claude przez OAuth na ekranie zgody; zarządzaj połączonymi aplikacjami; przejrzyj i zastosuj propozycję od klienta AI; poznaj przełącznik API organizacji.

Pliki projektu

  • Projekt początkowy (.holarch.json; Zarządzaj projektami → Pliki projektu ▾ → Importuj projekt (.json)…)

Film jest odtwarzany z holarch.app; zobacz Politykę prywatności.

Ćwiczenie

Wykonaj to samodzielnie w Holarch, w projekcie demonstracyjnym CubeSat EO-1.

  1. Otwórz Ustawienia konta → Tokeny API. W sekcji Nowy token nazwij go EO-1 report, wybierz Tylko do odczytu, 30 dni i Wybrane projekty z zaznaczonym EO-1 i kliknij Utwórz token; skopiuj token.
  2. Uruchom przykład curl z okna Utworzono token, aby wyświetlić listę projektów, i sprawdź, czy zwracany jest tylko EO-1.
  3. Kliknij Połącz aplikację AI…, wybierz Claude i wykonaj kolejne kroki. Na ekranie Połącz Claude z Holarch wybierz Odczyt i proponowanie zmian, Wybrane projekty z EO-1 i termin zakończenia za 30 dni, a następnie kliknij Zezwól.
  4. W Claude poproś: Propose a test case in EO-1 that verifies requirement 2.4 Target Slew.
  5. Otwórz EO-1, wybierz ✦ AI ▾ → Przejrzyj „…”…, odznacz wszystko, czego nie chcesz, i kliknij Zastosuj zaznaczone.
  6. Po powrocie do Tokeny API kliknij Unieważnij przy EO-1 report, a w sekcji Połączone aplikacje kliknij Odłącz, jeśli Claude nie musi być połączony.

Gotowe, gdy EO-1 ma nowy przypadek testowy z propozycji, a tokenu nie ma już na liście.

Sprawdź się

  1. Kiedy używać tokenu, a kiedy połączonej aplikacji?
  2. Jesteś recenzentem w projekcie i używasz tokenu do odczytu i zapisu. Czy skrypt może zmienić ten projekt?
  3. Claude proponuje pięć zmian. Co zmieniło się w projekcie?
  4. Jak odciąć naraz wszystkie tokeny i aplikacje?
Pokaż odpowiedzi
  1. Kiedy używać tokenu, a kiedy połączonej aplikacji?

    Token służy skryptom i klientom wysyłającym stały nagłówek; jest pokazywany raz i musisz go przechować. Połączona aplikacja loguje się na ekranie zgody Holarch bez wklejania tokenu, wygasa najpóźniej po roku i jest wymieniona w sekcji Połączone aplikacje.

  2. Jesteś recenzentem w projekcie i używasz tokenu do odczytu i zapisu. Czy skrypt może zmienić ten projekt?

    Nie. Token działa w twoim imieniu, w ramach twojej roli w każdym projekcie, więc recenzent lub czytelnik może tylko odczytywać.

  3. Claude proponuje pięć zmian. Co zmieniło się w projekcie?

    Na razie nic. Zmiany czekają jako propozycja; przeglądasz je, odznaczasz to, czego nie chcesz, a Zastosuj zaznaczone wprowadza resztę jako jeden krok cofania. Usunięcia i zmiany zatwierdzonych elementów lub elementów w linii bazowej są początkowo odznaczone.

  4. Jak odciąć naraz wszystkie tokeny i aplikacje?

    Wyloguj się wszędzie lub reset hasła odłącza wszystkie połączone aplikacje i unieważnia wszystkie tokeny. Administrator organizacji może też wyłączyć dostęp przez API i MCP dla projektów organizacji.

Więcej informacji

Transkrypcja

Pokaż transkrypcję (narracja i to, co widać na ekranie)

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.