Pagar.me MCP Server
MCP Server para financeiro Pagar.me v5 + Shopify. Consulta recebiveis, fluxo de caixa, conciliacao e dados de pedidos.
Tools Disponiveis
| Tool | Descricao |
|---|---|
recebiveis_periodo |
Recebiveis agrupados por dia (bruto, taxas, liquido) |
fluxo_pedido |
Parcelas de um pedido especifico com datas de recebimento |
fluxo_caixa |
Entradas, saidas, taxas e liquido por dia |
conciliar_dia |
Conciliacao Shopify x Pagar.me de um dia |
resumo_financeiro |
Resumo com quebra por metodo de pagamento |
buscar_pedido |
Info do pedido: cliente, valores, status, reembolsos |
sincronizar |
Atualiza banco local com dados das APIs |
listar_reembolsos |
Pedidos reembolsados num periodo |
Instalacao
cd C:/Users/mooui/mcp-servers/pagarme-mcp
pip install mcp httpx python-dotenv
Configuracao
Copiar .env.example para .env e preencher:
PAGARME_SECRET_KEY=sk_xxx
SHOPIFY_ACCESS_TOKEN=shpat_xxx
SHOPIFY_SHOP_URL=sua-loja.myshopify.com
PAGARME_DB_PATH=c:/projetos_code/pagar.me/pagarme.db
Registrar no Claude Desktop/Code
Adicionar ao claude_desktop_config.json:
{
"mcpServers": {
"pagarme": {
"command": "python",
"args": ["C:/Users/mooui/mcp-servers/pagarme-mcp/server.py"]
}
}
}
Uso
Uma vez registrado, o Claude pode responder perguntas como:
- "O que tenho pra receber essa semana?"
- "Qual o fluxo do pedido #14328?"
- "Concilia as vendas de ontem"
- "Quanto paguei de taxa esse mes?"
- "Lista os reembolsos de maio"
Arquitetura
server.py → Servidor MCP (stdio)
db.py → Consultas ao SQLite local (offline)
pagarme_client.py → Chamadas a API Pagar.me e Shopify (quando necessario)
O servidor prioriza consultas locais (banco SQLite). So acessa as APIs quando:
- Dados nao estao no banco (fallback)
- Conciliacao em tempo real (precisa do Shopify)
- Sincronizacao solicitada
