PayPal

Official

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Integrates with PayPal APIs to manage invoices, offering tools to create new invoices and list existing ones through function calling.

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:

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

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 Co-Pilot)

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:
{ "mcpServers": { "paypal": { "command": "npx", "args": [ "-y", "@paypal/mcp", "--tools=all" ], "env": { "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN", "PAYPAL_ENVIRONMENT": "SANDBOX" } } } }

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.

  1. 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

HerramientaDescripción
invoices.createCrear una nueva factura
invoices.listListado de facturas

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 :
  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

curl -v --location 'https://api-m.sandbox.paypal.com/v1/oauth2/token' \ -u CLIENT_ID:CLIENT_SECRET \ -H 'Accept: application/json' \ -H 'Accept-Language: en_US' \ -d 'grant_type=client_credentials'

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í:

{ "scope": "...", "access_token": "Your Access Token", "token_type": "Bearer", "app_id": "APP-80W284485P519543T", "expires_in": 32400, "nonce": "..." }

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:

{ "env": { "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN", "PAYPAL_ENVIRONMENT": "SANDBOX" } }

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Usage with MCP host (Claude Desktop/Cline/Cursor/Github Co-Pilot)
    1. Prerequisites
      1. Installation Steps
        1. 1. Install Node.js
        2. 2. Configure PayPal Connector with MCP host (Claude desktop / Cursor / Cline)
        3. 3. Test the Integration
      2. Available tools
        1. Environment Variables
          1. Prerequisites
            1. Finding Your Client ID and Client Secret
              1. Generating an Access Token
                1. Using cURL
                2. Using Postman
                3. Response
              2. Token Details
                1. Using the Token with Claude Desktop
                  1. Best Practices
                    1. Disclaimer
                      ID: oydv2566r4