PayPal Agent Toolkit MCP — 安裝 & 即時演示

Name: PayPal Agent Toolkit MCP Server
Author: paypal

為什麼要用

核心特性

Create and send invoices to any email
Capture or refund existing transactions
Manage subscription plans and billing agreements
List transactions with date/status filters
Sandbox + live mode with separate credentials

即時演示

實際使用效果

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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "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

步驟

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
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 搭配，撬動十倍槓桿

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
每次呼叫 Token 數: 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 Toolkit	You're on Stripe	Stripe-only; otherwise similar scope

PayPal Agent Toolkit