Holarch
課程章節

培訓 · 第 5 單元:團隊與管理 · 第 5.4 章,共 6 章

5.4 API 權杖與連接 AI 應用程式 2:39

使用 Individual 與 Team 方案的功能:

個人存取權杖、以 OAuth 連接 AI 應用程式,以及審查它提出的內容。

展示 Holarch 1.7。

您將學到

  • 建立限制存取權、專案與到期日的個人存取權杖
  • 在同意畫面上登入,將 AI 應用程式連接到 Holarch
  • 審查 AI 用戶端的提案,只套用您想要的變更
  • 撤銷權杖並中斷應用程式連線

讓指令碼與 AI 工具安全地使用您的專案:建立具有範圍、專案與到期日的個人存取權杖;在同意畫面上以 OAuth 連接 AI 應用程式;管理已連線的應用程式;審查並套用 AI 用戶端的提案;以及組織的 API 開關。

專案檔案

  • 起始專案 (.holarch.json;管理專案 → 專案檔案 ▾ → 匯入專案 (.json)…)

影片從 holarch.app 播放;請參閱隱私權政策。

練習

在 Holarch 中於 CubeSat EO-1 示範專案上親自操作。

  1. 開啟帳戶設定 → API 權杖。在新權杖下,將它命名為 EO-1 report,選擇唯讀、30 天以及勾選了 EO-1 的所選專案,然後按一下建立權杖;複製權杖。
  2. 執行權杖已建立中的 curl 範例以列出您的專案,並確認只傳回 EO-1。
  3. 按一下連線 AI 應用程式…,選擇 AI 應用程式,並依照步驟操作。在將 AI 應用程式連接到 Holarch 上,選擇讀取並提出變更、含 EO-1 的選定的專案,以及 30 天的期限,然後按一下允許。
  4. 在 AI 應用程式中詢問:Propose a test case in EO-1 that verifies requirement 2.4 Target Slew。
  5. 開啟 EO-1,選擇 ✦ AI ▾ → 審查「…」…,取消勾選您不想要的項目,然後按一下套用所選項。
  6. 回到 API 權杖,在 EO-1 report 上按一下撤銷;如果您不需要 AI 應用程式保持連線,請在已連線的應用程式下按一下中斷連線。

當 EO-1 有來自提案的新測試案例,且權杖已從您的清單中消失時,即完成。

自我檢查

  1. 什麼時候使用權杖,什麼時候使用已連線的應用程式?
  2. 您在某個專案中是審查者,並使用可讀寫的權杖。指令碼能變更該專案嗎?
  3. AI 應用程式提出了五項變更。專案中有什麼改變了?
  4. 如何一次切斷所有權杖與應用程式?
顯示答案
  1. 什麼時候使用權杖,什麼時候使用已連線的應用程式?

    權杖用於傳送固定標頭的指令碼與用戶端;它只顯示一次,由您自行保存。已連線的應用程式會在 Holarch 的同意畫面上登入,無需貼上權杖,最多一年後結束,並列在「已連線的應用程式」下。

  2. 您在某個專案中是審查者,並使用可讀寫的權杖。指令碼能變更該專案嗎?

    不能。權杖代表您行事,受限於您在每個專案中的角色,因此審查者或檢視者只能讀取。

  3. AI 應用程式提出了五項變更。專案中有什麼改變了?

    目前還沒有。變更會以提案的形式等候;您審查它們、取消勾選不想要的項目,然後「套用所選項」會將其餘變更合成一個復原步驟。刪除,以及對已核准或已納入基準線項目的變更,一開始都是未勾選的。

  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.