مدفوعات وكلاء الذكاء الاصطناعي: خادم MCP لـ Claude Code
تحمل مدفوعات وكلاء الذكاء الاصطناعي معنيين. الأول وكلاء يدفعون: مساعد ذكاء اصطناعي يشتري شيئًا أو يدفع ثمن استدعاء API بنفسه، عبر بروتوكول دفع مثل x402. والثاني وكلاء يديرون مدفوعات نشاط تجاري: وكيل برمجة مثل Claude Code يُنشئ صفحة دفع أو اشتراكًا أو منتجًا عبر استدعاء واجهة دفع من خلال خادم MCP.
تقدم OrcaRail المعنى الثاني اليوم. يتيح خادم MCP الخاص بها لـ Claude Code وCursor وCodex إنشاء payment intents واشتراكات بالعملات الرقمية يدفعها عملاؤك بـ USDC أو USDT أو رموز أخرى. يشرح هذا المقال المعنيين، ويشرح ما يفعله خادم MCP من OrcaRail، ويوضح كيف تربطه بأمان في بيئة تجريبية.
ما هي مدفوعات وكلاء الذكاء الاصطناعي
| وكلاء يدفعون | وكلاء يديرون المدفوعات | |
|---|---|---|
| ما الذي يحدث | يدفع الوكيل لتاجر أو API نيابة عن مستخدمه | يُنشئ الوكيل صفحات دفع واشتراكات ومنتجات لنشاطك التجاري |
| من يدفع | الوكيل، بأموال يسمح بها مستخدمه | عميلك، على صفحة دفع أنشأها الوكيل |
| يعتمد على | بروتوكولات دفع مثل x402 وAP2 وACP | واجهة دفع وخادم MCP الخاص بها |
| مثال | وكيل يدفع عن كل طلب لاستخدام API مدفوعة | «أنشئ رابط دفع بقيمة 25 USD بعملة USDC وأعطني إياه» |
| OrcaRail اليوم | غير متاح | نعم: خادم @orcarail/mcp |
بروتوكولات الدفع لوكلاء الذكاء الاصطناعي: x402 وAP2 وACP
تحدد هذه البروتوكولات كيف يدفع الوكيل. هكذا يصف كل منها نفسه، بحسب ما تحققنا منه في 11 نوفمبر 2026:
- x402 يقدّم نفسه معيارًا مفتوحًا ومحايدًا للمدفوعات الأصلية على الإنترنت. عندما يصل طلب دون دفع، يرد الخادم بـ HTTP 402 (Payment Required)، فيدفع العميل ويعيد المحاولة. ويذكر الموقع أن x402 يعمل على سلاسل EVM وSolana، وأن الدفع بالعملات المستقرة هو الاستخدام الرئيسي.
- AP2 أو Agent Payments Protocol بروتوكول مفتوح لاقتصاد الوكلاء نشرته Google (الإعلان). ويتضمن موقعه أمثلة تدفع عبر x402.
- ACP أو Agentic Commerce Protocol معيار مفتوح لعمليات الشراء البرمجية بين المشترين ووكلاء الذكاء الاصطناعي والشركات.
لا تقدم OrcaRail اليوم مدفوعات عبر x402 أو AP2 أو ACP. إذا كنت تبيع للناس، فما زلت تحتاج إلى صفحات دفع واشتراكات وwebhooks، ويتيح خادم MCP للوكيل أن يُنشئها ويديرها نيابة عنك.
واجهات الدفع التي لديها خادم MCP لـ Claude Code
يمنح خادم MCP (Model Context Protocol) وكيل الذكاء الاصطناعي مجموعة أدوات لواجهة API واحدة. تقدّم OrcaRail خادمها باسم @orcarail/mcp:
- طريقة التشغيل: محليًا عبر stdio، مع Node.js 18 أو أحدث.
- طريقة الاتصال: مفتاح API والسر من OrcaRail، يُمرَّران كمتغيرات بيئة.
- العملاء: Claude Code وCursor وCodex وClaude Desktop وأي عميل يدعم خوادم MCP عبر stdio.
- ما يفعله: يُنشئ صفحات دفع واشتراكات بالعملات الرقمية تُدفع بـ USDC وUSDT ورموز أخرى، وتُحوَّل كل دفعة إلى محافظك الخاصة.
يضيفه Claude Code عبر claude mcp add، كما هو موضح أدناه.
ما الذي يفعله خادم MCP من OrcaRail
لدى @orcarail/mcp 27 أداة، أسماؤها بصيغة resource.action:
| المجموعة | الأدوات | يحتاج مفتاح API |
|---|---|---|
| Payment intents | payment_intents.create و.retrieve و.update و.confirm و.complete و.cancel و.simulate (في البيئة التجريبية فقط) | نعم |
| الاشتراكات | subscriptions.create و.retrieve و.update و.cancel و.resume و.list و.list_payment_links | نعم |
| المنتجات | products.list و.create و.update و.delete | نعم |
| الأسعار | prices.list و.create و.update و.deactivate | نعم |
| الحساب | account.get_mode | لا |
| أسعار الصرف | rates.get_fiat_quote وrates.list_currencies | لا |
| صفحات الدفع المستضافة | pay.get_by_slug وpay.cancel_by_slug | لا |
تتحدث إليه بلغة عادية، مثل:
- «أنشئ منتجًا اسمه Pro Plan بسعر متكرر 29 USD شهريًا.»
- «اعرض اشتراكاتي النشطة وألغِ اشتراك
[email protected]في نهاية الفترة.» - «كم تساوي 500 EUR بعملة USDC الآن؟»
- «ما حالة payment intent
550e8400-…؟»
تحتاج payment intents والأسعار إلى معرّف رمز ومعرّف شبكة (UUID)، ولا توجد في الخادم أداة تعرضها. أعطِ الوكيل المعرّفات من الشبكات والرموز، أو استخدم سعرًا أنشأته مسبقًا (price_id).
كيف تربط Claude Code بـ OrcaRail
-
أنشئ بيئة تجريبية. سجّل في app.orcarail.com، وأنشئ منظمة تجريبية ومفتاح API من نوع
ak_test_مع السر الخاص به. تعمل البيئة التجريبية على الشبكات التجريبية فقط، فلا تتحرك أموال حقيقية. -
أضف الخادم إلى Claude Code. يحتاج إلى Node.js 18 أو أحدث. مرّر المفتاح كمتغيرات بيئة، لا كخيارات في سطر الأوامر:
claude mcp add orcarail \-e ORCARAIL_API_KEY=ak_test_xxx \-e ORCARAIL_API_SECRET=sk_test_xxx \-- npx -y @orcarail/mcp --tools=all -
تحقق منه عبر
claude mcp list. ثم اسأل Claude Code: «في أي وضع من OrcaRail أنا؟». سيستدعيaccount.get_mode، ويجب أن يُرجعsandbox. -
أنشئ صفحة دفع. مثلًا: «أنشئ payment intent للسعر
<price-id>مع رابط العودةhttps://example.com/thanks، وأكّده، وأعطني رابط الدفع.» يستدعي الوكيلpayment_intents.createثمpayment_intents.confirm. -
اختبره. اطلب: «حاكِ الدفعة.» تُكمل أداة
payment_intents.simulateالـ payment intent دون محفظة وتُرسل الـ webhooks المعتادة. لا يمكن سحب الدفعات المحاكاة أبدًا. في الدفعة الحقيقية، استدعِpayment_intents.completeبعد عودة العميل إلى رابط النجاح لديك؛ وحتى ذلك الحين لا تكون الدفعة نهائية. -
قيّد الأدوات. استبدل
--tools=allبما يحتاجه الوكيل فقط، مثل--tools=payment_intents.create,payment_intents.retrieve,subscriptions.list، حتى لا يستطيع إلغاء الاشتراكات أو حذف المنتجات. -
انتقل إلى الإنتاج عندما تكون جاهزًا فقط، بمفتاح
ak_live_لمنظمة حية. في الوضع الحي، يُبلغ الخادم الوكيل بأن الأموال حقيقية ويطلب منه تأكيد أي create أو confirm أو complete أو cancel أو update أو delete معك أولًا.
تستخدم Cursor أو Codex؟ أضف الأمر نفسه إلى .cursor/mcp.json أو ~/.codex/config.toml. يحتوي دليل خادم MCP على ملف الإعداد لكل منهما.
قواعد الأمان عند منح وكيل صلاحية الدفع
- ابدأ في بيئة تجريبية. يعمل مفتاح
ak_test_على الشبكات التجريبية فقط. أما المفتاح الحي فينقل أموالًا حقيقية. - أبعد المفاتيح عن سجل الطرفية وعن git. استخدم متغيرات البيئة، ولا ترفع أبدًا ملف إعداد يحتوي على مفتاح حي.
- افتح الأدوات التي تحتاجها فقط عبر
--tools. - تحقق من الوضع قبل أي عملية كتابة. يُرجع
account.get_modeإحدى القيمliveأوsandboxأوpublic. - غيّر المفتاح من لوحة التحكم إذا احتمل أنه تسرّب.
لا يحتفظ الوكيل بالأموال أبدًا. يدفع العملاء على صفحة الدفع المستضافة، وتُحوَّل كل دفعة إلى عناوين سحب تتحكم فيها.
ابنِ بقية التكامل بالذكاء الاصطناعي
يدير خادم MCP المدفوعات. ولبناء التكامل داخل تطبيقك، أعطِ الوكيل التوثيق كنص عادي: يعرض llms.txt كل الصفحات، ويقدم البناء بالذكاء الاصطناعي نصائح عملية. وللكود نفسه، راجع تكامل بوابة الدفع ودليل واجهة API للدفع بالعملات المستقرة.
الأسئلة الشائعة
هل من الآمن إعطاء وكيل ذكاء اصطناعي مفتاح API للدفع؟
استخدم مفتاحًا تجريبيًا أثناء البناء: يعمل مفتاح ak_test_ على الشبكات التجريبية فقط، فلا تتحرك أموال حقيقية. قبل استخدام مفتاح حي، قيّد الأدوات عبر --tools، واحفظ المفتاح في متغيرات البيئة، واجعل الوكيل يؤكد كل عملية كتابة معك، وهو ما يطلبه خادم OrcaRail في الوضع الحي. وغيّر أي مفتاح قد يكون تسرّب.
أي واجهات الدفع لديها خادم MCP لـ Claude Code؟
لدى OrcaRail خادم: @orcarail/mcp. يضيفه Claude Code عبر claude mcp add، ويُنشئ صفحات دفع واشتراكات بالعملات الرقمية تُدفع بـ USDC وUSDT ورموز أخرى. راجع دليل خادم MCP.
ما هو بروتوكول الدفع لوكلاء الذكاء الاصطناعي؟
معيار يحدد كيف يدفع الوكيل. يستخدم x402 رمز الحالة HTTP 402 ليدفع العميل ثمن طلب ثم يعيده، غالبًا بالعملات المستقرة. وAP2 الذي نشرته Google بروتوكول مفتوح لمدفوعات الوكلاء. أما ACP فيغطي صفحة الدفع ومشاركة بيانات الدفع بين الوكلاء والشركات.
هل يمكن لوكيل ذكاء اصطناعي قبول الدفع بالعملات الرقمية لنشاطي التجاري؟
نعم، عبر خادم MCP. مع OrcaRail يُنشئ الوكيل payment intent ويعطيك رابط صفحة الدفع المستضافة. يدفع عميلك بـ USDC أو USDT أو رمز مدعوم آخر، وتُحوَّل الدفعة إلى محافظك. تتقاضى OrcaRail 0.5% لكل معاملة مكتملة، وأول 100 معاملة مجانية. راجع الأسعار.
هل تدعم OrcaRail بروتوكول x402؟
ليس اليوم. أدوات OrcaRail لوكلاء الذكاء الاصطناعي هي خادم MCP والتوثيق النصي، ويدفع العملاء عبر صفحات الدفع المستضافة والاشتراكات.