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