Opere su integración Mercado Pago por terminal con el MP CLI
El MP CLI (mpcli) pone los recursos de la API de Mercado Pago en la terminal con un único Access TokenAccess Token de tu aplicación, lo que te permite operar pagos, suscripciones, tiendas e informes sin necesidad de browser, GUI, ni cambiar de contexto en tu agente de IA.
En esta versión, los comandos pasan a usar el prefijo mpcli, la instalación llega a una nueva plataforma y la cobertura de comandos crece con pagos avanzados y envíos.
¿Por qué esto importa en la práctica?
Imagina que un cliente reportó una falla en el pago. Con el MP CLI, identificas y actúas sin salir de la terminal:
bash
mpcli payments search --status rejected --external-reference "ORDER-123" mpcli preferences create --title "Producto X" --unit-price 299.90 --quantity 1 --payer-email cliente@email.com
En dos comandos, encontraste el problema y creaste una nueva preferencia de pago con cuotas. Sin abrir el panel, sin armar cURLs, sin perder el contexto.
Pensando en la seguridad, las credenciales quedan en el keychain nativo del sistema operativo, no en archivos de configuración ni en el historial del shell. Esto resuelve el problema de exponer tokens por accidente en repositorios o logs. Todos los comandos devuelven JSON por defecto, así conectas el CLI a cualquier script existente sin una capa adicional de parsing.
Qué cambió en el MP CLI
El impacto más visible es el cambio de nombre de los comandos: todos pasaron del prefijo mp a mpcli. Por ejemplo, mp payments list ahora es mpcli payments list. Si ya usabas el CLI, basta con actualizar el prefijo en tus scripts.
Además del script original, la instalación ahora cuenta con Scoop en Windows. Para esta instalación, algunos antivirus pueden marcar el binario por error y, si eso ocurre, la documentación oficial explica cómo proceder con seguridad. En dispositivos macOS corporativos con restricciones, el directorio ~/.config/mp puede requerir un ajuste de permisos.
La cobertura de la API creció con nuevos comandos:
- mpcli advanced-payments: pagos divididos y desembolsos.
- mpcli shipping: gestión de envíos.
- mpcli config: configuración del CLI.
Los comandos existentes también evolucionaron: mpcli refunds ahora crea reembolsos totales y parciales, mpcli merchant-orders crea y actualiza órdenes, mpcli chargebacks lista contracargos y mpcli oauth genera la URL de autorización.
Recursos para todos los escenarios
Para equipos de desarrollo, recursos que eliminan la configuración repetitiva:
- Perfiles con nombre para alternar entre cuentas y entornos sin volver a autenticarte;
- Archivo .mp.toml en la raíz del repositorio con los defaults compartidos. Cualquier persona que clone el proyecto ya hereda el perfil y el país de operación configurados.
Para pipelines de CI/CD, basta con exportar el Access Token como variable de entorno y usar la flag --no-interactive para garantizar que ningún prompt bloquee la ejecución.
Para agentes de IA, nuestro MP CLI fue pensado desde el inicio para funcionar con agentes. Formato JSON por defecto, --silent, --no-interactive y exit codes categorizados por tipo de error permiten que un agente de IA opere tu integración con Mercado Pago de forma segura y estructurada, sin necesidad de interpretar respuestas crudas de la API ni gestionar credenciales en el contexto de la conversación.
Por último, la posibilidad de hacer pruebas en sandbox desde la terminal: en vez de configurar usuarios de prueba desde el dashboard, creas compradores, defines saldo virtual y aprovisionas tarjetas con comportamientos específicos directamente desde la terminal. Estos comandos usan el Access Token del usuario de prueba, no el de tu aplicación, así que autentica el perfil de prueba antes de operar:
bash
mpcli login --token <test-user-token> --profile test mpcli tester create --site-id MLB --type buyer --profile test mpcli tester balance set 123456 --amount 10000 --profile test mpcli tester card add --user-id 123456 --scenario insufficient_funds --profile test
Conviene recordar que el prefijo APP_USR- en el Access Token no indica el tipo de cuenta: aparece tanto en producción como en prueba. Para confirmar la aplicación y el entorno activos, usa mpcli whoami antes de operar.
Qué viene a continuación
En los próximos lanzamientos, el MP CLI sigue evolucionando para ampliar la cobertura de comandos e incorporar nuevas funcionalidades. Entre los recursos en camino están el Webhook Listener (mpcli listen, mpcli events y mpcli trigger) para recibir y simular notificaciones, el historial de logs (mpcli logs) y la instalación vía npm en cualquier plataforma. Consulta la documentación completa de Mercado Pago CLI.