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. Para instalarlo, ejecuta el siguiente comando en la terminal:

bash
brew install mercadopago/tap/mp-cli

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

bash
mpcli --version

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.

Autentícate con el Access Token:

bash
mpcli login --token TEST-...    # credenciales de prueba
mpcli login --token APP_USR-... # credenciales de producción o de cuenta de prueba

El prefijo TEST- identifica credenciales de prueba. El prefijo APP_USR- puede pertenecer tanto a credenciales de producción como a credenciales de cuentas de prueba — el prefijo, por sí solo, no determina el entorno. Consulta tus credenciales en Tus integraciones para confirmar a qué entorno pertenece cada token.

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

El campo environment refleja el formato del token, no el tipo real de la cuenta. Un token APP_USR- emitido para una cuenta de prueba 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.