과정의 장
교육 · 트랙 5. 팀과 관리 · 5.4장 (전체 6장)
5.4 API 토큰과 Claude 연결 2:39
개인 액세스 토큰, OAuth로 Claude 연결, Claude가 제안하는 내용 검토.
Holarch 1.7 화면입니다.
학습 내용
- 접근 범위, 프로젝트, 만료가 제한된 개인 액세스 토큰 만들기
- 동의 화면에서 로그인하여 Claude를 Holarch에 연결하기
- AI 클라이언트의 제안을 검토하고 원하는 변경만 적용하기
- 토큰을 취소하고 앱 연결 해제하기
스크립트와 AI 도구가 프로젝트를 안전하게 다루게 합니다. 범위, 프로젝트, 만료가 있는 개인 액세스 토큰 만들기, 동의 화면에서 OAuth로 Claude 연결하기, 연결된 앱 관리하기, AI 클라이언트의 제안을 검토하고 적용하기, 그리고 조직의 API 스위치를 다룹니다.
실습
CubeSat EO-1 데모 프로젝트에서 Holarch로 직접 해 보십시오.
- 계정 설정 → API 토큰을 엽니다. 새 토큰에서 이름을
EO-1 report로 지정하고, 읽기 전용, 30일, EO-1을 선택한 선택한 프로젝트를 고른 다음 토큰 만들기를 클릭하고 토큰을 복사합니다. - 토큰이 생성됨의
curl예제를 실행하여 프로젝트를 나열하고, EO-1만 반환되는지 확인합니다. - AI 앱 연결…을 클릭하고 Claude를 선택한 다음 단계를 따릅니다. Connect Claude to Holarch에서 읽기 및 변경 제안, EO-1이 포함된 선택한 프로젝트, 30일 후 종료를 선택한 다음 허용을 클릭합니다.
- Claude에서 다음과 같이 요청합니다:
Propose a test case in EO-1 that verifies requirement 2.4 Target Slew. - EO-1을 열고 ✦ AI ▾ → “…” 검토…를 선택한 다음, 원하지 않는 것은 선택 해제하고 선택 항목 적용을 클릭합니다.
- API 토큰으로 돌아가
EO-1 report의 취소를 클릭하고, Claude 연결이 필요 없으면 연결된 앱에서 연결 해제를 클릭합니다.
EO-1에 제안에서 나온 새 테스트 케이스가 있고 토큰이 목록에서 사라졌으면 완료입니다.
스스로 확인
- 언제 토큰을 쓰고, 언제 연결된 앱을 씁니까?
- 프로젝트에서 검토자이며 읽기 및 쓰기 토큰을 사용합니다. 스크립트가 그 프로젝트를 변경할 수 있습니까?
- Claude가 변경 다섯 개를 제안합니다. 프로젝트에서 무엇이 바뀌었습니까?
- 모든 토큰과 앱을 한 번에 끊으려면 어떻게 합니까?
답 보기
언제 토큰을 쓰고, 언제 연결된 앱을 씁니까?
토큰은 고정 헤더를 보내는 스크립트와 클라이언트용이며, 한 번만 표시되므로 직접 보관합니다. 연결된 앱은 토큰을 붙여 넣지 않고 Holarch 동의 화면에서 로그인하며, 최대 1년 후 종료되고 연결된 앱 아래에 나열됩니다.
프로젝트에서 검토자이며 읽기 및 쓰기 토큰을 사용합니다. 스크립트가 그 프로젝트를 변경할 수 있습니까?
아닙니다. 토큰은 각 프로젝트에서의 본인 역할 안에서 본인으로 동작하므로, 검토자나 뷰어는 읽기만 합니다.
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.