Kurs bölümleri
Eğitim · Kurs 5. Ekipler ve yönetim · Bölüm 5.4 / 6
5.4 API belirteçleri ve Claude'u bağlama 2:39
Kişisel erişim belirteçleri, Claude'u OAuth ile bağlama ve önerdiklerini gözden geçirme.
Holarch 1.7 sürümünü gösterir.
Neler öğreneceksiniz
- Erişimi, projeleri ve süresi sınırlı bir kişisel erişim belirteci oluşturun
- Onay ekranında oturum açarak Claude'u Holarch'a bağlayın
- Bir YZ istemcisinden gelen öneriyi gözden geçirin ve yalnızca istediğiniz değişiklikleri uygulayın
- Bir belirteci iptal edin ve bir uygulamanın bağlantısını kesin
Betiklerin ve YZ araçlarının projelerinizle güvenle çalışmasını sağlayın: kapsamı, projeleri ve süresi olan bir kişisel erişim belirteci oluşturun; onay ekranında Claude'u OAuth ile bağlayın; Bağlı uygulamaları yönetin; bir YZ istemcisinden gelen öneriyi gözden geçirip uygulayın; ve kuruluşun API ayarı.
Proje dosyaları
- Başlangıç projesi (.holarch.json; Projeleri yönet → Proje dosyaları ▾ → Proje içe aktar (.json)…)
Video holarch.app'ten oynatılır; bkz. Gizlilik Politikası.
Alıştırma
Bunu Holarch'ta, CubeSat EO-1 demo projesinde kendiniz yapın.
- Hesap ayarları → API belirteçleri'ni açın. Yeni belirteç altında adını
EO-1 reportkoyun, Salt okunur, 30 gün ve EO-1 işaretli olarak Seçili projeler'i seçin ve Belirteç oluştur'a tıklayın; belirteci kopyalayın. - Projelerinizi listelemek için Belirteç oluşturuldu'daki
curlörneğini çalıştırın ve yalnızca EO-1'in döndüğünü denetleyin. - Bir YZ uygulaması bağla…'ya tıklayın, Claude'u seçin ve adımları izleyin. Claude'u Holarch'a bağla ekranında Okuma ve değişiklik önerme'yi, EO-1 ile Seçilen projeler'i ve 30 günlük bir bitiş süresini seçin, ardından İzin ver'e tıklayın.
- Claude'a şunu sorun:
Propose a test case in EO-1 that verifies requirement 2.4 Target Slew. - EO-1'i açın, ✦ YZ ▾ → “…” incele…'yi seçin, istemediğiniz her şeyin işaretini kaldırın ve Seçilenleri uygula'ya tıklayın.
- API belirteçleri'ne geri dönün,
EO-1 reportüzerinde İptal et'e tıklayın ve Claude'un bağlı kalmasına ihtiyacınız yoksa Bağlı uygulamalar altında Bağlantıyı kes'e tıklayın.
EO-1 öneriden gelen yeni test senaryosunu içerdiğinde ve belirteç listenizden kalktığında işiniz bitmiştir.
Kendinizi sınayın
- Ne zaman bir belirteç, ne zaman bağlı bir uygulama kullanırsınız?
- Bir projede inceleyicisiniz ve okuma-yazma belirteci kullanıyorsunuz. Bir betik o projeyi değiştirebilir mi?
- Claude beş değişiklik öneriyor. Projede ne değişti?
- Her belirteci ve uygulamayı tek seferde nasıl kesersiniz?
Yanıtları göster
Ne zaman bir belirteç, ne zaman bağlı bir uygulama kullanırsınız?
Belirteç, sabit bir üst bilgi gönderen betikler ve istemciler içindir; bir kez gösterilir ve onu siz saklarsınız. Bağlı bir uygulama ise yapıştırılmış bir belirteç olmadan Holarch'ın onay ekranında oturum açar, en fazla bir yıl sonra sona erer ve Bağlı uygulamalar altında listelenir.
Bir projede inceleyicisiniz ve okuma-yazma belirteci kullanıyorsunuz. Bir betik o projeyi değiştirebilir mi?
Hayır. Belirteç her projedeki rolünüz dahilinde sizin adınıza hareket eder, bu yüzden bir inceleyici veya görüntüleyici yalnızca okur.
Claude beş değişiklik öneriyor. Projede ne değişti?
Henüz hiçbir şey. Değişiklikler bir öneri olarak bekler; onları gözden geçirir, istemediklerinizin işaretini kaldırırsınız ve Seçilenleri uygula geri kalanını tek bir geri alma adımı yapar. Silmeler ve onaylanmış ya da temel çizgiye alınmış öğelerdeki değişiklikler işaretsiz başlar.
Her belirteci ve uygulamayı tek seferde nasıl kesersiniz?
Her yerde oturumu kapat veya bir parola sıfırlama, her bağlı uygulamanın bağlantısını keser ve her belirteci iptal eder. Bir kuruluş yöneticisi kuruluşun projeleri için API ve MCP erişimini de kapatabilir.
Daha fazla bilgi
Döküm
Dökümü göster (anlatım ve ekranda görünenler)
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.