Главы курса
Обучение · Курс 5. Команды и администрирование · Глава 5.4 из 6
5.4 Токены API и подключение Claude 2:39
Персональные токены доступа, подключение Claude через OAuth и проверка того, что он предлагает.
Показан Holarch 1.7.
Чему вы научитесь
- Создавать персональный токен доступа с ограниченными правами, проектами и сроком действия
- Подключать Claude к Holarch со входом на экране согласия
- Проверять предложение от ИИ-клиента и применять только нужные изменения
- Отзывать токен и отключать приложение
Позвольте скриптам и инструментам ИИ безопасно работать с вашими проектами: создайте персональный токен доступа с областью прав, проектами и сроком действия; подключите Claude через OAuth на экране согласия; управляйте подключёнными приложениями; проверьте и примените предложение от ИИ-клиента; узнайте о переключателе API организации.
Файлы проектов
- Начальный проект (.holarch.json; Управление проектами → Файлы проекта ▾ → Импортировать проект (.json)…)
Видео воспроизводится с holarch.app; см. Политику конфиденциальности.
Практика
Выполните это сами в Holarch на демо-проекте CubeSat EO-1.
- Откройте Настройки учётной записи → Токены API. В разделе Новый токен назовите его
EO-1 report, выберите Только чтение, 30 дней и Выбранные проекты с отмеченным EO-1 и нажмите Создать токен; скопируйте токен. - Выполните пример
curlиз окна Токен создан, чтобы вывести список своих проектов, и проверьте, что возвращается только EO-1. - Нажмите Подключить приложение ИИ…, выберите Claude и выполните шаги. На экране Подключение Claude к Holarch выберите Чтение и предложение изменений, Выбранные проекты с EO-1 и окончание через 30 дней, затем нажмите Разрешить.
- Попросите Claude:
Propose a test case in EO-1 that verifies requirement 2.4 Target Slew. - Откройте EO-1, выберите ✦ ИИ ▾ → Проверить «…»…, снимите флажки со всего, что вам не нужно, и нажмите Применить выбранные.
- Вернувшись в Токены API, нажмите Отозвать у
EO-1 report, а в разделе Подключённые приложения нажмите Отключить, если Claude больше не должен быть подключён.
Готово, когда в EO-1 есть новый тестовый случай из предложения, а токена больше нет в вашем списке.
Проверьте себя
- Когда использовать токен, а когда подключённое приложение?
- Вы рецензент в проекте и используете токен на чтение и запись. Может ли скрипт изменить этот проект?
- Claude предлагает пять изменений. Что изменилось в проекте?
- Как отключить все токены и приложения сразу?
Показать ответы
Когда использовать токен, а когда подключённое приложение?
Токен предназначен для скриптов и клиентов, которые отправляют фиксированный заголовок; он показывается один раз, и вы его сохраняете. Подключённое приложение входит через экран согласия Holarch без вставленного токена, действует не более одного года и указано в разделе «Подключённые приложения».
Вы рецензент в проекте и используете токен на чтение и запись. Может ли скрипт изменить этот проект?
Нет. Токен действует от вашего имени в пределах вашей роли в каждом проекте, поэтому рецензент или читатель может только читать.
Claude предлагает пять изменений. Что изменилось в проекте?
Пока ничего. Изменения ждут в виде предложения; вы их проверяете, снимаете флажки с ненужных, а «Применить выбранные» применяет остальные одним шагом отмены. Удаления и изменения утверждённых элементов или элементов базовой линии изначально не отмечены.
Как отключить все токены и приложения сразу?
«Выйти везде» или сброс пароля отключает все подключённые приложения и отзывает все токены. Администратор организации также может отключить доступ к 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.