N8N Mercado Pago MCP Node

Nó customizado do N8N para integração com o MCP Server do Mercado Pago.

Funcionalidades

🔍 Busca na Documentação

• Integração MCP: Conecta-se ao MCP Server para buscar informações na documentação do Mercado Pago
• Múltiplos Idiomas: Suporte para consultas em português, inglês e espanhol
• Busca Inteligente: Utiliza IA para encontrar informações relevantes

💳 Operações de Pagamento

• Criar Pagamento: Cria novos pagamentos com diferentes métodos
• Consultar Pagamento: Busca detalhes de pagamentos existentes
• Cancelar Pagamento: Cancela pagamentos pendentes
• Buscar Pagamentos: Lista e filtra pagamentos

👥 Gerenciamento de Clientes

• Criar Cliente: Registra novos clientes na plataforma
• Buscar Cliente: Consulta informações de clientes existentes
• Atualizar Cliente: Modifica dados de clientes
• Listar Clientes: Busca e filtra clientes

🛒 Preferências de Checkout

• Criar Preferência: Configura checkout personalizado
• Consultar Preferência: Busca configurações de checkout
• Atualizar Preferência: Modifica preferências existentes

🔔 Webhooks e Notificações

• Gerenciar Webhooks: Cria, atualiza e remove webhooks
• Processar Notificações: Processa notificações recebidas
• Eventos em Tempo Real: Monitora pagamentos e pedidos

🤖 Integração MCP (Model Context Protocol)

• MCP Server: Expõe todas as funcionalidades como servidor MCP
• Agentes de IA: Compatível com Claude, ChatGPT, Cursor, Windsurf
• Ferramentas para IA: 15+ ferramentas MCP para automação
• Automação Inteligente: Processamento de linguagem natural
• Workflows MCP: Exemplos prontos para uso

🛡️ Recursos Avançados

• Autenticação Segura: Configuração segura com Access Token
• Ambientes Múltiplos: Suporte para Sandbox e Produção
• Tratamento de Erros: Gerenciamento robusto de erros
• Testes Automatizados: Suite completa de testes unitários
• Documentação Completa: Exemplos de uso e configuração detalhada

🚀 Modos de Uso

1. Nó N8N Tradicional

Use diretamente no N8N para automação de workflows.

2. MCP Server para Agentes de IA

Expõe todas as funcionalidades para agentes de IA via protocolo MCP.

📖 Guia Completo de Integração MCP

Instalação

1. Via NPM (Recomendado)

npm install n8n-nodes-mercadopago-mcp

2. Instalação Manual

1. Clone este repositório
2. Execute pnpm install
3. Execute pnpm build
4. Copie a pasta dist para o diretório de nós customizados do N8N

Configuração

1. Credenciais

1. No N8N, vá em Credentials > Add Credential
2. Selecione Mercado Pago MCP API
3. Preencha:
   • Access Token: Seu token de acesso do Mercado Pago
   • Environment: Sandbox ou Production

2. Como obter o Access Token

1. Acesse Mercado Pago Developers
2. Vá em Suas integrações > Detalhes da aplicação
3. Copie o Access Token de teste ou produção

Uso

Buscar na Documentação

1. Adicione o nó Mercado Pago MCP ao seu workflow
2. Configure:
   • Resource: Documentation
   • Operation: Search
   • Query: Termo de busca (ex: "Como integrar Checkout Pro")
   • Language: Idioma da busca (pt, en, es)
3. Execute o workflow

Exemplos de Uso

🔍 Busca na Documentação

{
  "resource": "Documentation",
  "operation": "Search",
  "query": "Como criar um pagamento PIX?"
}

💳 Criar Pagamento

{
  "resource": "Payment",
  "operation": "Create",
  "amount": 100.50,
  "description": "Produto XYZ",
  "paymentMethodId": "pix",
  "payerEmail": "cliente@email.com"
}

👥 Criar Cliente

{
  "resource": "Customer",
  "operation": "Create",
  "email": "novo@cliente.com",
  "firstName": "João",
  "lastName": "Silva"
}

🛒 Criar Preferência de Checkout

{
  "resource": "Preference",
  "operation": "Create",
  "items": [
    {
      "title": "Produto A",
      "quantity": 1,
      "unit_price": 75.50
    }
  ]
}

🔔 Configurar Webhook

{
  "resource": "Webhook",
  "operation": "Create",
  "url": "https://meusite.com/webhook",
  "events": ["payment"]
}

Exemplo de Resposta

{
  "query": "Como integrar Checkout Pro",
  "language": "pt",
  "result": {
    "content": "Para integrar o Checkout Pro...",
    "documentation_url": "https://www.mercadopago.com.br/developers/..."
  },
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Casos de Uso

🤖 Automação de Pagamentos

• E-commerce: Automatize criação e processamento de pagamentos
• Assinaturas: Gerencie pagamentos recorrentes
• Marketplace: Processe pagamentos de múltiplos vendedores

📊 Gestão de Clientes

• CRM Integration: Sincronize dados de clientes
• Segmentação: Organize clientes por critérios específicos
• Comunicação: Automatize notificações personalizadas

🔄 Processamento de Webhooks

• Atualizações em Tempo Real: Processe eventos instantaneamente
• Reconciliação: Mantenha dados sincronizados
• Notificações: Envie alertas baseados em eventos

📚 Assistente de Documentação

• Busca Inteligente: Encontre informações rapidamente
• Geração de Código: Obtenha exemplos para diferentes cenários
• Suporte Técnico: Resolva problemas com IA

📈 Monitoramento e Analytics

• Dashboards: Crie painéis de controle personalizados
• Relatórios: Gere relatórios automatizados
• Alertas: Configure notificações baseadas em métricas

Desenvolvimento

Estrutura do Projeto

├── credentials/
│   └── MercadoPagoMcpApi.credentials.ts
├── nodes/
│   └── MercadoPagoMcp/
│       ├── MercadoPagoMcp.node.ts
│       └── mercadopago.svg
├── package.json
├── tsconfig.json
└── gulpfile.js

Scripts Disponíveis

# Desenvolvimento
pnpm dev          # Watch mode
pnpm build        # Build completo
pnpm lint         # Verificar código
pnpm test         # Executar testes

Limitações

• Atualmente suporta apenas a ferramenta search-documentation
• Requer Access Token válido do Mercado Pago
• MCP Server do Mercado Pago está em fase beta

Roadmap

• Suporte a mais ferramentas MCP
• Cache de respostas
• Métricas de uso
• Testes automatizados

Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature
3. Commit suas mudanças
4. Push para a branch
5. Abra um Pull Request

Licença

MIT License - veja o arquivo LICENSE para detalhes.

Suporte

• Documentação do Mercado Pago MCP
• Documentação do N8N
• Issues do GitHub