Recursos para IA

Instalar o Mercado Pago CLI

O Mercado Pago CLI está disponível para os sistemas operacionais macOS, Linux e Windows. Nas abas abaixo, escolha o método de instalação mais adequado ao seu sistema e, em seguida, autentique com seu Access 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.

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 a instalação foi concluída com sucesso, execute o comando a seguir:

bash
mpcli --version

Habilitar o Shell completion

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

bash
mpcli completion bash  >> ~/.bashrc
mpcli completion zsh   >> ~/.zshrc
mpcli completion fish  >> ~/.config/fish/completions/mp.fish
mpcli 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:

Se você utiliza um Mac corporativo, será necessária uma etapa adicional antes de fazer login.
Para esses casos, ~/.config pertence ao root e, por isso, o mpcli login pode falhar com permission denied. Para corrigir, antes de fazer login crie manualmente o diretório sudo mkdir -p ~/.config/mp && sudo chown $USER ~/.config/mp.

Autentique com o Access 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.:

bash
mpcli login --token TEST-...    # credenciais de teste
mpcli login --token APP_USR-... # credenciais de produção ou de conta de teste

O prefixo TEST- identifica credenciais de teste. O prefixo APP_USR- pode pertencer tanto a credenciais de produção quanto a credenciais de contas de teste — o prefixo, por si só, não determina o ambiente. Confira suas credenciais em Suas integrações para confirmar a qual ambiente cada token pertence.

Ao interpretar a resposta do login, observe o seguinte comportamento:

O campo environment reflete o formato do token, não o tipo real da conta. Um token APP_USR- emitido para uma conta de teste exibirá "environment": "production" e esse é o comportamento esperado.

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
mpcli logout
mpcli 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.