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_spendSpend and budgets by mandate
azoth_block_decisionsBlocked decisions
azoth_unmandated_usesUnmandated AI uses
azoth_mandates_overviewMandates overview
azoth_accountabilityWho answers for a decision
azoth_journal_entrySealed decision
azoth_model_choiceWhy this model and region
azoth_proof_statusProof status
azoth_active_rulesRules in force
azoth_data_flowsData flows
azoth_applicable_lawApplicable law
azoth_regulatory_changesRegulatory changes
azoth_compliance_coverageCompliance coverage
azoth_evidence_summaryThis quarter's evidence
azoth_workspace_healthWorkspace health
azoth_footprintEnergy and carbon
azoth_support_docsSearch the documentation
azoth_support_changelogWhat changed in Azoth
azoth_support_statusService status
azoth_support_errorError code explained
azoth_journal_querySearch the decision journal
azoth_evidence_exportEvidence pack
azoth_export_dossierExport a verifiable dossier
azoth_system_modulesSystem 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 من هذه الاستدعاءات موصوف في سياسة الخصوصية الخاصة بها.
الموصل البعيد
الموصل البعيد غير مفعّل في هذا النشر.