Instalar o plugin
O plugin do Mercado Pago está disponível para os agentes de IA Claude Code e Codex. Veja abaixo os passos necessários para instalar, habilitar sua conta e verificar se todos os passos ocorreram corretamente.
Nas abas abaixo, escolha o agente de IA mais adequado ao seu projeto e siga os passos para começar a operar.
O plugin pode ser instalado pelo terminal ou direto pela interface do Claude Code.
Instalar pelo terminal
Execute o comando a seguir:
bashclaude plugin install mercadopago@claude-plugins-official
O Claude Code baixa e instala o plugin automaticamente, não sendo necessário reiniciar a aplicação para confirmar se a operação foi concluída.
Instalar pela interface do Claude Code
Siga os passos:
- Abra a sua conta no Claude Code e vá para a seção Personalizar no menu lateral direito.
- Acesse o menu Extensões e selecione Explorar extensões.
- Pesquise por Mercado Pago na aba Parceiros.
- Clique no ícone de adição (+).
O plugin fica disponível imediatamente em todas as conversas.
A autenticação é uma etapa necessária para habilitar funções que dependem de dados da sua aplicaçãoEntidade registrada no Mercado Pago que atua como um identificador para gerenciar suas integrações. Para mais informações, acesse o link abaixo.Detalhes da aplicação e acessar seu ambiente de desenvolvimento em tempo real.
Caso opte por usar o plugin sem a autenticação de conta, pode seguir para a seção Verificar a instalação.
Inicie o fluxo de autenticação executando o comando:
plain/mp-connect
O plugin abre o navegador padrão do seu sistema com a página de autorização do Mercado Pago. Acesse sua conta e autorize a conexão ao plugin. Após concluir a autorização, volte à sessão no agente de IA e as funções adicionais ficam disponíveis imediatamente.
A sessão permanece ativa entre sessões do agente de IA até que você decida encerrá-la manualmente. Se você já tem uma conta conectada quando executa /mp-connect, o plugin verifica o estado atual e informa sem iniciar um novo fluxo de autenticação.
Para confirmar que o plugin já está disponível para uso, siga os passos abaixo:
- Execute o seguinte comando em qualquer conversa do agente de IA:
text/mp-connect
- O plugin abre o fluxo de autenticação OAuth do Mercado Pago no navegador. Complete a autenticação ou, caso queira confirmar a instalação sem autenticação, execute um dos comandos disponíveis:
text/mp-test-cards
Neste caso, o plugin retorna os cartões de teste disponíveis para o seu país.
- Em caso de algum dos comandos não ser reconhecido, verifique se o plugin está instalado executando o comando abaixo.
bashclaude plugin list
O plugin deve aparecer na lista como mercadopago@claude-plugins-official.