API ومساعدو الذكاء الاصطناعي

اقرأ مقاييسك من شيفرتك الخاصة عبر REST API، أو من Claude وChatGPT وCursor عبر MCP.

مساعدو الذكاء الاصطناعي (MCP)

يشغّل RevGlance خادم MCP، فيستطيع مساعدو الذكاء الاصطناعي قراءة مقاييسك بالفحوص والتقارير نفسها التي يستخدمها Ask. لا يستدعون نموذج RevGlance أبدًا ولا يستهلكون أي أسئلة.

تعرض الإعدادات › مساعدو الذكاء الاصطناعي عنوان الخادم مع خطوات كل عميل. باختصار:

أضف RevGlance كموصّل مخصّص باستخدام العنوان من تلك الصفحة، المنتهي بـ /mcp.
سجّل الدخول إلى RevGlance عندما يطلب المساعد ذلك. توضّح شاشة الموافقة ما يمكنه قراءته وما لا يمكنه.
اسأل ما تشاء. يُحفظ كل استعلام كإجابة مع رابط عرض الحساب الخاص بها.

لـ Claude Code:

bash

claude mcp add --transport http revglance https://your-revglance-address/mcp

ثم شغّل /mcp في Claude Code لتسجيل الدخول.

يحصل المساعد على أربع أدوات للقراءة فقط:

list-businesses: الأنشطة التجارية التي يمكنك قراءتها، مع عملتها ودورك وكل مصدر ووقت آخر مزامنة له.
describe-data: ما يمكن السؤال عنه في نشاط تجاري واحد: كل مقياس مع معناه ووحدته، والأشهر التي تتوفر فيها بيانات، والخطط وفترات الفوترة والبلدان والمصادر والسمات التي يمكنها تصفية الاستعلام أو تقسيمه.
query-metrics: مقياس واحد أو أكثر عبر نطاق من الأشهر، مصفّى ومقسّم كما في صفحات المقاييس. يتحقق RevGlance من كل اسم، ويذكر ما غيّره، ويحسب بالتقارير نفسها، ويحفظ كل إجابة مع رابط عرض الحساب.
explain-figure: الحساب وراء رقم واحد: صيغته محسوبة وأكبر الصفوف التي يتكوّن منها. في وضع الخصوصية يظهر العملاء كتسميات قصيرة.

تسرد الإعدادات › مساعدو الذكاء الاصطناعي أيضًا من ربط أي عميل وما سأله كل منهم، وتتيح فصل أحدهم مع إلغاء رموزه. لا يمكن للعرض التجريبي ولا للفترات التجريبية المنتهية الربط.

REST API

واجهة REST API للقراءة فقط على /api/v1، في الخطط المدفوعة.

أنشئ مفتاحًا في الإعدادات › مفاتيح API. يُعرض مرة واحدة فقط.
أرسله كرمز bearer: Authorization: Bearer <key>.

bash

curl https://your-revglance-address/api/v1/businesses \
  -H "Authorization: Bearer $REVGLANCE_KEY" \
  -H "Accept: application/json"

تغطي الأنشطة التجارية، وكتالوج المقاييس، والمقاييس بعوامل التصفية والتقسيم نفسها التي في صفحات المقاييس (كل رقم مع رابط عرض الحساب)، وشرح لماذا، والعملاء والدفعات مع ترقيم الصفحات بالمؤشر. يُطبَّق وضع الخصوصية كما على الشاشة. يمكن لكل مفتاح إجراء 120 طلبًا في الدقيقة، ويُسجَّل كل طلب في صفحة المفاتيح، وتنتهي صلاحية المفاتيح بعد عام. لا تعمل مفاتيح API أبدًا مع MCP.

المرجع الكامل، بكل نقطة نهاية وحقل، موجود في مرجع REST API.