Abacate Pay MCP Server

🥑 Abacate Pay MCP Server

Um servidor MCP (Model Context Protocol) para integração com a API do Abacate Pay, permitindo gerenciar pagamentos, clientes e cobranças diretamente através de assistentes de IA como Claude e Cursor.

✨ Multi-Tenancy

🔐 Multi-tenancy ativo! O servidor suporta múltiplos clientes simultaneamente. Cada requisição pode incluir sua própria chave de API, permitindo que diferentes usuários/organizações usem o mesmo servidor MCP com suas respectivas contas do Abacate Pay.

O que você pode fazer

👥 Gerenciar clientes: Criar e listar clientes
💰 Criar cobranças: Links de pagamento e faturas
📱 QR Codes PIX: Pagamentos instantâneos
🎫 Cupons de desconto: Promoções e descontos
🔄 Simular pagamentos: Testar fluxos em desenvolvimento

🚀 Instalação e Configuração

1. Clone o repositório

git clone https://github.com/AbacatePay/abacatepay-mcp.git
cd abacatepay-mcp
bun install

📋 Pré-requisitos:

Bun instalado (versão 1.0.0 ou superior)

2. Configure no Claude Desktop

Modo Multi-Tenant (Recomendado):

{
  "mcpServers": {
    "abacate-pay": {
      "command": "bun",
      "args": ["/caminho/completo/para/abacatepay-mcp/src/index.ts"]
    }
  }
}

Modo Legacy (Compatibilidade):

{
  "mcpServers": {
    "abacate-pay": {
      "command": "bun",
      "args": ["/caminho/completo/para/abacatepay-mcp/src/index.ts"],
      "env": {
        "ABACATE_PAY_API_KEY": "sua_api_key_aqui"
      }
    }
  }
}

3. Configure no Cursor

Modo Multi-Tenant (Recomendado):

{
  "mcp.servers": {
    "abacate-pay": {
      "command": "bun",
      "args": ["/caminho/completo/para/abacatepay-mcp/src/index.ts"]
    }
  }
}

Modo Legacy (Compatibilidade):

{
  "mcp.servers": {
    "abacate-pay": {
      "command": "bun",
      "args": ["/caminho/completo/para/abacatepay-mcp/src/index.ts"],
      "env": {
        "ABACATE_PAY_API_KEY": "sua_api_key_aqui"
      }
    }
  }
}

⚠️ Importante:

Substitua /caminho/completo/para/abacatepay-mcp/ pelo caminho real onde você clonou o repositório
Modo Multi-Tenant: Não configure API key globalmente - ela será fornecida em cada requisição
Modo Legacy: Configure a API key globalmente para compatibilidade com versões anteriores

🔑 Como obter sua API Key

Acesse Abacate Pay
Vá em Integrar → API Keys
Copie sua API Key

📝 Exemplos de Uso

🎯 Campanha com Influencer

"Eu contratei um influencer chamado Alex para divulgar meu negócio. Você pode criar um cupom com 15% de desconto usando o código ALEX15 que vale para até 100 usos? Preciso acompanhar o desempenho da campanha."

🔍 Investigação de Cobranças

"Tive uma cobrança estranha ontem que não reconheço. Você pode buscar todas as cobranças de ontem e me mostrar os detalhes para eu verificar o que pode ter acontecido?"

💼 Novo Cliente Corporativo

"Acabei de fechar um contrato com a empresa TechSolutions LTDA (CNPJ: 12.345.678/0001-90). Pode criar o cadastro deles com o email contato@techsolutions.com e telefone (11) 3456-7890? Depois preciso gerar um QR Code PIX de R$ 10 para o pagamento."

🔐 Como Funciona

Modo Multi-Tenant (Recomendado)

Cada ferramenta aceita um parâmetro apiKey opcional:

Criar Cliente:

{
  "apiKey": "sua_chave_api_aqui",
  "name": "João Silva",
  "cellphone": "(11) 99999-9999",
  "email": "joao@exemplo.com",
  "taxId": "123.456.789-01"
}

Listar Clientes:

{
  "apiKey": "sua_chave_api_aqui"
}

Modo Legacy (Compatibilidade)

No modo legacy, as ferramentas funcionam sem o parâmetro apiKey:

Criar Cliente:

{
  "name": "João Silva",
  "cellphone": "(11) 99999-9999",
  "email": "joao@exemplo.com",
  "taxId": "123.456.789-01"
}

Vantagens

✅ Múltiplos usuários: Diferentes pessoas podem usar o mesmo servidor MCP
✅ Isolamento de dados: Cada API key acessa apenas seus próprios dados
✅ Flexibilidade: Pode usar com ou sem API key global
✅ Segurança: Credenciais não ficam armazenadas no servidor (modo multi-tenant)
✅ Escalabilidade: Fácil de compartilhar entre equipes
✅ Compatibilidade: Funciona com configurações existentes

🌐 Uso Remoto e Automação

HTTP Server para Automação

Para usar com ferramentas como n8n, Zapier, ou aplicações customizadas:

# Start HTTP server
bun run start:http

# Ou com porta customizada
MCP_PORT=8080 bun run start:http

Exemplo de Integração

HTTP Request (n8n/Zapier):

POST https://your-server.com/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "createPixQrCode",
    "arguments": {
      "apiKey": "user_specific_key",
      "amount": 1000,
      "description": "Pagamento via automação"
    }
  }
}

JavaScript/Node.js:

async function createCustomer(apiKey, customerData) {
  const response = await fetch('https://your-mcp-server.com/mcp', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/call',
      params: {
        name: 'createCustomer',
        arguments: { apiKey, ...customerData }
      }
    })
  });
  return response.json();
}

🐛 Problemas Comuns

Erro de API Key

❌ Falha ao criar cliente: HTTP 401: Unauthorized

Solução:

Modo Multi-Tenant: Verifique se sua API Key está correta e foi fornecida no parâmetro apiKey
Modo Legacy: Verifique se sua API Key está correta na configuração global

MCP Server não conecta

Solução:

Verifique se o caminho para o arquivo está correto
Reinicie o Claude Desktop/Cursor após adicionar a configuração
Certifique-se de que o Bun está instalado e funcionando

Erro de permissão

Solução: Certifique-se de que o Bun está instalado corretamente:

# Verificar instalação do Bun
bun --version

# Se necessário, instalar o Bun
curl -fsSL https://bun.sh/install | bash

🤝 Contribuição

Quer contribuir? Veja o Guia de Contribuição.

📄 Licença

MIT - veja LICENSE para detalhes.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables integration with Abacate Pay API for managing payments, customers, and billing through AI assistants. Supports multi-tenancy, PIX QR codes, discount coupons, and payment simulation with secure per-request API key authentication.

Related MCP Servers

Lightning Network MCP Server
AbdelStark
-
security
A
license
-
quality
Enables AI models to interact with the Lightning Network by providing an MCP-compliant API to pay invoices.
Last updated -
15
4
MIT License
Aptos Blockchain MCP
cuongpo
A
security
A
license
A
quality
Integrates Aptos blockchain access into AI applications, enabling interaction with tools for native APT operations, custom coin management, and transaction handling.
Last updated -
12
MIT License
Aptos Blockchain MCP
punkpeye
A
security
A
license
A
quality
Integrates Aptos blockchain access into AI applications, enabling interaction with tools for native APT operations, custom coin management, and transaction handling.
Last updated -
12
MIT License
freee会計 MCP Server
tsurutan
-
security
A
license
-
quality
Enables AI assistants to access and manage accounting data through the freee accounting API, supporting operations like transaction management, financial analysis, and account item management.
Last updated -
517
1
MIT License

View all related MCP servers

Abacate Pay MCP Server