/ الدليل / الملعب / PayPal Agent Toolkit
● رسمي paypal ⚡ فوري

PayPal Agent Toolkit

بواسطة paypal · paypal/agent-toolkit

Official PayPal MCP — invoices, payments, subscriptions, refunds.

PayPal's official Agent Toolkit ships an MCP server that lets Claude (and other agents) create invoices, capture payments, issue refunds, and manage subscriptions on a real PayPal merchant account — sandbox or live.

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

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

عرض مباشر

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

paypal-agent-toolkit-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "paypal-agent-toolkit-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "paypal-agent-toolkit-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@paypal/agent-toolkit",
          "mcp"
        ]
      }
    }
  }
}

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

claude mcp add paypal-agent-toolkit-mcp -- npx -y @paypal/agent-toolkit mcp

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

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

استخدامات عملية: PayPal Agent Toolkit

Send an invoice to a freelance client from a conversation

👤 Solo operators, freelancers ⏱ ~15 min intermediate

متى تستخدمه: Client just confirmed scope in chat — you want the invoice out before context-switching.

المتطلبات الأساسية
  • Server/skill installed and authenticated — See repo README
الخطوات
  1. Draft the invoice
    Create a PayPal invoice for [email protected] for $2,400 USD: 1 line item 'May consulting retainer, 24h @ $100'. Due net-15.✓ تم النسخ
    → Invoice id + payment link
  2. Confirm and send
    Send the invoice now and tell me the URL to copy into email.✓ تم النسخ
    → Sent status + URL

النتيجة: Invoice issued in 30 seconds without leaving the chat.

المزالق
  • Always start in sandbox. Live mode is one env var away from being real money. Set PAYPAL_ENVIRONMENT=sandbox until you've tested the exact f — Always start in sandbox. Live mode is one env var away from being real money. Set PAYPAL_ENVIRONMENT=sandbox until you've tested the exact flow.
اجمعها مع: gmail · filesystem

التركيبات

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

paypal-agent-toolkit-mcp + gmail

Pair with gmail for complementary capabilities

Use this server together with gmail to complete a multi-step task.✓ تم النسخ
paypal-agent-toolkit-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
create_invoice recipient_email, items, currency Bill a client 1 API call
list_transactions start_date, end_date, status Reconcile or audit 1 API call
refund_capture capture_id, amount Issue a refund 1 API call

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

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

حصة API
See provider docs for rate limits
الرموز لكل استدعاء
Varies by tool
التكلفة المالية
See repo README for pricing details
نصيحة
Cache tool results and avoid repeated identical calls.

الأمان

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

تخزين بيانات الاعتماد: Use environment variables; never commit secrets
نقل البيانات الخارجي: Tool calls go to the provider's API as documented

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

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

AUTHENTICATION_FAILURE

Generate a REST app at developer.paypal.com → My Apps & Credentials → REST API apps. Set PAYPAL_CLIENT_ID and PAYPAL_CLIENT_SECRET.

تحقق: list_transactions for the last 7 days
PERMISSION_DENIED on refund

Refund permission requires the parent capture to be in COMPLETED state and the merchant account to allow refunds.

تحقق: Check the capture status first

البدائل

PayPal Agent Toolkit مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Stripe Agent ToolkitYou're on StripeStripe-only; otherwise similar scope

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills