Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade PayPal con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
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.
Prueba a pedir
Prompts de ejemplo para PayPal
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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
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.
Configuración
- 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.
- 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.
- 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.
- Copia el Client ID en
PAYPAL_CLIENT_IDy Secret key 1 (haz clic para mostrarla) enPAYPAL_CLIENT_SECRET. Ambos deben venir de la misma app y de la misma sección, Sandbox o Live. - Define
PAYPAL_API_URLcomohttps://api-m.sandbox.paypal.compara claves de sandbox ohttps://api-m.paypal.compara claves live, sin barra final. - 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.
- Empieza con
paypal_get_balancespara 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.
Requisitos previos: PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_API_URL
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige PayPal e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
paypal_create_order | Create a checkout order (nothing is charged yet) |
paypal_get_order | Read one checkout order: status (CREATED, APPROVED, COMPLETED, VOIDED, ...), amounts, payer, and for completed orders the captures under… |
paypal_capture_order | Collect the money of an order the buyer has approved (intent CAPTURE) |
paypal_get_capture | Read one captured payment: amount, status (COMPLETED, PENDING, PARTIALLY_REFUNDED, REFUNDED, DECLINED), seller fees and net amount, and… |
paypal_refund_capture | Refund a captured payment, in full (no amount) or in part |
paypal_get_refund | Read one refund: amount, status (COMPLETED, PENDING, FAILED, CANCELLED), note to the payer and the capture it belongs to |
paypal_get_authorization | Read one authorized payment (an order created with intent AUTHORIZE): amount, status (CREATED, CAPTURED, PARTIALLY_CAPTURED, VOIDED… |
paypal_list_invoices | List invoices, newest first, with id, number, status, recipient, amount and due date |
paypal_search_invoices | Search invoices by recipient, number, status, currency, dates or amount (all filters combined with AND) |
paypal_create_draft_invoice | Create a draft invoice |
paypal_get_invoice | Read one invoice: status, recipient, items, amounts, due amount, payments and refunds recorded on it, and the payer link (links[] rel… |
paypal_send_invoice | Send a draft invoice |
paypal_remind_invoice | Email a payment reminder for a sent, unpaid invoice (PayPal allows 2 reminders a day) |
paypal_cancel_invoice | Cancel a sent invoice so it can no longer be paid; by default the recipient is told by email |
paypal_delete_draft_invoice | Delete a draft or scheduled invoice for good (sent invoices are cancelled with paypal_cancel_invoice instead) |
paypal_search_transactions | Search the account history (Transaction Search): payments received and sent, refunds, fees, transfers and their payer and cart details |
paypal_get_balances | Read the account balances per currency (available, withheld and total), now or as of a past time: balances[] with as_of_time |
paypal_list_disputes | List disputes, claims and chargebacks raised against the account (last 180 days), with dispute_id, reason, status, dispute_state, amount… |
paypal_get_dispute | Read one dispute in full: reason, status, amounts, disputed transactions, messages, offers, evidence and the deadline to respond… |
paypal_list_products | List catalog products (the products subscription plans belong to): id, name, description, type and dates |
paypal_get_product | Read one catalog product: name, description, type (PHYSICAL, DIGITAL, SERVICE), category, image and home URLs |
paypal_list_plans | List subscription plans, optionally for one product: id, name, status (CREATED, ACTIVE, INACTIVE), product_id and dates |
paypal_get_plan | Read one subscription plan: billing cycles with prices and frequency, trial periods, setup fee, taxes and payment failure settings |
paypal_list_subscriptions | List subscriptions, filtered by plan and status: id, status, plan_id, subscriber, start time and next billing time |
paypal_get_subscription | Read one subscription: status, plan, subscriber (name, email, shipping address), billing info (outstanding balance, last payment, next… |
paypal_list_subscription_transactions | List the payments of one subscription between two times: id, status, amounts with fees and net, payer and time |
paypal_cancel_subscription | Cancel a subscription for good: no further payments are collected and it cannot be reactivated |
paypal_get_payout_batch | Read one payout batch: batch status and totals, and its items (receiver, amount, status, fees, errors) |
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."
Siguientes pasos
¿Te ha sido útil esta guía?
