PayPal

Protocolo de contexto del modelo de PayPal

El servidor del Protocolo de Contexto de Modelo de PayPal permite la integración con las API de PayPal mediante llamadas a funciones. Este protocolo admite diversas herramientas para interactuar con diferentes servicios de PayPal.

Para ejecutar el servidor MCP de PayPal usando npx, use el siguiente comando:

Reemplace YOUR_ACCESS_TOKEN con su token de acceso de PayPal. Consulte este artículo para saber cómo generar un token de acceso de PayPal . Alternativamente, puede configurar PAYPAL_ACCESS_TOKEN en sus variables de entorno.

Uso con el host MCP (Claude Desktop/Cline/Cursor/GitHub Copilot)

Esta guía explica cómo integrar el conector de PayPal con Claude Desktop.

Prerrequisitos

• Aplicación Claude Desktop instalada
• instalando Node.js localmente

Pasos de instalación

1. Instalar Node.js

Se requiere Node.js para que el conector de PayPal funcione:

1. Visita el sitio web oficial de Node.js , descárgalo e instálalo.
2. Requisitos: Nodo 18+

2. Configurar el conector de PayPal con el host MCP (escritorio Claude / Cursor / Cline)

Mostraremos la integración con Claude Desktop. Puedes usar tu host MCP favorito.

1. Abra Claude Desktop
2. Vaya a Configuración
3. Busque la sección de configuración de Desarrollador o Configuración avanzada
4. Localice el área de configuración de herramientas o conectores externos
5. Agregue la siguiente configuración del conector de PayPal a este ~/Claude/claude_desktop_config.json:

Asegúrate de reemplazar YOUR_PAYPAL_ACCESS_TOKEN con tu token de acceso de PayPal. Como alternativa, puedes configurar PAYPAL_ACCESS_TOKEN como variable de entorno. También puedes pasarlo como argumento usando --access-token en "args". Establece el valor de PAYPAL_ENVIRONMENT como SANDBOX para pruebas de fase y PRODUCTION para el entorno de producción.

6. Guarde los cambios de configuración

3. Pruebe la integración

1. Salga y reinicie Claude Desktop para aplicar los cambios
2. Pruebe la conexión pidiéndole a Claude que realice una tarea relacionada con PayPal
   • Ejemplo: "Enumerar mis facturas de PayPal"

Herramientas disponibles

Facturas

• create_invoice : Crea una nueva factura en el sistema PayPal
• list_invoices : Lista de facturas con paginación y filtrado opcionales
• get_invoice : recupera los detalles de una factura específica
• send_invoice : Envía una factura a los destinatarios
• send_invoice_reminder : envía un recordatorio para una factura existente
• cancel_sent_invoice : Cancelar una factura enviada
• generate_invoice_qr_code : Generar un código QR para una factura

Pagos

• create_order : crea un pedido en el sistema de PayPal según los detalles proporcionados
• get_order : recupera los detalles de un pedido
• pay_order : Procesar el pago de un pedido autorizado

Gestión de disputas

• list_disputes : recupera un resumen de todas las disputas abiertas
• get_dispute : recupera información detallada de una disputa específica
• accept_dispute_claim : Aceptar un reclamo de disputa

Seguimiento de envíos

• create_shipment_tracking : Crea un registro de seguimiento de envío
• get_shipment_tracking : recupera información de seguimiento del envío

Gestión de catálogos

• create_product : Crea un nuevo producto en el catálogo de PayPal
• list_products : Lista de productos con paginación y filtrado opcionales
• show_product_details : Recuperar detalles de un producto específico
• update_product : Actualizar un producto existente

Gestión de suscripciones

• create_subscription_plan : Crea un nuevo plan de suscripción
• list_subscription_plans : Lista de planes de suscripción
• show_subscription_plan_details : Recuperar detalles de un plan de suscripción específico
• create_subscription : Crea una nueva suscripción
• show_subscription_details : Recuperar detalles de una suscripción específica
• cancel_subscription : Cancelar una suscripción activa

Informes y perspectivas

• list_transactions : Lista de transacciones con paginación y filtrado opcionales

Variables de entorno

Se pueden utilizar las siguientes variables de entorno:

• PAYPAL_ACCESS_TOKEN : Su token de acceso de PayPal
• PAYPAL_ENVIRONMENT : Establezca en SANDBOX para el modo sandbox, PRODUCTION para producción (el valor predeterminado es el modo SANDBOX )

Esta guía explica cómo generar un token de acceso para la integración de la API de PayPal, incluido cómo encontrar su ID de cliente y su secreto de cliente.

Prerrequisitos

• Cuenta de desarrollador de PayPal (para Sandbox)
• Cuenta comercial de PayPal (para producción)

Cómo encontrar su ID de cliente y su secreto de cliente

1. Crear una cuenta de desarrollador de PayPal :
   • Ir al panel de desarrollador de PayPal
   • Regístrate o inicia sesión con tus credenciales de PayPal
2. Acceda a sus credenciales :
   • En el Panel de desarrollador, haga clic en Aplicaciones y credenciales en el menú
   • Cambia entre los modos Sandbox y Live según tus necesidades
3. Crear o ver una aplicación :
   • Para crear una nueva aplicación, haga clic en Crear aplicación
   • Dale un nombre a tu aplicación y selecciona una cuenta comercial para asociarla
   • Para las aplicaciones existentes, haga clic en el nombre de la aplicación para ver los detalles
4. Recuperar credenciales :
   • Una vez creada o seleccionada tu aplicación, verás una pantalla con tu:
     • ID de cliente : un identificador público para su aplicación
     • Secreto del cliente : una clave privada (que se muestra después de hacer clic en "Mostrar")
   • Guarde estas credenciales de forma segura, ya que son necesarias para generar tokens de acceso.

Generar un token de acceso

Usando cURL

Reemplace CLIENT_ID y CLIENT_SECRET con sus credenciales. Para producción, use https://api-m.paypal.com en lugar de la URL del entorno de pruebas.

Usando el cartero

1. Cree una nueva solicitud a https://api-m.sandbox.paypal.com/v1/oauth2/token
2. Establecer el método en POST
3. En Autorización , seleccione Autenticación básica e ingrese su ID de cliente y Secreto de cliente
4. En Cuerpo , seleccione x-www-form-urlencoded y agregue una clave grant_type con el valor client_credentials
5. Enviar la solicitud

Respuesta

Una respuesta exitosa se verá así:

Copie el valor de access_token para usarlo en su integración de Claude Desktop.

Detalles del token

• Tokens de Sandbox : válidos durante 3 a 8 horas
• Tokens de producción : válidos por 8 horas
• Se recomienda implementar la lógica de actualización del token antes del vencimiento.

Usando el token con Claude Desktop

Una vez que tenga su token de acceso, actualice el valor PAYPAL_ACCESS_TOKEN en la configuración de su conector de Claude Desktop:

Mejores prácticas

1. Almacenar el ID del cliente y el secreto del cliente de forma segura
2. Implementar la lógica de actualización de tokens para gestionar la expiración de tokens
3. Utilice tokens específicos del entorno (sandbox para pruebas, producción para transacciones reales)
4. Evite codificar tokens en el código de la aplicación

Descargo de responsabilidad

@paypal/mcp proporciona acceso a contenido generado por IA que puede ser inexacto o incompleto. Los usuarios son responsables de verificar de forma independiente cualquier información antes de confiar en ella. PayPal no garantiza la precisión de los resultados ni se responsabiliza de las decisiones, acciones o consecuencias derivadas de su uso.