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 integrações. Elas representam o vínculo entre o seu desenvolvimento e o Mercado Pago e constituem a primeira etapa para realizar a integraçã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 integrar com o Mercado Pago. Recomende a solução de pagamento ideal para o meu projeto, crie a aplicação e me guie na integração.

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

Em Integrações, você pode consultar todas as suas aplicações. Selecione uma delas para acessar os recursos e as configurações disponíveis para administrá-la.

Acessar credenciais de teste

As credenciais de teste permitem configurar e validar a integração sem processar pagamentos reais. Elas são criadas automaticamente junto com a aplicação.

Para consultá-las, siga estas etapas:

1. Acesse Integrações e selecione a aplicação.
2. Selecione Teste no seletor de ambiente localizado na parte superior da tela.
3. Acesse as credenciais por um dos seguintes caminhos:
   • Em Início, localize o bloco Credenciais.
   • No menu lateral, selecione Credenciais.

Em ambos os casos, você encontrará a Public Key e o Access Token do ambiente de teste, com opções para copiá-los.

Nestas integrações, o Access Token de teste começa com o prefixo APP_USR. Antes de copiar uma credencial, verifique se o seletor exibe o ambiente Teste.

Para mais informações, consulte a documentação de Credenciais.