Holarch
فصول الدورة

التدريب · المسار 5. الفرق والإدارة · الفصل 5.4 من 6

5.4 رموز API وتوصيل Claude 2:39

يستخدم ميزات خطتي Individual وTeam:

رموز الوصول الشخصية، وتوصيل Claude عبر OAuth، ومراجعة ما يقترحه.

يعرض Holarch 1.7.

ما ستتعلمه

  • أنشئ رمز وصول شخصيًا بوصول ومشاريع ومدة صلاحية محدودة
  • وصّل Claude بـ Holarch بتسجيل الدخول في شاشة الموافقة
  • راجع اقتراحًا من عميل ذكاء اصطناعي وطبّق التغييرات التي تريدها فقط
  • ألغِ رمزًا وافصل تطبيقًا

دع البرامج النصية وأدوات الذكاء الاصطناعي تعمل مع مشاريعك بأمان: أنشئ رمز وصول شخصيًا بنطاق ومشاريع ومدة صلاحية؛ ووصّل Claude عبر OAuth في شاشة الموافقة؛ وأدر التطبيقات المتصلة؛ وراجع اقتراحًا من عميل ذكاء اصطناعي وطبّقه؛ ومفتاح API الخاص بالمؤسسة.

ملفات المشاريع

  • مشروع البداية (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)

يُشغَّل الفيديو من holarch.app؛ راجع سياسة الخصوصية.

التطبيق العملي

نفّذ هذا بنفسك في Holarch، على المشروع التوضيحي CubeSat EO-1.

  1. افتح إعدادات الحساب ← رموز API. تحت رمز جديد، سمّه EO-1 report، واختر للقراءة فقط و30 يومًا والمشاريع المحددة مع تحديد EO-1، ثم انقر إنشاء رمز؛ وانسخ الرمز.
  2. شغّل مثال curl من أُنشئ الرمز لعرض مشاريعك، وتحقق من أن EO-1 وحده يعود.
  3. انقر ربط تطبيق ذكاء اصطناعي…، واختر Claude، واتبع الخطوات. في توصيل Claude بـ 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 خمسة تغييرات. ما الذي تغيّر في المشروع؟
  4. كيف تقطع كل الرموز والتطبيقات دفعة واحدة؟
إظهار الإجابات
  1. متى تستخدم رمزًا، ومتى تطبيقًا متصلًا؟

    الرمز مخصص للبرامج النصية والعملاء الذين يرسلون ترويسة ثابتة؛ ويُعرض مرة واحدة وتحفظه أنت. أما التطبيق المتصل فيسجّل الدخول في شاشة الموافقة في Holarch دون لصق رمز، وينتهي بعد سنة واحدة على الأكثر، ويُدرج تحت «التطبيقات المتصلة».

  2. أنت مراجع في مشروع وتستخدم رمزًا للقراءة والكتابة. هل يستطيع برنامج نصي تغيير ذلك المشروع؟

    لا. يعمل الرمز باسمك، ضمن دورك في كل مشروع، فالمراجع أو المشاهد يقرأ فقط.

  3. يقترح Claude خمسة تغييرات. ما الذي تغيّر في المشروع؟

    لا شيء بعد. تنتظر التغييرات كاقتراح؛ تراجعها، وتلغي تحديد ما لا تريده، ويجعل «تطبيق المحدد» الباقي خطوة تراجع واحدة. وتبدأ عمليات الحذف والتغييرات على العناصر المعتمدة أو المدرجة في خط أساس غير محددة.

  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.