Recursos para IA

Instalar o Mercado Pago CLI

O Mercado Pago CLI é instalado pelo Homebrew e autenticado com seu Access TokenAccess TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste ou Produção > Credenciais de produção. para começar a operar. Siga os passos para instalação e configuração das credenciais:

Instalar pelo Homebrew

O Mercado Pago CLI é distribuído como um pacote Homebrew compatível com macOS e Linux. Para instalar, execute no terminal o comando a seguir:

bash
brew install mercadopago/tap/mp-cli

Para confirmar se instalação foi concluída com sucesso, execute o comando a seguir:

bash
mp --version

Habilitar o Shell completion

Para habilitar a função de autocompletar de comandos no terminal, execute o comando:

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

Autenticar credenciais

O Mercado Pago CLI armazena as credenciais no keychain nativo do sistema operacional, evitando que os tokens sejam expostos em arquivos de configuração, histórico do shell ou logs.

Nosso CLI usa Keychain no macOS, libsecret no Linux e Credential Manager no Windows.

Fazer login

Siga as instruções de acordo com seu caso:

Autentique com o Access TokenAccess TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste ou Produção > Credenciais de produção. de acordo com o ambiente desejado:

bash
# Sandbox
mp login --token TEST-...

# Produção
mp login --token APP_USR-...

Fazer logout

Utilize o comando abaixo para encerrar o acesso do CLI à conta e remover as credenciais armazenadas no keychain. Caso esteja trabalhando com múltiplos perfis, especifique o nome do perfil que deseja desconectar:

bash
mp logout
mp logout --profile sandbox

Configurar o projeto

Esta configuração é ideal para equipes que buscam utilizar o Mercado Pago CLI de forma recorrente. Para isso, crie o arquivo .mp.toml na raiz do repositório com as configurações padrão da equipe, como perfil de credenciais e país de operação:

toml
[defaults]
profile = "checkout-pro-sandbox"  # perfil de credenciais padrão
site_id = "MLB"                   # país de operação

[output]
no_color = false                  # desabilitar saída colorida

Fontes de configuração

O CLI determina qual fonte de configuração utilizar seguindo a ordem da que for mais específica para a menos específica:

Fonte	Uso recomendado
Flags CLI (`--profile`, `--json`, etc.)	Substituir pontualmente qualquer configuração sem alterar os defaults.
Variáveis de ambiente (`MP_PROFILE`, `MP_ACCESS_TOKEN`)	Autenticação em CI/CD e ambientes automatizados.
`.mp.toml` no diretório atual	Defaults compartilhados de equipe no repositório.
`~/.config/mp/config.toml`	Preferências pessoais do desenvolvedor.
Defaults internos	Aplicados quando nenhuma outra fonte está configurada.