Como conectar o Mercado Pago a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o Mercado Pago a um agente de IA no DoubleX Agentes, abra a tela Conectores, escolha Mercado Pago, autorize a conexão, libere o conector para o agente e defina quais ações ele pode executar. O conector cobre documentação, webhooks, usuários de teste e revisão da integração.
Quem integra o Mercado Pago a uma loja ou sistema gasta tempo procurando a documentação certa, configurando webhooks e criando contas de teste. Um agente de IA conectado ao Mercado Pago ajuda justamente nessa parte técnica. Este guia mostra como fazer a conexão e como manter o controle do que o agente pode fazer.
O que o conector do Mercado Pago permite ao agente fazer?#
O conector do Mercado Pago permite que o agente pesquise a documentação, configure webhooks, crie usuários de teste e revise a integração. Ele é voltado a quem desenvolve ou mantém a integração, e não a consultar vendas ou cobrar clientes.
Webhook é uma chamada que o Mercado Pago faz para o seu sistema quando algo acontece, como a mudança de status de um pagamento. Usuário de teste é uma conta fictícia usada para simular compras sem movimentar dinheiro real.
| Tarefa | Como o agente ajuda |
|---|---|
| Dúvida de implementação | Pesquisa a documentação do Mercado Pago e explica o caminho |
| Notificações de pagamento | Configura webhooks |
| Testes de compra | Cria usuários de teste |
| Conferência final | Revisa a integração e aponta o que falta |
O que preparar antes de conectar (conta, permissões e quem conecta)?#
Antes de conectar, tenha em mãos a conta do Mercado Pago que você usa na integração e confirme quem na empresa pode autorizar a conexão. No DoubleX Agentes, uma conexão pode ser pessoal, do time ou da empresa, então decida o alcance antes de começar.
- Uma conta no DoubleX Agentes (criar a conta é grátis, sem cartão).
- Acesso à conta do Mercado Pago que será usada na integração.
- Um agente já criado, por exemplo um agente de integrações de pagamento. Se ainda não tem, comece pelo diagnóstico e transforme o resultado em uma equipe de agentes.
- Definição de quem usará a conexão: só você, um time ou a empresa inteira.
Se quiser entender a plataforma antes, veja a introdução e o início rápido.
Como conectar o Mercado Pago na tela Conectores, passo a passo?#
A conexão é feita na tela Conectores: você escolhe o Mercado Pago, autoriza o acesso e libera o conector para o agente. Depois disso, o agente passa a usar as ferramentas do conector nas tarefas.
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure por Mercado Pago na lista de conectores.
- Inicie a conexão e autorize o acesso com a sua conta do Mercado Pago.
- Escolha o alcance da conexão: pessoal, do time ou da empresa.
- Abra a tela Agentes, selecione o agente que vai trabalhar com a integração e ative o conector Mercado Pago para ele.
- Defina as ações permitidas (veja a próxima seção) e salve.
Os detalhes técnicos de conectores para quem programa estão na documentação de Conectores. Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM.
Como escolher quais ações o agente pode executar e manter o controle?#
Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados, como configurar um webhook ou criar um usuário de teste, podem ficar desligadas, deixando o agente só em modo de leitura e pesquisa.
Uma boa prática é começar com o mínimo e liberar mais conforme a confiança aumenta:
| Etapa | O que liberar |
|---|---|
| Primeira semana | Só pesquisa de documentação e revisão da integração |
| Ambiente de testes | Criação de usuários de teste |
| Integração madura | Configuração de webhooks, com confirmação |
Antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Os papéis de dono, administrador e membro também limitam quem pode mudar essas permissões.
Como testar a conexão com um primeiro pedido simples?#
Teste com um pedido de baixo risco, que só exija leitura, como pedir que o agente explique um ponto da documentação. Se ele responder usando o conector, a conexão está funcionando.
Exemplos de pedidos para copiar:
- "Pesquise na documentação do Mercado Pago como funcionam as notificações de pagamento por webhook e resuma os passos."
- "Revise a minha integração do Mercado Pago e liste o que ainda falta antes de ir para produção."
- "Crie um usuário de teste do Mercado Pago para simular uma compra e me diga os dados de acesso."
- "Explique como configurar um webhook do Mercado Pago apontando para o endereço do meu sistema e peça minha confirmação antes de aplicar."
Para receber avisos do seu sistema em outro sentido, também é possível disparar um agente por webhook. Veja a documentação de Webhooks e o guia sobre webhooks, testes e revisão com o Mercado Pago.
Como conferir o histórico da tarefa e o que o agente fez?#
Cada pedido ao agente vira uma tarefa na tela Tarefas, com histórico completo: o pedido, cada ferramenta que o agente usou e o resultado. Assim você sabe quem pediu, o que foi feito e quando.
Após o teste, abra a tarefa e confira:
- Se o agente usou as ferramentas do conector Mercado Pago, e não apenas respondeu de memória.
- Quais ações foram executadas e se alguma pediu confirmação.
- Se o resultado bate com o que você pediu.
Se algo estiver fora do esperado, ajuste as instruções do agente ou reduza as ações permitidas na tela Agentes.
Perguntas frequentes#
O conector do Mercado Pago consulta minhas vendas?#
Não. Ele permite pesquisar a documentação, configurar webhooks, criar usuários de teste e revisar a integração. Não foi pensado para consultar vendas nem para cobrar clientes.
Preciso programar para conectar o Mercado Pago?#
Não. A conexão é feita na tela Conectores, autorizando o acesso, e você descreve o que precisa com as próprias palavras. A API REST, a CLI e o MCP existem para quem quiser ir além.
Posso deixar o agente apenas em modo de leitura?#
Sim. Em cada sistema, você escolhe quais ações o agente pode executar. Ações que alteram dados podem ficar desligadas.
O agente configura um webhook sem me avisar?#
Não. Antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Tudo fica registrado no histórico da tarefa.
Os dados da minha empresa treinam modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento.
Guias relacionados
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.