ابدأ مجانًا →

SDK وسطر الأوامر

MCP

أمران مختلفان: بوابة MCP خاضعة للحوكمة يستدعي وكلاؤك أدواتهم عبرها، وخادم MCP يتيح لمساعد قراءة مساحة عملك.

بوابة MCP الخاضعة للحوكمة

  • نقطة نهاية واحدة، POST /api/v1/mcp، لأي عميل MCP قياسي (Streamable HTTP)، بمفتاح مرتبط بوكيل واحد، يُنشأ في الوكلاء › أدوات MCP.
  • يتولى مالك أو مسؤول الكتالوج: الخوادم، وكيفية مصادقة Azoth لديها — الأسرار مشفّرة، ولا تُرسل إلى أي وكيل أبدًا — ومراجعة كل أداة مع قابليتها للتراجع. ولا تُتاح إلا الأدوات المعتمدة، ويعود أي تعريف متغيّر إلى المراجعة.
  • يمر كل استدعاء أداة عبر تفويض الوكيل وAzoth Guard؛ وينتظر الاستدعاء غير القابل للتراجع أو المالي موافقة شخص. وتُفحص النتائج وتُوسم بأنها غير موثوقة. ولا يُحتفظ بأي وسيط ولا بأي نتيجة: يُختم الاستدعاء برموز وبصمة.
  • الأدوات وحدها في الوقت الحالي: لا تُقدَّم الموارد ولا الموجّهات ولا أخذ العيّنات (sampling). والبوابة معطّلة ما لم يفعّلها النشر (FEATURE_MCP_GATEWAY).
URL      https://www.azothos.ai/api/v1/mcp
Header   Authorization: Bearer az_live_…     # a key bound to one agent (Agents › MCP tools)

خادم Azoth MCP

  • الحزمة @azothos/mcp خادم MCP بلا تبعيات، مفتوح المصدر بموجب ترخيص Apache-2.0: يعمل على حاسوبك باستخدام Node.js 18 أو أحدث، عبر stdio، ويقرأ مساحة عملك بمفتاح API.
  • تُرجع أدواته أرقام لوحة التحكم نفسها: التفويضات ومن المسؤول عن قرار بعينه، والقواعد السارية، وقرارات الحظر، والقانون المطبَّق، وتغطية الامتثال، وحالة الإثبات، والنفقات والبصمة، ومصادر الدعم.
  • كل الأدوات تقرأ فقط، باستثناء تلك التي تقول تعليقاتها التوضيحية إنها تسجّل شيئًا: azoth_export_dossier — كل تصدير يُرسَّخ ويُختم زمنيًا ويُختم في السجل، كما من الإثباتات › الملفات — وفي الملف الكامل azoth_preflight وazoth_compress. ولا تُقدَّم مسودات المساعد: تحتاج المسودة إلى شخص يؤكّدها في شاشتها.

التثبيت

لم يُنشر الخادم بعد: ستُضاف هنا روابط حزمته على npm وامتداده لـ Claude Desktop فور نشرهما.

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

  • public، وهو الافتراضي: التفويضات والقواعد والإثبات والنفقات ومصادر الدعم — الأدوات أدناه.
  • full، مع AZOTH_MCP_PROFILE=full (مفتاح Full profile في الامتداد): إضافةً إلى ذلك أدوات التحسين وFinOps، وأدوات الميزات التي يفعّلها النشر، والأسماء السابقة للأدوات، المحفوظة لإصدار واحد.
  • لا تُدرَج الأداة الواقعة خارج الملف التعريفي، ويُرفض استدعاؤها مع ذكر الملف التعريفي الذي يقدّمها.
azoth_spend
Spend and budgets by mandate
azoth_block_decisions
Blocked decisions
azoth_unmandated_uses
Unmandated AI uses
azoth_mandates_overview
Mandates overview
azoth_accountability
Who answers for a decision
azoth_journal_entry
Sealed decision
azoth_model_choice
Why this model and region
azoth_proof_status
Proof status
azoth_active_rules
Rules in force
azoth_data_flows
Data flows
azoth_applicable_law
Applicable law
azoth_regulatory_changes
Regulatory changes
azoth_compliance_coverage
Compliance coverage
azoth_evidence_summary
This quarter's evidence
azoth_workspace_health
Workspace health
azoth_footprint
Energy and carbon
azoth_support_docs
Search the documentation
azoth_support_changelog
What changed in Azoth
azoth_support_status
Service status
azoth_support_error
Error code explained
azoth_journal_query
Search the decision journal
azoth_evidence_export
Evidence pack
azoth_export_dossier
Export a verifiable dossier
azoth_system_modules
System modules

مفتاح API

أنشئه في الإعدادات › الوصول. يُفضَّل مفتاح شخصي بدور القراءة، وبتاريخ انتهاء، وبالنطاقات التي يحتاجها ملفه التعريفي فقط:

public  insights:read journal:read usage:read
full    advisory:read agents:read insights:read journal:read policy:read usage:read

تقرأ معظم أدوات الملف التعريفي العام وظائف لوحة التحكم نفسها: فهي تتطلب خطة Starter أو أعلى، وتفعيل مساعد مساحة العمل (الإعدادات › المؤسسة). ولا يتلقى المفتاح أبدًا عنوان البريد الإلكتروني لأي عضو.

الخصوصية

  • لا يحتفظ الخادم بأي شيء على حاسوبك ولا يرسل أي بيانات قياس عن بُعد.
  • يرسل كل استدعاء المفتاح ووسائط الأداة إلى AZOTH_API_URL — خدمة Azoth أو نشرك الخاص — ولا شيء غير ذلك. ويجب أن يستخدم العنوان HTTPS (ولا يُقبل HTTP العادي إلا على حاسوبك نفسه)، ولا تُتَّبع أي إعادة توجيه.
  • ما تُرجعه الأداة يذهب إلى عميل MCP لديك وإلى النموذج الذي يستخدمه، وفق سياسة الخصوصية الخاصة بذلك العميل: معرّفات ورموز وأعداد وتكاليف والأسماء التي وضعها أعضاؤك — ولا يتضمن أبدًا عنوان البريد الإلكتروني لأي عضو.

ما تحتفظ به Azoth من هذه الاستدعاءات موصوف في سياسة الخصوصية الخاصة بها.

الموصل البعيد

الموصل البعيد غير مفعّل في هذا النشر.