Stripe MCP — حالات الاستخدام, التثبيت & عرض مباشر

Name: Stripe MCP Server
Author: stripe

لماذا تستخدمه

الميزات الأساسية

قراءة والكتابة عبر موارد Stripe الأساسية
تبديل وضع الاختبار والوضع المباشر عبر مفتاح API
بحث قوي (استعلامات بنمط stripe.search)
اختيار الأدوات عبر حجة سطر الأوامر --tools= — قيّد على القراءة فقط للأمان
يتم صيانتها مباشرة بواسطة Stripe

عرض مباشر

كيف يبدو في الممارسة

stripe.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "stripe",
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "stripe": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@stripe/mcp",
          "--tools=all"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add stripe -- npx -y @stripe/mcp --tools=all

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Stripe

التحقيق من سبب فشل رسوم العميل

👤 مهندسو الدعم والمؤسسون الذين يقومون بدعم الدرجة الأولى ⏱ ~10 min beginner

متى تستخدمه: يقول العميل 'تم رفض بطاقتي 3 مرات'. تريد رؤية ما حدث فعلياً على جانب Stripe.

المتطلبات الأساسية

مفتاح API مقيد من Stripe مع قراءة الرسوم والعملاء — dashboard.stripe.com/apikeys → Restricted keys → امنح صلاحية القراءة على Customers و Charges و Payment intents

الخطوات

ابحث عن العميل

ابحث عن عميل Stripe برسالة بريد إلكترونية '[email protected]'. اعرض طريقة الدفع الافتراضية والإنفاق الإجمالي.✓ تم النسخ

→ سجل العميل مع تفاصيل طريقة الدفع
اسحب الرسوم الفاشلة الأخيرة

اعرض رسوم هذا العميل في آخر 30 يوم حيث status != 'succeeded'. لكل منها، اعرض كود الفشل والرسالة.✓ تم النسخ

→ قائمة الفشل مع أكواد مثل card_declined أو expired_card وإلخ
اشرح وقدم توصية

ما هي المشكلة الفعلية؟ قدم توصية بما يجب إخبار العميل به (مثلاً 'انتهت صلاحية البطاقة — يرجى التحديث' أو 'حجب احتيالي — جرب بطاقة مختلفة').✓ تم النسخ

→ شرح واضح يمكن توجيهه للعميل

النتيجة: تذكرة دعم محلولة مع السبب الفعلي، وليس 'حاول لاحقاً'.

المزالق

التركيز على الرسوم فقط — تجاهل نوايا الدفع التي لم تتحول إلى رسوم — تحقق أيضاً من Payment Intents مع الحالة 'requires_payment_method' أو 'canceled'
يقول العميل 'مرفوضة' لكنها كانت تخلياً عن 3DS — تحديات 3DS التي يغلقها المستخدم تظهر على أنها 'requires_action' ثم تنتهي؛ تحقق من الخط الزمني

أنشئ فاتورة اختبار ورابط دفع لصفقة

👤 أشخاص المبيعات والعمليات الذين يغلقون صفقات مخصصة ⏱ ~5 min beginner

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

المتطلبات الأساسية

مفتاح وضع الاختبار (sk_test_...) — ابدأ دائماً في وضع الاختبار. انتقل إلى مفتاح مباشر فقط بعد التحقق من التدفق.

الخطوات

ابحث عن العميل أو أنشئه

ابحث عن عميل Stripe برسالة بريد إلكترونية '[email protected]'. إذا لم يكن موجوداً، أنشئ واحداً باسم 'BigCo Inc'.✓ تم النسخ

→ معرف العميل مُرجع
أنشئ سعراً لمرة واحدة وبند فاتورة

أنشئ بند فاتورة لمرة واحدة: $4,500، الوصف 'خدمات الإعداد للربع الثاني'. أرفقه بذلك العميل. ثم أنشئ وأنهِ الفاتورة.✓ تم النسخ

→ فاتورة بها hosted_invoice_url
تأكد من النتيجة النهائية

أعطني رابط الفاتورة المستضاف وملخص ما تم إنشاؤه. لا ترسله بالبريد الإلكتروني — سأرسله يدوياً.✓ تم النسخ

→ رابط + ملخص؛ لا توجد رسائل بريد إلكترونية مفاجئة مرسلة

النتيجة: فاتورة يمكنك إرسالها إلى العميل في 90 ثانية.

المزالق

إرسال رسائل بريد إلكترونية تلقائية للعملاء من المحادثة أمر خطير للغاية — استخدم auto_advance: false وتخطَّ send_invoice حتى تراجعت؛ لا يجب أن ترسل MCP رسائل بريد إلكترونية للعملاء بالإنتاج دون تأكيد صريح
الخلط بين وضع الاختبار والوضع المباشر يعني تدفق أموال حقيقية لـ 'اختبار' — تفقد دائماً بادئة مفتاح API (sk_test_ مقابل sk_live_) قبل أي طفرة؛ اطلب من MCP أن تكرره

اجمعها مع: supabase

احسب الدخل المتكرر الشهري الحالي والتوقف من اشتراكات Stripe

👤 المؤسسون الذين يقومون بعمليات المالية ⏱ ~15 min intermediate

متى تستخدمه: المراجعة الشهرية؛ تريد قراءة الدخل المتكرر الشهري/التوقف بسرعة مباشرة من المصدر.

الخطوات

اسحب الاشتراكات النشطة

اعرض جميع اشتراكات Stripe النشطة (status='active' أو 'trialing'). جمّع حسب price_id، وجمّع المكافئ الشهري.✓ تم النسخ

→ إجماليات لكل سعر + الإجمالي الكبير
اسحب الملغاة هذا الشهر

اعرض الاشتراكات الملغاة في آخر 30 يوم. لكل منها، اعرض تاريخ البدء والدخل المتكرر الشهري المساهم والعميل.✓ تم النسخ

→ قائمة التوقف مع تأثير الإيرادات
احسب صافي الدخل المتكرر الشهري الجديد

صافي الدخل المتكرر الشهري الجديد = جديد هذا الشهر - توقف هذا الشهر. احسب واكتب ملخص من 3 أسطر.✓ تم النسخ

→ رقم واحد مع تفكيك الحساب

النتيجة: لقطة دخل متكرر شهري دقيقة يمكنك لصقها في مراجعتك الشهرية.

المزالق

الخطط السنوية تحتاج إلى تطبيع شهري — اقسم السعر السنوي على 12 عند جمع الدخل المتكرر الشهري؛ MCP لا تفعل هذا لك
الخصومات والأرصدة تشوه الإجمالي الإجمالي مقابل صافي — قرر اتفاقية الدخل المتكرر الشهري (إجمالي مقابل صافي من الخصومات) وطبقها بثبات

اجمعها مع: filesystem

معالجة استرجاع بحماية مناسبة

👤 قادة الدعم مع سلطة الاسترجاع ⏱ ~5 min beginner

متى تستخدمه: يطلب العميل استرجاع؛ تريد التحقق من الرسمة ومعالجتها بنظافة.

المتطلبات الأساسية

مفتاح API مع refunds:write — مفتاح مقيد، امنح الحد الأدنى فقط من الأنطاقات

الخطوات

ابحث عن الرسمة والتحقق من صحتها

ابحث عن رسمة Stripe ch_xxx. اعرض المبلغ والعميل والحالة وما إذا تم استردادها بالفعل (جزئي أو كامل).✓ تم النسخ

→ تفاصيل الرسمة + سجل الاسترجاع
معاينة الاسترجاع

أريد استرجاع $50 من $200 (جزئي). أظهر لي ما ستبدو عليه استدعاء الاسترجاع. لا تنفذ حتى الآن.✓ تم النسخ

→ معاينة تشغيل جاف لاستدعاء API
تنفيذ عند التأكيد

تابع مع الاسترجاع الجزئي. أرجع معرف الاسترجاع وحالة الرسمة المحدثة.✓ تم النسخ

→ تم إنشاء الاسترجاع، تم وضع علامة على الرسمة جزئياً مسترجعة

النتيجة: تم معالجة الاسترجاع بنظافة مع آثار التدقيق.

المزالق

محاولة استرجاع أكثر من الرسمة الأصلية تفشل بارتباك — تحقق دائماً من الرصيد المسترجع المتبقي قبل طلب؛ MCP يكرر الحد
الاسترجاع يؤدي إلى webhook لتطبيقك — قد يحدث حالة داخلية مزدوجة — تنسيق تدفق الاسترجاع مع من يحتفظ بمعالج webhook

تدقيق الرصيد والمدفوعات الأخيرة قبل إغلاق الربع

👤 المالية والمؤسسون ⏱ ~10 min intermediate

متى تستخدمه: نهاية الربع، تريد معرفة بالضبط ما هو موجود في Stripe وما سيصل إلى البنك.

الخطوات

احصل على تفكيك الرصيد الحالي

اعرض الرصيد الحالي من Stripe: متاح وقيد الانتظار وفي الطريق. قسّم حسب العملة.✓ تم النسخ

→ رصيد لكل عملة ثلاثي
اعرض المدفوعات الأخيرة

اعرض المدفوعات في آخر 90 يوم مع التاريخ والمبلغ والحالة وتاريخ الوصول. صنّف حسب التاريخ بترتيب تنازلي.✓ تم النسخ

→ جدول المدفوعات مع الإجماليات
المصالحة مع الكتب الخاصة بك

ما هو إجمالي المدفوعات في الفترة؟ أخبرني ماذا أتوقع أن يصل إلى البنك في الأيام السبعة القادمة.✓ تم النسخ

→ إجمالي الفترة المجمع + التنبؤ قريب الأجل

النتيجة: ملخص جاهز للمصالحة.

المزالق

الاحتياطيات والأموال المتنازع عليها ليست في 'متاح' — لا تساوي balance.available + balance.pending = إجمالي النقد؛ تحقق من الأرصدة المحتفظ بها بشكل منفصل

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

stripe + supabase

Stripe webhook → Supabase Edge Function → استعلامات Stripe MCP لتحسين معالجة الأحداث

عندما ينطلق Stripe webhook 'invoice.payment_failed'، تستدعي دالة الحافة Stripe MCP لجلب الرسوم الأخيرة للعميل وتلصق ملخصاً في قناة Slack Ops الخاصة بنا.✓ تم النسخ

stripe + postgres

المصالحة بين رسوم Stripe وجدول أوامرك الداخلي

لكل رسمة Stripe ناجحة أمس، ابحث عن الصف المطابق في جدول أوامرنا بواسطة stripe_payment_intent_id. علّم عدم التطابقات.✓ تم النسخ

stripe + filesystem

تصدير بيانات Stripe إلى CSV لفريق المالية

تصدير جميع الفواتيس من الربع الأخير إلى /reports/invoices-Q1-2026.csv مع بريد العميل الإلكتروني والمبلغ والحالة والتاريخ.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
list_customers / retrieve_customer / create_customer / update_customer	Stripe customer params	عمليات العميل CRUD	free Stripe API
list_products / create_product / update_product	product params	عمليات كتالوج المنتج	free
list_prices / create_price	price params	عمليات السعر (لمرة واحدة أو متكررة)	free
list_invoices / create_invoice / finalize_invoice / pay_invoice	invoice params	دورة حياة الفاتورة	free
create_invoice_item	customer, amount, currency, description	أضف سطراً إلى مسودة الفاتورة	free
list_payment_intents / retrieve_payment_intent	PI params	فحص حالة تدفق الدفع	free
list_charges / retrieve_charge	charge params	فحص الرسمة	free
create_refund	charge: str, amount?: int	أصدر استرجاع كامل أو جزئي — مدمر في الوضع المباشر	free Stripe API; refund itself moves money
create_payment_link	line_items, after_completion?	أنشئ عنوان URL دفع مستضاف لإرساله إلى عميل	free
list_subscriptions / cancel_subscription / update_subscription	subscription params	دورة حياة الاشتراك	free
retrieve_balance	none	الرصيد المتاح/قيد الانتظار الحالي	free
list_payouts	limit, created?	انظر المدفوعات الأخيرة والقادمة	free
search_*	query: str (Stripe Search syntax)	تصفية قوية عبر الموارد عبر Search API	free

التكلفة والحدود

تكلفة التشغيل

حصة API: واجهة برمجة تطبيقات Stripe لديها حدود معدل سخية (100 طلب/ثانية قراءة مباشرة، 25 طلب/ثانية افتراضي في الاختبار)
الرموز لكل استدعاء: كائنات Stripe ثقيلة الرموز (بيانات متداخلة غنية). استخدم التوسع فقط عند الحاجة؛ حد أحجام القائمة
التكلفة المالية: MCP مجاني؛ Stripe تفرض رسوماً لكل دفع معالج، وليس لكل استدعاء API
نصيحة: في وضع الاختبار، التكاليف صفر. في الوضع المباشر، الوحيد 'التكلفة' التي تهم هي الاسترجاعات أو الفواتيس المصادرة بطريق الخطأ — اسمح بالكتابة مع تصفية --tools=.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات:

مفتاح مقيد بالحد الأدنى من الأنطاقات لكل سير عمل (مثل Customers:read + Charges:read للدعم)

تخزين بيانات الاعتماد: مفتاح API في متغير البيئة STRIPE_SECRET_KEY. لا تلزم أبداً. استخدم مفاتيح مقيدة، وليس مفتاح السر الجذر.

نقل البيانات الخارجي: جميع الاستدعاءات إلى api.stripe.com (TLS، يتعامل بها Stripe)

لا تمنح أبدًا: مفتاح السر الجذر لوكلاء طويلة الأمد مفتاح API مع Refunds:write أو Subscriptions:write لسير العمل المستقل بدون HITL

الوضع المباشر يعني أموال حقيقية. تأكد دائماً من بادئة مفتاح API (sk_live_ مقابل sk_test_) قبل أي استدعاء كتابة.
استخدم علم سطر الأوامر --tools= (مثل --tools=customers.read,charges.read) لتقيد MCP على مجموعة آمنة.
تحديثات Webhooks الحالة الداخلية — تنسيق الاسترجاع والإلغاء مع الهندسة.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Invalid API Key

مفتاح خاطئ أو مرفوع أو عدم مطابقة الاختبار/المباشر. تحقق من لوحة التحكم. تأكد من تصدير متغير البيئة إلى عملية عميل MCP.

تحقق: curl https://api.stripe.com/v1/balance -u $STRIPE_SECRET_KEY:

Permission denied: this key has no access to ...

مفتاح مقيد ينقصه الأنطاق المناسب. عدّل المفتاح في لوحة التحكم لمنح الإذن المطلوب.

Refund: amount exceeds remaining refundable

تم استرجاع الرسمة بالفعل جزئياً. استرجع الرسمة أولاً، تحقق من amount_refunded، استرجع الباقي فقط.

Search returns 0 results despite the object existing

Stripe Search لديها تأخير انتشار (~1 دقيقة لكائنات تم إنشاؤها حديثاً). استخدم list/retrieve للعناصر الحديثة جداً.

البدائل

Stripe مقابل البدائل

البديل	متى تستخدمها	المقايضة
Stripe CLI عبر shell	تريد إعادة توجيه webhook أو توليد الأجهزة أو تدفقات الاختبار المحلي	لا تتمتع بواجهة مناسبة للوكيل؛ مقصودة لسير العمل في التطوير
Direct REST API via fetch MCP	تحتاج إلى ميزة لا تفضحها MCP الرسمية	المصادقة والترقيم والأنواع يدوية بالكامل؛ عرضة للأخطاء بكثير

Stripe

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

التثبيت

اختر العميل

حالات الاستخدام

استخدامات عملية: Stripe

المتطلبات الأساسية

الخطوات

المزالق

المتطلبات الأساسية

الخطوات

المزالق

الخطوات

المزالق

المتطلبات الأساسية

الخطوات

المزالق

الخطوات

المزالق

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

الأدوات

ما يوفره هذا الـ MCP

التكلفة والحدود

تكلفة التشغيل

الأمان

الصلاحيات والأسرار ونطاق الأثر

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البدائل

Stripe مقابل البدائل

المزيد

الموارد