MCP وواجهات البرمجة (API)mcp.remote-pro.ai

OAuth 2.1 لخادم MCP وواجهة REST

تستخدم Remote Pro Ai معيار OAuth 2.1 لتفويض الوصول إلى ميزات الحساب في أدوات MCP وواجهة REST. يسجل العميل نفسه ديناميكيًا، ويشغّل تدفق رمز التفويض مع PKCE، ويحصل على رموز وصول صالحة 60 دقيقة. يوافق المستخدم على كل نطاق في شاشة موافقة بالعربية أو الإنجليزية، ويستطيع إلغاء الوصول في أي وقت.

معاينة للمطورين حتى الإطلاق: خادم MCP وواجهة المنصة البرمجية لا يعملان بعد. تصف الأدوات ونقاط الاتصال والأمثلة في هذه الصفحات الواجهة التي نبنيها، ولا يعيد أي استدعاء اليوم نتيجة.

تسجيل عميل OAuth 2.1 لخادم MCP

Discoveryيشير ‎https://mcp.remote-pro.ai/.well-known/oauth-protected-resource إلى بيانات خادم التفويض في ‎https://mcp.remote-pro.ai/.well-known/oauth-authorization-server.
Registration‎POST https://mcp.remote-pro.ai/oauth/register وفق RFC 7591. أرسل client_name وredirect_uris والنطاقات التي تحتاجها.

تفضّل عميلًا ثابتًا؟ يمكن لمسؤول المؤسسة إنشاؤه في Client OS من الإعدادات › التكاملات.

POST /oauth/register
{
  "client_name": "Acme Procurement Assistant",
  "redirect_uris": [
    "https://assistant.acme.example/callback"
  ],
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "token_endpoint_auth_method": "none",
  "scope": "proposals:read proposals:write"
}

النطاقات (proposals:read، squads:read، …)

النطاقما يسمح به
proposals:readقراءة عروض مؤسستك وتقديراتها
proposals:writeإنشاء مسودات عروض في Client OS
squads:readقراءة الفرق والأعضاء وحالة المهندسين
timesheets:readقراءة سجلات الساعات المرسلة والمعتمدة
invoices:readقراءة الفواتير والتعويضات وملفات الفاتورة الإلكترونية
documents:readقراءة البيانات الوصفية للعقود والشهادات

لا توجد نطاقات كتابة لسجلات الساعات أو الفواتير أو العقود. ويجري الاعتماد والدفع والتوقيع دائمًا في Client OS.

نخطط لإتاحة أدوات حساب إضافية في 2027.

تدفق رمز التفويض مع PKCE

  1. 1أنشئ code_verifier واحسب code_challenge بطريقة S256.
  2. 2وجّه المستخدم إلى ‎/oauth/authorize مع client_id وredirect_uri وscope وstate وcode_challenge وcode_challenge_method=S256.
  3. 3يسجل المستخدم الدخول إلى Client OS (عبر SSO أو مفتاح مرور أو رمز البريد) ويوافق على النطاقات.
  4. 4استبدل الرمز عبر ‎/oauth/token مع code_verifier.
  5. 5استدعِ خادم MCP أو واجهة REST مع الترويسة Authorization: Bearer access_token.

PKCE إلزامي لكل عميل. التدفق الضمني وتحديات PKCE غير المشفرة (plain) غير مدعومة.

ClientUserRemote Pro Aicode_verifier → S256 code_challenge/oauth/authorizeSSO · passkey · email code → approve scopesredirect_uri?code=…&state=…POST /oauth/token + code_verifieraccess_token (60 min) + refresh_tokenAuthorization: Bearer <access_token>

صلاحية الرموز وتجديدها

  • رموز الوصول: 60 دقيقة.
  • رموز التجديد: 30 يومًا، وتُستبدل مع كل استخدام. إعادة استخدام رمز تجديد قديم تُلغي السلسلة كلها.
  • الرموز مرتبطة بمؤسسة واحدة؛ والمستخدم الذي ينتمي إلى عدة مؤسسات يفوّض كل منها على حدة.

الإلغاء

Endpoint‎POST https://mcp.remote-pro.ai/oauth/revoke وفق RFC 7009.

يستطيع المستخدمون والمسؤولون أيضًا إلغاء أي مساعد متصل من Client OS في الإعدادات › التكاملات. ويسري الإلغاء فورًا.

شاشة الموافقة (EN/AR)

Consent titleيطلب client_name الوصول إلى org_name
Consent bodyيتيح هذا لـ client_name العمل نيابة عنك في Remote Pro Ai. يمكنه:
  • رؤية عروضك وتقديراتك
  • إنشاء مسودات عروض
  • رؤية فرقك ومهندسيك
  • رؤية سجلات الساعات
  • رؤية الفواتير
  • رؤية تفاصيل العقود
Consent noteلا يستطيع اعتماد أي شيء أو الدفع أو التوقيع. يمكنك إلغاء الوصول في أي وقت من الإعدادات › التكاملات.

تتبع الشاشة لغة المستخدم؛ والنسخة العربية من اليمين إلى اليسار بأسطر النطاقات نفسها.

الأسئلة الشائعة

ليس للأدوات العامة الخمس. يلزم OAuth لميزات الحساب فقط: التقديرات بأسعارك المتعاقد عليها، والعروض المحفوظة في Client OS، وواجهة REST للفرق وسجلات الساعات والفواتير والمستندات. ويوافق المستخدم على كل نطاق في شاشة الموافقة قبل أي وصول.

رمز التفويض مع PKCE بطريقة S256 كما يشترط OAuth 2.1، إضافة إلى رموز التجديد. لا ندعم التدفق الضمني ولا منح كلمة المرور ولا تحديات PKCE غير المشفرة. ويمكن للعملاء التسجيل ديناميكيًا وفق RFC 7591، أو أن ينشئهم مسؤول المؤسسة في Client OS.

رموز الوصول صالحة 60 دقيقة. ورموز التجديد صالحة 30 يومًا وتُستبدل مع كل استخدام؛ وإن أُعيد استخدام رمز تجديد قديم تُلغى السلسلة كلها حمايةً للحساب. وعند انتهاء رمز التجديد يسجل المستخدم الدخول ويوافق على النطاقات من جديد، ويستطيع المسؤول إلغاء الرموز في أي وقت.

لا. كل النطاقات للقراءة فقط باستثناء proposals:write الذي ينشئ مسودات. أما الاعتماد والدفع والتوقيع فتتم دائمًا في Client OS بجلسة المستخدم نفسه، ومع تأكيد هوية إضافي حيث يلزم. وحتى مع الموافقة على كل النطاقات، لا يستطيع المساعد إلا قراءة بيانات الحساب وإنشاء مسودات يراجعها شخص.

يستطيع أي مسؤول إلغاءه من Client OS في الإعدادات › التكاملات، كما يستطيع ذلك المستخدم الذي فوّضه. ويستطيع المطورون استدعاء نقطة الإلغاء. يسري الإلغاء فورًا، ويجب أن يطلب المساعد موافقة المستخدم من جديد ليعيد الاتصال.