# 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 من هذه الاستدعاءات موصوف في [سياسة الخصوصية الخاصة بها](https://www.azothos.ai/legal/privacy).

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

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