Holarch
Capitoli del corso

Formazione · Percorso 5. Team e amministrazione · Capitolo 5.4 di 6

5.4 Token API e connessione di Claude 2:39

Usa funzionalità dei piani Individual e Team:

Token di accesso personali, connessione di Claude con OAuth e revisione di ciò che propone.

Mostra Holarch 1.7.

Che cosa si impara

  • Creare un token di accesso personale con accesso, progetti e scadenza limitati
  • Connettere Claude a Holarch con l’accesso nella schermata di consenso
  • Rivedere una proposta di un client IA e applicare solo le modifiche desiderate
  • Revocare un token e disconnettere un’app

Consentire a script e strumenti di IA di lavorare in sicurezza sui propri progetti: creare un token di accesso personale con un ambito, dei progetti e una scadenza; connettere Claude con OAuth nella schermata di consenso; gestire le App connesse; rivedere e applicare una proposta di un client IA; e l’interruttore API dell’organizzazione.

File di progetto

  • Progetto iniziale (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)

Il video viene riprodotto da holarch.app; vedere l’Informativa sulla privacy.

Esercitazione

Provare in prima persona in Holarch, sul progetto demo CubeSat EO-1.

  1. Aprire Impostazioni account → Token API. In Nuovo token, chiamarlo EO-1 report, scegliere Sola lettura, 30 giorni e Progetti selezionati con EO-1 selezionato, e fare clic su Crea token; copiare il token.
  2. Eseguire l’esempio curl di Token creato per elencare i propri progetti e verificare che venga restituito solo EO-1.
  3. Fare clic su Connetti un'app di IA…, scegliere Claude e seguire i passi. In Connetti Claude a Holarch, scegliere Lettura e proposta di modifiche, Progetti scelti con EO-1 e una scadenza di 30 giorni, poi fare clic su Consenti.
  4. In Claude, chiedere: Propose a test case in EO-1 that verifies requirement 2.4 Target Slew.
  5. Aprire EO-1, scegliere ✦ IA ▾ → Rivedi «…»…, deselezionare ciò che non si vuole e fare clic su Applica selezionati.
  6. Tornati in Token API, fare clic su Revoca su EO-1 report e, in App connesse, fare clic su Disconnetti se Claude non deve restare connesso.

L’esercizio è completato quando EO-1 contiene il nuovo caso di test della proposta e il token non compare più nell’elenco.

Verifica

  1. Quando si usa un token e quando un’app connessa?
  2. In un progetto si è revisori e si usa un token di lettura e scrittura. Uno script può modificare quel progetto?
  3. Claude propone cinque modifiche. Che cosa è cambiato nel progetto?
  4. Come si bloccano tutti i token e tutte le app in una volta?
Mostra le risposte
  1. Quando si usa un token e quando un’app connessa?

    Un token è per script e client che inviano un’intestazione fissa; viene mostrato una sola volta e va conservato. Un’app connessa accede dalla schermata di consenso di Holarch senza incollare un token, scade al massimo dopo un anno ed è elencata in App connesse.

  2. In un progetto si è revisori e si usa un token di lettura e scrittura. Uno script può modificare quel progetto?

    No. Un token agisce a nome dell’utente, entro il suo ruolo in ciascun progetto, quindi un revisore o un lettore può solo leggere.

  3. Claude propone cinque modifiche. Che cosa è cambiato nel progetto?

    Ancora nulla. Le modifiche restano in attesa come proposta; si esaminano, si deseleziona ciò che non si vuole e Applica selezionati applica il resto in un solo passo di annullamento. Le eliminazioni e le modifiche a elementi approvati o in baseline partono deselezionate.

  4. Come si bloccano tutti i token e tutte le app in una volta?

    Esci ovunque, o una reimpostazione della password, disconnette ogni app connessa e revoca ogni token. Un amministratore dell’organizzazione può anche disattivare l’accesso tramite API e MCP per i progetti dell’organizzazione.

Per saperne di più

Trascrizione

Mostra la trascrizione (narrazione e contenuto dello schermo)

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.