Pagar.me MCP Server

MCP Server para financeiro Pagar.me v5 + Shopify. Consulta recebiveis, fluxo de caixa, conciliacao e dados de pedidos.

Tools Disponiveis

Related MCP server: mcp-shopify

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