PayPal MCP サーバー
DynamicEndpointsによって管理されています - 連絡先: kameron@dynamicendpoints.com
PayPal APIとの統合を実現するモデルコンテキストプロトコル(MCP)サーバー。このサーバーは、標準化されたインターフェースを通じて、PayPalの支払い処理、請求、ビジネス管理機能とのシームレスな連携を実現します。
建築
特徴
- 支払い処理
- 注文の作成と管理
- 支払い処理
- 支払いトークンの処理
- 紛争の管理
- 事業運営
- 製品の作成と管理
- 請求書を生成する
- 支払い処理
- パートナー紹介の処理
- ユーザー管理
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の PayPal MCP サーバーを自動的にインストールするには:
npx -y @smithery/cli install @DynamicEndpoints/Paypal-MCP --client claude
手動インストール
- リポジトリをクローンする
- 依存関係をインストールします:
- プロジェクトをビルドします。
- MCP 設定ファイルで PayPal 資格情報を設定します。
{
"mcpServers": {
"paypal": {
"command": "node",
"args": ["path/to/paypal-server/build/index.js"],
"env": {
"PAYPAL_CLIENT_ID": "your_client_id",
"PAYPAL_CLIENT_SECRET": "your_client_secret"
},
"disabled": false,
"autoApprove": []
}
}
}
利用可能なツール
支払い業務
支払いトークンの作成
将来使用するために支払いトークンを作成します。
{
customer: {
id: string;
email_address?: string;
};
payment_source: {
card?: {
name: string;
number: string;
expiry: string;
security_code: string;
};
paypal?: {
email_address: string;
};
};
}
注文作成
PayPal で新しい注文を作成します。
{
intent: 'CAPTURE' | 'AUTHORIZE';
purchase_units: Array<{
amount: {
currency_code: string;
value: string;
};
description?: string;
reference_id?: string;
}>;
}
支払いの作成
直接支払いを作成します。
{
intent: string;
payer: {
payment_method: string;
funding_instruments?: Array<{
credit_card?: {
number: string;
type: string;
expire_month: number;
expire_year: number;
cvv2: string;
first_name: string;
last_name: string;
};
}>;
};
transactions: Array<{
amount: {
total: string;
currency: string;
};
description?: string;
}>;
}
事業運営
製品を作成する
カタログに新しい製品を作成します。
{
name: string;
description: string;
type: 'PHYSICAL' | 'DIGITAL' | 'SERVICE';
category: string;
image_url?: string;
home_url?: string;
}
請求書作成
新しい請求書を生成します。
{
invoice_number: string;
reference: string;
currency_code: string;
recipient_email: string;
items: Array<{
name: string;
quantity: string;
unit_amount: {
currency_code: string;
value: string;
};
}>;
}
支払いの作成
一括支払いを処理します。
{
sender_batch_header: {
sender_batch_id: string;
email_subject?: string;
recipient_type?: string;
};
items: Array<{
recipient_type: string;
amount: {
value: string;
currency: string;
};
receiver: string;
note?: string;
}>;
}
ユーザーとプロファイルの管理
get_userinfo
ユーザー情報を取得します。
{
access_token: string;
}
ウェブプロファイルを作成する
Web エクスペリエンス プロファイルを作成します。
{
name: string;
presentation?: {
brand_name?: string;
logo_image?: string;
locale_code?: string;
};
input_fields?: {
no_shipping?: number;
address_override?: number;
};
flow_config?: {
landing_page_type?: string;
bank_txn_pending_url?: string;
};
}
使用例
注文の作成
const result = await mcpClient.useTool('paypal', 'create_order', {
intent: 'CAPTURE',
purchase_units: [{
amount: {
currency_code: 'USD',
value: '100.00'
},
description: 'Premium Subscription'
}]
});
請求書の作成
const result = await mcpClient.useTool('paypal', 'create_invoice', {
invoice_number: 'INV-2024-001',
reference: 'REF-2024-001',
currency_code: 'USD',
recipient_email: 'customer@example.com',
items: [{
name: 'Consulting Services',
quantity: '1',
unit_amount: {
currency_code: 'USD',
value: '500.00'
}
}]
});
支払いの処理
const result = await mcpClient.useTool('paypal', 'create_payout', {
sender_batch_header: {
sender_batch_id: 'Payroll_2024_001',
email_subject: 'You have received a payment'
},
items: [{
recipient_type: 'EMAIL',
amount: {
value: '1000.00',
currency: 'USD'
},
receiver: 'employee@example.com',
note: 'Monthly salary payment'
}]
});
エラー処理
サーバーは包括的なエラー処理を実装します。
- 詳細なメッセージ付きの入力検証エラー
- PayPal APIエラーと応答の詳細
- ネットワークおよび認証エラー
- レート制限とタイムアウト処理
セキュリティに関する考慮事項
- すべての機密データは検証され、サニタイズされます
- PayPalによるOAuth 2.0認証
- 環境変数による安全な資格情報管理
- すべてのAPIパラメータの入力検証
- エラーメッセージは機密情報を公開しません
発達
建物
テスト
デバッグ
サーバーはデバッグに役立つ詳細なログを出力します。
- 認証の問題
- API呼び出しの失敗
- 検証エラー
- リクエスト/レスポンスの詳細
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
ライセンス
MITライセンス