Holarch
Chapitres du cours

Formation · Parcours 5. Équipes et administration · Chapitre 5.4 sur 6

5.4 Jetons API et connexion de Claude 2:39

Utilise des fonctionnalités des offres Individual et Team :

Les jetons d'accès personnels, la connexion de Claude avec OAuth, et l'examen de ce qu'il propose.

Montre Holarch 1.7.

Ce que vous allez apprendre

  • Créer un jeton d'accès personnel avec un accès, des projets et une expiration limités
  • Connecter Claude à Holarch avec une connexion sur l'écran de consentement
  • Examiner une proposition d'un client d'IA et n'appliquer que les modifications voulues
  • Révoquer un jeton et déconnecter une application

Laissez des scripts et des outils d'IA travailler sur vos projets en toute sécurité : créez un jeton d'accès personnel avec une portée, des projets et une expiration ; connectez Claude avec OAuth sur l'écran de consentement ; gérez les Applications connectées ; examinez et appliquez une proposition d'un client d'IA ; et l'interrupteur API de l'organisation.

Fichiers de projet

  • Projet de départ (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)

La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.

Pratique

Faites-le vous-même dans Holarch, sur le projet de démonstration CubeSat EO-1.

  1. Ouvrez Paramètres du compte → Jetons API. Sous Nouveau jeton, nommez-le EO-1 report, choisissez Lecture seule, 30 jours et Projets sélectionnés avec EO-1 coché, et cliquez sur Créer le jeton ; copiez le jeton.
  2. Exécutez l'exemple curl de Jeton créé pour lister vos projets, et vérifiez que seul EO-1 est renvoyé.
  3. Cliquez sur Connecter une application d'IA…, choisissez Claude et suivez les étapes. Sur Connecter Claude à Holarch, choisissez Lire et proposer des modifications, Projets choisis avec EO-1, et une fin dans 30 jours, puis cliquez sur Autoriser.
  4. Dans Claude, demandez : Propose a test case in EO-1 that verifies requirement 2.4 Target Slew.
  5. Ouvrez EO-1, choisissez ✦ IA ▾ → Examiner « … »…, décochez ce que vous ne voulez pas, et cliquez sur Appliquer la sélection.
  6. De retour dans Jetons API, cliquez sur Révoquer sur EO-1 report, et sous Applications connectées cliquez sur Déconnecter si vous n'avez pas besoin que Claude reste connecté.

C'est terminé quand EO-1 contient le nouveau cas de test issu de la proposition et que le jeton a disparu de votre liste.

Vérifiez vos connaissances

  1. Quand utiliser un jeton, et quand une application connectée ?
  2. Vous êtes relecteur dans un projet et utilisez un jeton en lecture et écriture. Un script peut-il modifier ce projet ?
  3. Claude propose cinq modifications. Qu'est-ce qui a changé dans le projet ?
  4. Comment couper d'un coup tous les jetons et toutes les applications ?
Afficher les réponses
  1. Quand utiliser un jeton, et quand une application connectée ?

    Un jeton sert aux scripts et aux clients qui envoient un en-tête fixe ; il s'affiche une seule fois et vous le conservez. Une application connectée se connecte sur l'écran de consentement de Holarch sans jeton collé, expire au bout d'un an au plus, et est listée sous Applications connectées.

  2. Vous êtes relecteur dans un projet et utilisez un jeton en lecture et écriture. Un script peut-il modifier ce projet ?

    Non. Un jeton agit en votre nom, dans les limites de votre rôle dans chaque projet : un relecteur ou un lecteur ne fait que lire.

  3. Claude propose cinq modifications. Qu'est-ce qui a changé dans le projet ?

    Rien pour l'instant. Les modifications attendent sous forme de proposition ; vous les examinez, décochez ce que vous ne voulez pas, et Appliquer la sélection applique le reste en une seule étape d'annulation. Les suppressions et les modifications d'éléments approuvés ou placés dans une référence commencent décochées.

  4. Comment couper d'un coup tous les jetons et toutes les applications ?

    Se déconnecter partout, ou une réinitialisation du mot de passe, déconnecte chaque application connectée et révoque chaque jeton. Un administrateur d'organisation peut aussi désactiver l'accès API et MCP pour les projets de l'organisation.

Pour aller plus loin

Transcription

Afficher la transcription (narration et contenu de l'écran)

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.