Cómo conectar PayPal a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → PayPal, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

PayPal + Cursor

Deja que tu IA trabaje con tu cuenta PayPal para empresas: crea y cobra pedidos, reembolsa pagos, crea, envía y reclama facturas, busca en el historial de transacciones y en los saldos, revisa disputas y consulta planes de suscripción, suscripciones y lotes de payouts. Sandbox o live, con las claves de tu propia app REST.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_API_URL

Paso 1 — Obtener credenciales

1. Inicia sesión en developer.paypal.com con tu cuenta PayPal para empresas y abre Apps & Credentials. El selector de arriba cambia entre Sandbox y Live; cada uno tiene sus propias apps y claves.
2. Usa la Default Application o haz clic en Create App, elige el tipo Merchant y, en el sandbox, selecciona la cuenta empresarial de sandbox para la que debe actuar la app.
3. Abre la app y, en sus funciones, marca lo que la IA debe poder usar: Invoicing, Transaction Search, Subscriptions (también cubre los productos del catálogo), Customer Disputes y Payouts.
4. Copia el Client ID en PAYPAL_CLIENT_ID y Secret key 1 (haz clic para mostrarla) en PAYPAL_CLIENT_SECRET. Ambos deben venir de la misma app y de la misma sección, Sandbox o Live.
5. Define PAYPAL_API_URL como https://api-m.sandbox.paypal.com para claves de sandbox o https://api-m.paypal.com para claves live, sin barra final.
6. Instala el conector. No hay paso Authorize with Provider ni pantalla de consentimiento de PayPal: el conector inicia sesión como tu app REST con el client ID y el secret.
7. Empieza con paypal_get_balances para comprobar que las claves llegan a la cuenta correcta (necesita Transaction Search en la app).

Mantener la sesión iniciada: el conector obtiene los tokens de acceso con el client ID y el secret y los renueva antes de que caduquen, así que no hay que volver a iniciar sesión.

Las funciones nuevas tardan: PayPal puede tardar hasta 9 horas en conceder una función recién marcada a una app que ya ha emitido tokens. Hasta entonces esas llamadas responden 403 NOT_AUTHORIZED, así que marca todo lo que necesites antes de la primera instalación.

Pagos y correos: paypal_capture_order, paypal_refund_capture y paypal_cancel_subscription mueven o detienen dinero real en una cuenta live, y paypal_send_invoice, paypal_remind_invoice y paypal_cancel_invoice envían un correo al cliente. La IA explica antes exactamente qué va a pasar (importe, moneda, cliente, ids) y espera tu sí. Los cobros y reembolsos llevan un request id, para que un reintento no actúe dos veces.

Permisos y solo lectura: la app solo llega a las funciones que marques, así que deja fuera las que la IA no deba usar. Para una configuración de solo lectura, desactiva paypal_create_order, paypal_capture_order, paypal_refund_capture, paypal_create_draft_invoice, paypal_send_invoice, paypal_remind_invoice, paypal_cancel_invoice y paypal_cancel_subscription. Con claves de sandbox puedes probarlo todo antes sin riesgo.

Desactivadas al instalar: paypal_delete_draft_invoice, que elimina para siempre un borrador o una factura programada. Actívala solo si la IA debe borrar borradores; las facturas ya enviadas se cancelan con paypal_cancel_invoice.

Pedidos y reembolsos: paypal_create_order no cobra nada. Devuelve un enlace de aprobación que el comprador tiene que abrir y aprobar; solo entonces paypal_capture_order puede cobrar el dinero. paypal_refund_capture reembolsa un cobro completo o, si indicas un importe, una parte, hasta lo que quede tras reembolsos anteriores.

Facturas e historial: paypal_create_draft_invoice no envía nada hasta que paypal_send_invoice manda la factura, y PayPal permite como máximo 2 recordatorios al día. paypal_search_transactions abarca como máximo 31 días por llamada (los periodos más largos se consultan mes a mes) y llega hasta 3 años atrás; las transacciones nuevas y los saldos aparecen con hasta 3 horas de retraso. Las disputas llegan hasta 180 días atrás.

Errores frecuentes: 401 invalid_client o invalid_token significa que el client ID o el secret son incorrectos, o que las claves son del otro entorno que PAYPAL_API_URL (las claves de sandbox necesitan la URL de sandbox y las live, la URL live). 403 NOT_AUTHORIZED o PERMISSION_DENIED significa que la función no está marcada en la app o se marcó hace menos de 9 horas. 422 UNPROCESSABLE_ENTITY indica la regla de negocio incumplida, por ejemplo ORDER_NOT_APPROVED (el comprador aún no ha aprobado), AMOUNT_MISMATCH o CAPTURE_FULLY_REFUNDED. 429 RATE_LIMIT_REACHED significa que PayPal está limitando la app: espera un minuto y vuelve a intentarlo.

El conector no gestiona pagos con tarjeta ni el almacenamiento de métodos de pago (vaulting), webhooks, el envío de payouts, la aceptación o respuesta de disputas ni la edición de planes de suscripción.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de PayPal.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es mi saldo actual de PayPal y qué pagos han entrado en los últimos 7 días?"
• "Crea un borrador de factura para Acme S.L.: 10 horas de consultoría a 90 EUR, con vencimiento a 30 días. Enséñamelo antes de enviarlo."
• "¿Qué disputas esperan mi respuesta y hasta cuándo tengo para responder a cada una?"
• "Enumera las suscripciones activas del plan Pro Monthly y dime cuáles tienen pagos fallidos."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse