ربط Claude وChatGPT ووكلاء ذكاء اصطناعي آخرين

يشغّل OneBooks خادم MCP (بروتوكول Model Context Protocol) حتى يتمكن وكلاء الذكاء الاصطناعي الذين تستخدمهم بالفعل من العمل على دفاترك: استخراج التقارير، والبحث في السجلات، والبحث في هذه المستندات، وتجهيز المستندات التي تؤكدها أنت. وهم يحصلون على الأدوات نفسها التي يملكها المساعد داخل التطبيق، وبالقاعدة نفسها — لا يُكتب شيء قبل أن يوافق عليه إنسان.

عنوان الخادم

https://api.getonebooks.com/mcp — نقل Streamable HTTP مع تسجيل دخول OAuth. لا توجد مفاتيح API لنسخها.

يستطيع وكيل ذكاء اصطناعي مدمج في متصفحك، مثل الوكيل في تطبيق ChatGPT لسطح المكتب، استخدام OneBooks أيضًا دون أي ربط — راجع وكلاء الذكاء الاصطناعي في متصفحك (WebMCP).

اختر عميلك

Claudeclaude.ai وتطبيق Claude لسطح المكتبClaude Codeالوكيل في الطرفيةChatGPTالويب وتطبيق سطح المكتب، كموصّل مخصصOpenClawوكيلك الخاص الذي يعمل دائمًا

يرتبط Cursor وVS Code وMCP Inspector والوكلاء المخصصون بالطريقة نفسها — راجع قسم عملاء MCP الآخرين أدناه.

ما تحتاج إليه

• حساب في OneBooks. يرث الوكيل دورك: يحصل المشاهد على أدوات للقراءة فقط، ويستطيع العضو اقتراح المستندات، ولا يستطيع افتراضيًا اقتراح مدفوعات العملاء والموردين وتخصيص الدفعات وقيود التحويل وقيود اليومية وتغييرات الحسابات والموازنات إلا المالك أو المدير. ويحتاج اقتراح تعديل بيانات عميل أو مورد إلى صلاحية إدارة العملاء أو الموردين، وهي لكل عضو افتراضيًا.
• يصل Claude وChatGPT إلى OneBooks من خوادمهما؛ بينما يتصل Claude Code وOpenClaw من حاسوبك. وفي الحالتين يسجّل العميل الدخول عبر شاشة الموافقة أدناه — لا بمفتاح منسوخ أبدًا.

الموافقة على الوصول

عند اتصال العميل للمرة الأولى، يفتح OneBooks شاشة تسجيل الدخول والموافقة.

1. سجّل الدخول ببريدك الإلكتروني وكلمة مرورك في OneBooks إن لم تكن مسجلًا بالفعل.
2. تحقق من النشاط التجاري المذكور على الشاشة — يُمنح الوصول إلى نشاطك التجاري النشط فقط.
3. راجع ما سيتمكن التطبيق من فعله، ثم اختر موافقة (أو رفض).

يؤدي تبديل نشاطك التجاري النشط في OneBooks إلى إنهاء الاتصال؛ اربط مجددًا ووافق للنشاط التجاري الجديد.

Claude

Claude على الويب وClaude Desktop

الموصّلات المخصصة متاحة في كل خطط Claude (تسمح الخطة المجانية بموصّل واحد). ويتصل Claude بـ OneBooks من خوادم Anthropic، لذا يعمل الموصّل الذي تضيفه مرة واحدة في المتصفح وفي Claude Desktop على حد سواء.

1. افتح التخصيص → الموصّلات. في خطتي Team وEnterprise يضيفه المالك من إعدادات المؤسسة → الموصّلات → إضافة → مخصص؛ ثم يختار الأعضاء ربط.
2. اختر إضافة موصّل مخصص، وسمّه OneBooks، وأدخل https://api.getonebooks.com/mcp. اترك حقول OAuth المتقدمة فارغة — يعرّف Claude نفسه لـ OneBooks تلقائيًا.
3. اختر ربط ووافق على الوصول في شاشة OneBooks.
4. في أي محادثة، افتح قائمة +، واختر الموصّلات وفعّل OneBooks. ثم اسأل: «ما موقفنا النقدي؟»

Claude Code

Claude Code

سجّل الخادم مرة واحدة لكل مشاريعك، ثم سجّل الدخول من لوحة /mcp:

claude mcp add --transport http onebooks --scope user https://api.getonebooks.com/mcp

داخل Claude Code شغّل /mcp، واختر onebooks وأكمل تسجيل الدخول في المتصفح. يعرض claude mcp list الاتصال، ويزيله claude mcp remove onebooks. يعرّف Claude Code نفسه بمستند بيانات تعريف العميل، فلا حاجة إلى أي تسجيل.

ChatGPT

ChatGPT على الويب وفي تطبيق سطح المكتب

يضيف ChatGPT ‏OneBooks على هيئة خادم MCP مخصص — وهو المسار الذي كان يُسمى سابقًا وضع المطور. ويتوقف توفره على خطة ChatGPT الخاصة بك، وقد يحتاج مسؤول مساحة العمل إلى السماح بالموصّلات المخصصة أولًا. أعدّه مرة واحدة على الويب؛ ينتمي الموصّل إلى حساب ChatGPT الخاص بك.

1. افتح الإعدادات → الموصّلات واختر إضافة خادم MCP مخصص.
2. سمّه OneBooks، وأدخل https://api.getonebooks.com/mcp، واختر OAuth للمصادقة، وأكّد أنك تثق بالمزوّد.
3. وافق على الوصول في شاشة OneBooks.
4. في محادثة جديدة افتح قائمة +، وفعّل OneBooks لتلك المحادثة، واسأل ما شئت.

في البحث والبحث المعمّق، يستخدم ChatGPT أداتين للقراءة فقط — search وfetch — تعثران على فواتيرك ومشترياتك وعملائك ومورديك وأصنافك وتقتبسانها، في حدود السجلات التي يتيحها لك دورك. أما التقارير وصياغة المستندات فتستخدم بقية الأدوات في محادثة فُعّل فيها OneBooks.

OpenClaw

OpenClaw

OpenClaw وكيل شخصي مفتوح المصدر يعمل على جهازك ويتواصل معك عبر تطبيقات المراسلة.

1. افتح الإعدادات → MCP، واختر إضافة خادم، وسمّه onebooks، واختر نقل Streamable HTTP، وأدخل https://api.getonebooks.com/mcp.
2. اضبط مصادقة الخادم على OAuth (يظهر إدخال الإعدادات أدناه).
3. شغّل openclaw mcp login onebooks. يفتح المتصفح شاشة الموافقة في OneBooks ويخزّن OpenClaw الرموز؛ وإذا تعذّر على المتصفح الوصول إلى رابط الاستدعاء في OpenClaw، فاستخدم أمر --code الذي يطبعه.
4. يؤكد openclaw mcp status --verbose نجاح الاتصال.

يبدو إدخال الخادم في ملف إعدادات OpenClaw هكذا:

{
  mcp: {
    servers: {
      onebooks: {
        url: "https://api.getonebooks.com/mcp",
        transport: "streamable-http",
        enabled: true,
        auth: "oauth",
      },
    },
  },
}

عملاء MCP آخرون

يستطيع أي عميل يدعم Streamable HTTP وOAuth 2.0 مع PKCE الاتصال — Cursor وVS Code وWindsurf وMCP Inspector والوكلاء المخصصون. وحين يعتمد العميل على ملف إعدادات، يكون الإدخال:

{
  "mcpServers": {
    "onebooks": { "type": "http", "url": "https://api.getonebooks.com/mcp" }
  }
}

يكتشف العميل خادم تسجيل الدخول، ويسجّل نفسه (أو يقدّم مستند بيانات تعريف العميل)، ويفتح شاشة الموافقة.

ما يستطيع الوكيل فعله

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

وتتم الكتابة هنا أيضًا على خطوتين. يطلب الوكيل من OneBooks تجهيز المستند؛ فيخزّن OneBooks اقتراحًا ويعيد معاينة يعرضها الوكيل عليك. ولا يؤكد الوكيل الاقتراح إلا بعد موافقتك على تلك المعاينة بعينها — ليس في الدور نفسه أبدًا، ومرة واحدة فقط، وخلال 24 ساعة. والاقتراح الذي لا توافق عليه لا يُنفَّذ أبدًا؛ إذ تنتهي صلاحيته تلقائيًا بعد 24 ساعة. ولا توجد أدوات حذف أو إبطال أو استرداد لأي وكيل، وأدوات التعديل الوحيدة تغيّر مسودة فاتورة أو مشتريات، أو صنفًا، أو حسابًا، أو مبالغ موازنة، أو بيانات عميل أو مورد — ولا تمسّ مستندًا مرحَّلًا ولا بيانات بنكية أبدًا.

إدارة الوصول وإلغاؤه

تعرض التطبيقات → التكاملات مع فلتر التطبيقات المتصلة عملاء الذكاء الاصطناعي المرتبطين بنشاطك التجاري، كلٌّ باسمه وشعاره، مع تاريخ التفويض وآخر استخدام.

اختر بطاقة لترى ما يستطيع التطبيق فعله ولتختار إلغاء الوصول. تتوقف رموزه عن العمل فورًا؛ ولا يُحذف أي شيء أنشأه من قبل.

الحدود

300 طلب في الدقيقة لكل عميل ذكاء اصطناعي متصل بنشاطك التجاري، وحد أسبوعي للاستدعاءات لكل نشاط تجاري، ومخصص أرصدة الذكاء الاصطناعي الأسبوعي الذي تتضمنه خطتك — 100 رصيد في المجانية، و400 في Standard، و1,200 في Professional، و3,000 في Premium — وهو مشترك مع المساعد المدمج. راجع الأرصدة والحدود.

استكشاف الأخطاء وإصلاحها

• تعرض شاشة الموافقة نشاطًا تجاريًا خاطئًا — بدّل نشاطك التجاري النشط في OneBooks أولًا، ثم اربط مجددًا.
• توقف العميل عن العمل بعد تبديل النشاط التجاري — هذا متوقع؛ اربط مجددًا ووافق للنشاط التجاري الجديد.
• الأدوات ناقصة — يحصل المشاهد على أدوات القراءة فقط، وتحتاج المدفوعات والتخصيصات وقيود التحويل وقيود اليومية وتغييرات الحسابات واقتراحات الموازنات (create_budget وupdate_budget_lines) افتراضيًا إلى مالك أو مدير، ويحتاج تعديل عميل أو مورد إلى صلاحية إدارتهم، وفي ChatGPT يجب تفعيل OneBooks للمحادثة. والعميل الذي رُبط قبل إضافة عروض الأسعار والمرتجعات وقيود اليومية والمطابقة البنكية (أكتوبر 2026) لا يراها إلا بعد أن تربطه من جديد وتوافق مرة واحدة على الصلاحيات الجديدة. وقد أُضيفت أدوات الموازنات في 15 أكتوبر 2026، فالعميل الذي رُبط قبل ذلك لا يراها إلا بعد أن تربطه من جديد وتوافق مرة واحدة على صلاحيات الموازنات، إذ يحتفظ الاتصال القائم بالصلاحيات التي وافقت عليها.
• يبلّغ الوكيل عن نفاد الأرصدة — يتجدد المخصص كل 7 أيام بدءًا من لحظة تسجيل نشاطك التجاري؛ راجع الأرصدة والحدود.
• لا يعرض OpenClaw شيئًا بعد الموافقة — تعذّر على المتصفح الوصول إلى رابط الاستدعاء المحلي؛ شغّل أمر --code المطبوع في الطرفية.

للمطورين

هل تبني عميل MCP أو تكاملًا خاصًا بك؟ تغطي مستندات المطورين على developer.getonebooks.com بروتوكول OAuth والنطاقات والتسجيل الديناميكي ومستندات بيانات تعريف العميل ومرجع واجهة برمجة التطبيقات.

ذات صلة

الأمان والخصوصية والحدود

التطبيقات المتصلة وOAuth

إدارة التطبيقات المثبَّتة