Ad Relatorios

marcioclaudio268-code/ad-relatorios

Updated June 15, 2026
marcioclaudio268-code/ad-relatorios

ad-relatorios is a Claude Code skill in the AI & Agent Building category. Relatórios read-only do AD — raio-x do sistema, status de boletos, reajuste de mensalidades e organização de lançamentos, consultando o Supabase via MCP.

Key points

ad-relatorios
AI & Agent Building
AI-coding skill

Ad Relatorios by the numbers

Data as of Jul 7, 2026 (Skillselion catalog sync)

/plugin marketplace add marcioclaudio268-code/ad-relatorios

/plugin install ad-relatorios@ad-relatorios-br

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/marcioclaudio268-code/ad-relatorios.svg)](https://skillselion.com/skills/marcioclaudio268-code/ad-relatorios)

Last updated	June 15, 2026
Repository	marcioclaudio268-code/ad-relatorios ↗

What it does

Relatórios read-only do AD — raio-x do sistema, status de boletos, reajuste de mensalidades e organização de lançamentos, consultando o Supabase via MCP.

README.md

AD — Relatórios (plugin do Claude Code)

Plugin somente leitura para rodar os relatórios do hub contábil AD direto no Claude Code, sem abrir o site. Ele consulta o banco do AD (Supabase) via um servidor MCP em modo read-only travado no projeto — não altera nada.

O que vem dentro

Skills (rodam digitando /ad-relatorios:<nome>):

relatorio-sistema — raio-x geral: monitor por setor, boletos a receber, DRE do mês, mensalidades por regime, incoerências e pontos de atenção.
status-boletos — quem não pagou, vencidos, a receber, % lidos.
reajuste-mensalidades — quem está defasado por regime + sugestões.
organizar-lancamentos — incoerências do financeiro / o que falta categorizar.

Modo read-only: o plugin só lê e sugere. Aplicar baixas/lançamentos continua no site do AD.

Instalação (o desenvolvedor faz uma vez na máquina do chefe)

Pré-requisitos: Claude Code instalado + Node.js (para o npx).

1) Criar o token de acesso (read-only já é garantido pelo plugin)

No Supabase → ícone do perfil → Account → Access Tokens → Generate new token (nome: AD relatorios). Copie o valor (começa com sbp_...). Guarde — só aparece uma vez.

2) Salvar o token na máquina (persistente)

No PowerShell:

setx SUPABASE_ACCESS_TOKEN "sbp_cole_o_token_aqui"

Feche e reabra o terminal/Claude Code depois do setx (ele só vale em sessões novas).

3) Instalar o plugin (do GitHub — repo público, não precisa logar no GitHub)

No Claude Code (na máquina do chefe):

/plugin marketplace add marcioclaudio268-code/ad-relatorios
/plugin install ad-relatorios@ad-relatorios-br

Reabra o Claude Code para carregar o MCP.

Uso (o chefe)

Em qualquer chat do Claude Code, digite:

/ad-relatorios:relatorio-sistema

ou em linguagem natural: "me dá um relatório do sistema hoje". Outros:

/ad-relatorios:status-boletos — "quem não pagou?"
/ad-relatorios:reajuste-mensalidades — "quem está defasado?"
/ad-relatorios:organizar-lancamentos — "tem algo estranho no financeiro?"

Segurança

Somente leitura: o MCP roda com --read-only → só SELECT, nenhuma escrita.
Travado no projeto AD: --project-ref=wccuwsupevsezxlqfqsp e --features=database (só ferramentas de consulta).
Token fora do plugin: fica na variável de ambiente SUPABASE_ACCESS_TOKEN da máquina — nunca é commitado nem incluído no pacote. Para revogar o acesso, basta apagar o token no Supabase.

Atualizar

Repo: https://github.com/marcioclaudio268-code/ad-relatorios — faça commit/push de uma nova versão e, na máquina do chefe, rode /plugin update ad-relatorios.