Criar aplicação

As aplicações são entidades registradas no Mercado Pago que atuam como um identificador único para gerenciar a autenticação e autorização das suas implementações. Elas representam o vínculo entre o seu desenvolvimento e o Mercado Pago e constituem a primeira etapa para realizar a implementação.

Para criar uma aplicação, você tem três opções disponíveis: com um agente de IA a partir do seu editor de código, com o Assistente do Mercado Pago Developers, ou manualmente pelo Painel de integração.

Criar com IA

Criar com o Assistente

Criar manualmente

Você pode utilizar nossos recursos de IA para criar sua aplicação a partir da sua IDE ou agente em 2 passos, sendo o agente se encarregando de criar a aplicação no Painel de integração e te guiando em toda a configuração.

Para isso, você tem duas opções: instalando o Plugin do Mercado Pago, disponível para Claude Code e Codex, ou configurando o Mercado Pago MCP Server, disponível para editores como VS Code e Cursor. Siga as instruções de acordo com a opção escolhida.

Plugin

Claude Code

Execute o seguinte comando para instalar o plugin do Mercado Pago para Claude Code.

bash
claude plugin install mercadopago@claude-plugins-official

Depois de instalado, execute o comando /mp-connect para autorizar o acesso do agente à sua conta do Mercado Pago.

Codex

Execute os seguintes comandos para instalar o plugin do Mercado Pago para Codex.

bash
codex plugin marketplace add mercadopago/mercadopago-codex-marketplace
codex plugin add mercadopago@mercadopago-codex-marketplace

Depois de instalado, execute o comando /mp-connect para autorizar o acesso do agente à sua conta do Mercado Pago.

MCP

VS Code

Adicione a seguinte configuração ao seu arquivo mcp.json.

json
{
  "mcp": {
    "servers": {
      "mercadopago-mcp-server": {
        "type": "http",
        "url": "https://mcp.mercadopago.com/mcp"
      }
    }
  }
}

Cursor

Adicione a seguinte configuração ao seu arquivo mcp.json.

json
{
  "mcpServers": {
    "mercadopago-mcp-server": {
      "url": "https://mcp.mercadopago.com/mcp"
    }
  }
}

Por fim, peça ao agente para criar sua aplicação no Mercado Pago. Se preferir, você pode copiar e colar o seguinte prompt.

plain
Quero implementar o Mercado Pago na minha plataforma de e-commerce. Recomende a solução de pagamento ideal para o meu projeto, crie a aplicação e me guie na implementação.

Se precisar de ajuda, consulte o guia Integrar com IA.

Em Suas integrações, é possível consultar a lista de todas as suas aplicações criadas e acessar os Detalhes da aplicação de cada uma delas.

Obter credenciais de teste

Durante o processo de implementação, utilize credenciais de contas de testeChaves de acesso que identificam o seu usuário de teste, utilizadas em etapas de desenvolvimento ou para testar a integração. Para mais informações, acesse o link abaixo.Contas de teste para realizar todas as configurações e validações necessárias, garantindo que nenhum pagamento real seja efetuado em produção. Essas credenciais simulam as informações de uma conta produtiva, porém em um ambiente seguro de testes.

Mantenha o uso das credenciais de teste durante toda a fase de desenvolvimento. Apenas substitua pelas credenciais produtivas quando o sistema estiver completamente validado e pronto para ser publicado.

Para obter as credenciais de teste, siga os passos abaixo.

1. Criar conta de teste de vendedor

As contas de teste simulam usuários com as mesmas funcionalidades de um usuário real do Mercado Pago. Elas permitem verificar o funcionamento do seu desenvolvimento sem o risco de comprometer dados reais.

Siga os passos abaixo para criar um usuário de teste de vendedor.

1. No Mercado Pago Developers, navegue até Suas integrações e clique no card correspondente à sua aplicação.
2. Depois de acessar "Detalhes da aplicação", vá para a seção Contas de teste no menu lateral esquerdo e clique no botão + Criar conta de teste.

3. Na tela "Criar nova conta", insira uma descrição para identificação da conta.
4. Em seguida, selecione o país de operação da conta. Essa informação não poderá ser editada posteriormente.
5. Indique o tipo de conta de teste que está criando. Se estiver integrando para outra pessoa, selecione Integrador. Se for o administrador da loja, selecione Vendedor.
6. No campo Dinheiro disponível, não é necessário indicar nenhum valor por se tratar de um usuário vendedor ou integrador.
7. Aceite a Declaração de Privacidade e os Termos e condições e clique em Criar conta de teste.

2. Criar aplicação de teste e obter credenciais

1. Para logar na sua conta de teste, abra uma janela anônima, acesse Mercado Pago Developers e clique no botão Entrar, localizado no canto superior direito.
2. Faça login utilizando o usuário e a senha do usuário de teste vendedor criado na etapa anterior. Para isso, utilize o usuário e a senha atribuídos a ele. Consulte esses dados na seção Contas de teste.

3. Ainda na janela anônima, vá até Suas integrações e clique em Criar aplicação. Siga os passos para criar uma aplicaçãoEntidade registrada no Mercado Pago que atua como um identificador para gerenciar suas integrações. Accesse a documentação Criar aplicação para saber mais. de testes vinculada ao seu usuário vendedor.
4. Após criar a aplicaçãoEntidade registrada no Mercado Pago que atua como um identificador para gerenciar suas integrações. Vá para o passo Criar aplicação se precisar saber como fazer isso., selecione-a e acesse os Detalhes da aplicação. No menu lateral esquerdo, acesse Credenciais de produção para encontrar a Public Key e o Access Token do usuário de testeChaves pública e privada da aplicação de testes criada com seu usuário de testes..