Recursos para IA

Instalar Mercado Pago CLI

El Mercado Pago CLI está disponible para los sistemas operativos macOS, Linux y Windows. En las tabs a continuación, elige el método de instalación más adecuado a tu sistema y, luego, autentícate con tu Access TokenClave privada de la aplicación creada en Mercado Pago que se utiliza en el backend. Puedes acceder a ella desde Tus integraciones > Detalles de la aplicación > Pruebas > Credenciales de prueba o Producción > Credenciales de producción. para comenzar a operar.

El Mercado Pago CLI se distribuye como un paquete Homebrew compatible con macOS y Linux.

Si es tu primera instalación, pasa directamente al paso 2.

Si tienes la versión anterior instalada (mercadopago/tap/mp-cli), utiliza el siguiente comando para desinstalarla antes de instalar la versión actual.

bash
brew uninstall mp-cli

Luego, ejecuta el siguiente comando para instalar la versión actual.

bash
brew install mercadopago/tap/mpcli

Para confirmar que la instalación se completó con éxito, ejecuta el siguiente comando:

bash
mpcli --version

Antes de usar cualquier comando, autentícate con tu Access TokenClave privada de la aplicación creada en Mercado Pago que se utiliza en el backend. Puedes acceder a ella desde Tus integraciones > Detalles de la aplicación > Pruebas > Credenciales de prueba o Producción > Credenciales de producción. — accede a tus credenciales en Tus integraciones y ejecuta:

bash
mpcli login

Para opciones avanzadas de autenticación, consulta Autenticar credenciales a continuación.

Shell completion

Para habilitar el autocompletado de comandos en la terminal:

bash
mpcli completion bash  >> ~/.bashrc
mpcli completion zsh   >> ~/.zshrc
mpcli completion fish  >> ~/.config/fish/completions/mp.fish
mpcli completion powershell

Autenticar credenciales

El Mercado Pago CLI almacena las credenciales en el keychain nativo del sistema operativo, evitando que los tokens queden expuestos en archivos de configuración, historial del shell o logs.

Nuestro CLI usa Keychain en macOS, libsecret en Linux y Credential Manager en Windows.

Hacer login

Si utilizas un dispositivo macOS corporativo, será necesario un paso adicional antes de iniciar sesión.
En estos casos, ~/.config pertenece a root y, por eso, mpcli login puede fallar con permission denied. Para solucionarlo, antes de hacer login crea manualmente el directorio sudo mkdir -p ~/.config/mp && sudo chown $USER ~/.config/mp.

Para obtener tu Access TokenClave privada de la aplicación creada en Mercado Pago que se utiliza en el backend. Puedes acceder a ella desde Tus integraciones > Detalles de la aplicación > Pruebas > Credenciales de prueba o Producción > Credenciales de producción., accede a Tus integraciones, selecciona o crea una aplicación y copia el token desde Credenciales de producción o Credenciales de prueba en el menú lateral. Luego, ejecuta:

bash
mpcli login --token <tu_access_token>

Al interpretar la respuesta del login, ten en cuenta el siguiente comportamiento:

El campo environment refleja el tipo del token, no el tipo real de la cuenta — un token de cuenta de prueba puede mostrar "environment": "production" y este es el comportamiento esperado.

Hacer logout

Utiliza el siguiente comando para finalizar el acceso del CLI a la cuenta y eliminar las credenciales almacenadas en el keychain. Si estás trabajando con múltiples perfiles, especifica el nombre del perfil que deseas desconectar:

bash
mpcli logout
mpcli logout --profile sandbox

Configurar el proyecto

Esta configuración es ideal para equipos que buscan utilizar el Mercado Pago CLI de forma recurrente. Para eso, crea el archivo .mp.toml en la raíz del repositorio con las configuraciones predeterminadas del equipo, como perfil de credenciales y país de operación:

toml
[defaults]
profile = "checkout-pro-sandbox"  # perfil de credenciales predeterminado
site_id = "MLB"                   # país de operación

[output]
no_color = false                  # deshabilitar salida con color

Fuentes de configuración

El CLI determina qué fuente de configuración utilizar siguiendo el orden de la más específica a la menos específica:

Fuente	Uso recomendado
Flags CLI (`--profile`, `--json`, etc.)	Reemplazar puntualmente cualquier configuración sin modificar los valores predeterminados.
Variables de entorno (`MP_PROFILE`, `MP_ACCESS_TOKEN`)	Autenticación en CI/CD y entornos automatizados.
`.mp.toml` en el directorio actual	Valores predeterminados compartidos del equipo en el repositorio.
`~/.config/mp/config.toml`	Preferencias personales del desarrollador.
Valores predeterminados internos	Aplicados cuando ninguna otra fuente está configurada.

AnteriorResumenInterfaz de línea de comandos oficial para gestionar recursos de Mercado Pago directamente desde la terminal.

PróximoComandosReferencia completa de todos los comandos disponibles en el MP CLI.