פרקי הקורס
הדרכה · מסלול 5. צוותים וניהול · פרק 5.4 מתוך 6
5.4 אסימוני API וחיבור Claude 2:39
אסימוני גישה אישיים, חיבור Claude עם OAuth וסקירה של מה שהוא מציע.
מציג את Holarch 1.7.
מה תלמדו
- ליצור אסימון גישה אישי עם גישה, פרויקטים ותוקף מוגבלים
- לחבר את Claude ל-Holarch עם כניסה במסך ההסכמה
- לסקור הצעה מלקוח AI ולהחיל רק את השינויים הרצויים
- לבטל אסימון ולנתק אפליקציה
מאפשרים לסקריפטים ולכלי AI לעבוד עם הפרויקטים שלכם בבטחה: יוצרים אסימון גישה אישי עם היקף, פרויקטים ותוקף; מחברים את Claude עם OAuth במסך ההסכמה; מנהלים אפליקציות מחוברות; סוקרים ומחילים הצעה מלקוח AI; ומתג ה-API של הארגון.
קובצי פרויקט
- פרויקט התחלה (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)
הסרטון מוצג מ-holarch.app; ראו את מדיניות הפרטיות.
תרגול
עשו זאת בעצמכם ב-Holarch, על פרויקט ההדגמה CubeSat EO-1.
- פותחים את הגדרות החשבון ← אסימוני API. תחת אסימון חדש נותנים לו את השם
EO-1 report, בוחרים קריאה בלבד, 30 יום ו-פרויקטים נבחרים כש-EO-1 מסומן, ולוחצים על יצירת אסימון; מעתיקים את האסימון. - מריצים את דוגמת ה-
curlמ-האסימון נוצר כדי להציג את הפרויקטים שלכם, ובודקים שרק EO-1 חוזר. - לוחצים על חיבור אפליקציית AI…, בוחרים Claude ופועלים לפי השלבים. במסך חיבור Claude ל-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 בלי אסימון מודבק, מסתיימת אחרי שנה לכל היותר, ומופיעה תחת “אפליקציות מחוברות”.
אתם מבקרים בפרויקט ומשתמשים באסימון קריאה וכתיבה. האם סקריפט יכול לשנות את הפרויקט הזה?
לא. אסימון פועל בשמכם, במסגרת התפקיד שלכם בכל פרויקט, כך שמבקר או צופה רק קוראים.
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.