Holarch
コースのチャプター

トレーニング · トラック 5. チームと管理 · チャプター 5.4(全 6 チャプター)

5.4 API トークンと Claude の接続 2:39

Individual プランと Team プランの機能を使用します:

個人用アクセストークン、OAuth による Claude の接続、そして提案内容の確認。

Holarch 1.7 の画面です。

学習内容

  • アクセス範囲、プロジェクト、有効期限を限定した個人用アクセストークンを作成する
  • 同意画面でサインインして Claude を Holarch に接続する
  • AI クライアントからの提案を確認し、必要な変更だけを適用する
  • トークンを取り消し、アプリの接続を解除する

スクリプトや AI ツールがプロジェクトを安全に扱えるようにします。アクセス範囲、プロジェクト、有効期限を指定した個人用アクセストークンの作成、同意画面での OAuth による Claude の接続、接続済みアプリの管理、AI クライアントからの提案の確認と適用、そして組織の API スイッチを扱います。

プロジェクトファイル

  • 開始時のプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)

動画は holarch.app から再生されます。プライバシーポリシーをご覧ください。

演習

CubeSat EO-1 デモプロジェクトを使って、Holarch で実際に操作します。

  1. アカウント設定 → API トークンを開きます。新しいトークンで名前を EO-1 report にし、読み取り専用、30 日、EO-1 にチェックを入れた選択したプロジェクトを選んでトークンを作成をクリックし、トークンをコピーします。
  2. トークンを作成しましたにある curl の例を実行してプロジェクトを一覧表示し、EO-1 だけが返されることを確認します。
  3. AI アプリを接続…をクリックし、Claude を選んで手順に従います。Connect Claude to Holarch で、読み取りと変更の提案、EO-1 を含む選択したプロジェクト、30 日後の終了日を選び、許可をクリックします。
  4. Claude で次のように依頼します:Propose a test case in EO-1 that verifies requirement 2.4 Target Slew。
  5. EO-1 を開き、✦ AI ▾ → 「…」をレビュー…を選び、不要なもののチェックを外して選択した項目を適用をクリックします。
  6. API トークンに戻り、EO-1 report の取り消しをクリックします。Claude の接続が不要な場合は、接続済みアプリで接続を解除をクリックします。

EO-1 に提案からの新しいテストケースがあり、一覧からトークンがなくなっていれば完了です。

確認問題

  1. トークンを使うのはどんなときで、接続済みアプリを使うのはどんなときですか?
  2. あなたはあるプロジェクトのレビュー担当者で、読み書き可能なトークンを使っています。スクリプトはそのプロジェクトを変更できますか?
  3. Claude が 5 つの変更を提案しました。プロジェクトでは何が変わりましたか?
  4. すべてのトークンとアプリを一度に遮断するにはどうしますか?
解答を表示
  1. トークンを使うのはどんなときで、接続済みアプリを使うのはどんなときですか?

    トークンは、固定のヘッダーを送るスクリプトやクライアント向けです。表示されるのは 1 回だけで、自分で保管します。接続済みアプリは、トークンを貼り付けずに Holarch の同意画面でサインインし、最長 1 年で終了し、接続済みアプリに一覧表示されます。

  2. あなたはあるプロジェクトのレビュー担当者で、読み書き可能なトークンを使っています。スクリプトはそのプロジェクトを変更できますか?

    いいえ。トークンは各プロジェクトでのあなたのロールの範囲内で、あなたとして動作するため、レビュー担当者や閲覧者は読み取りだけができます。

  3. Claude が 5 つの変更を提案しました。プロジェクトでは何が変わりましたか?

    まだ何も変わっていません。変更は提案として待機しています。それらを確認し、不要なもののチェックを外すと、「選択した項目を適用」が残りを元に戻す操作の 1 単位として適用します。削除と、承認済みまたはベースライン化された項目の変更は、最初はチェックが外れています。

  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.