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.
Configuración guiada
Conecta PayPal a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta PayPal con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
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 + Microsoft Copilot
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
- 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.
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 Microsoft Copilot
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 muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
PayPal. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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."
FAQ
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?