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.

Se esse for o seu primeiro processo de instalação, pule para o passo 2.

Caso já tenha a versão anterior instalada (mercadopago/tap/mp-cli), utilize o comando abaixo para desinstalá-la antes de instalar a versão atual.

bash
brew uninstall mp-cli

Em seguida, rode o comando abaixo para instalar a versão atual.

bash
brew install mercadopago/tap/mpcli

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

bash
mpcli --version

Antes de usar o CLI, autentique-se 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. executando:

bash
mpcli login --token <YOUR_ACCESS_TOKEN>

Para opções avançadas de autenticação, consulte Autenticar credenciais abaixo.

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 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. e execute:

bash
mpcli login --token <YOUR_ACCESS_TOKEN>

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

O campo environment reflete o tipo do token, não o tipo real da conta. Um token de conta de teste pode 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.