Holarch
Розділи курсів

Навчання · Курс 5. Команди та адміністрування · Розділ 5.4 з 6

5.4 Токени API та під’єднання Claude 2:39

Використовує функції тарифів Individual і Team:

Персональні токени доступу, під’єднання Claude через OAuth і перегляд того, що він пропонує.

Показано Holarch 1.7.

Що ви дізнаєтеся

  • Створити персональний токен доступу з обмеженим доступом, проєктами й терміном дії
  • Під’єднати Claude до Holarch із входом на екрані згоди
  • Переглянути пропозицію від клієнта ШІ й застосувати лише потрібні зміни
  • Відкликати токен і від’єднати застосунок

Дозвольте скриптам та інструментам ШІ безпечно працювати з вашими проєктами: створіть персональний токен доступу з областю дії, проєктами й терміном; під’єднайте Claude через OAuth на екрані згоди; керуйте під’єднаними застосунками; перегляньте й застосуйте пропозицію від клієнта ШІ; і перемикач API організації.

Файли проєкту

  • Початковий проєкт (.holarch.json; Керування проєктами → Файли проєкту ▾ → Імпортувати проєкт (.json)…)

Відео відтворюється з holarch.app; див. Політику конфіденційності.

Практика

Виконайте це самостійно в Holarch на демопроєкті CubeSat EO-1.

  1. Відкрийте Налаштування облікового запису → Токени API. У Новий токен назвіть його EO-1 report, оберіть Лише читання, 30 днів і Вибрані проєкти з позначеним EO-1 та натисніть Створити токен; скопіюйте токен.
  2. Виконайте приклад curl з Токен створено, щоб отримати список своїх проєктів, і перевірте, що повертається лише EO-1.
  3. Натисніть Під’єднати застосунок ШІ…, оберіть Claude і виконайте кроки. На екрані Під’єднати Claude до Holarch оберіть Читати й пропонувати зміни, Обрані проєкти з EO-1 і завершення через 30 днів, потім натисніть Дозволити.
  4. У Claude попросіть: Propose a test case in EO-1 that verifies requirement 2.4 Target Slew.
  5. Відкрийте EO-1, оберіть ✦ ШІ ▾ → Переглянути «…»…, зніміть позначки з того, що вам не потрібно, і натисніть Застосувати вибрані.
  6. Поверніться до Токени API, натисніть Відкликати для EO-1 report, а в Під’єднані застосунки натисніть Від’єднати, якщо Claude вам не потрібен під’єднаним.

Завдання виконано, коли EO-1 має новий тестовий випадок із пропозиції, а токена більше немає у вашому списку.

Перевірте себе

  1. Коли використовувати токен, а коли під’єднаний застосунок?
  2. Ви рецензент у проєкті й використовуєте токен для читання й запису. Чи може скрипт змінити цей проєкт?
  3. Claude пропонує п’ять змін. Що змінилося в проєкті?
  4. Як одночасно відключити всі токени й застосунки?
Показати відповіді
  1. Коли використовувати токен, а коли під’єднаний застосунок?

    Токен — для скриптів і клієнтів, що надсилають фіксований заголовок; його показують один раз, і ви зберігаєте його самі. Під’єднаний застосунок входить на екрані згоди Holarch без вставленого токена, діє щонайбільше рік і показується в «Під’єднані застосунки».

  2. Ви рецензент у проєкті й використовуєте токен для читання й запису. Чи може скрипт змінити цей проєкт?

    Ні. Токен діє від вашого імені в межах вашої ролі в кожному проєкті, тож рецензент чи читач лише читає.

  3. Claude пропонує п’ять змін. Що змінилося в проєкті?

    Поки нічого. Зміни чекають як пропозиція; ви переглядаєте їх, знімаєте позначки з непотрібних, і «Застосувати вибрані» робить решту одним кроком відмінення. Видалення й зміни затверджених елементів або елементів у базовій лінії спочатку не позначено.

  4. Як одночасно відключити всі токени й застосунки?

    «Вийти скрізь» або скидання пароля від’єднує всі під’єднані застосунки й відкликає всі токени. Адміністратор організації також може вимкнути доступ через API і MCP для проєктів організації.

Докладніше

Стенограма

Показати стенограму (озвучення і те, що на екрані)

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.