Conecte seu agente de IA ao Money para consultar e gerenciar as informações financeiras da sua escola por meio do plugin oficial do PADMA Tools. ## Antes de começar Você precisa de: - Um usuário de PADMA com acesso à escola. - Uma versão recente do Codex ou Claude Code com suporte para servidores MCP remotos e OAuth. ## Instalar o plugin ### Codex 1. Adicione o marketplace do PADMA Tools: ```bash codex plugin marketplace add dwaynemac/padma-tools ``` 1. Abra /plugins no Codex CLI ou Plugins no app do Codex. 1. Escolha PADMA Tools e depois instale Money. 1. Inicie uma nova tarefa para que o agente carregue a skill e as ferramentas. Para atualizar o catálogo e os plugins instalados: ```bash codex plugin marketplace upgrade padma-tools ``` ### Claude Code ```bash claude plugin marketplace add dwaynemac/padma-tools claude plugin install money@padma-tools ``` Inicie ou reinicie o Claude Code para carregar a skill e as ferramentas. ## Autenticar a conexão Money usa Dynamic Client Registration (DCR). Cada instalação registra automaticamente seu próprio cliente OAuth e abre o PADMA Accounts para que você faça login e autorize uma ou mais contas. O Money mostrará apenas os negócios habilitados que você também possa usar localmente. ### Codex Depois de instalar ou atualizar o plugin, inicie uma nova tarefa. Se o Codex não abrir o navegador automaticamente, execute: ```bash codex mcp login money --scopes openid,profile,account,money ``` Complete o login e a autorização no PADMA Accounts. O Codex recebe o resultado em um callback local e salva a sessão OAuth no seu armazenamento seguro. ### Claude Code 1. Abra o Claude Code e execute /mcp. 1. Selecione money e escolha Authenticate. 1. Deixe vazios Client ID e Client Secret: DCR obtém automaticamente. 1. Complete o login e a autorização no PADMA Accounts. ## Verificar a conexão Peça ao agente: > Liste os negócios do Money que tenho autorizados. O agente deve executar list\_businesses, que retorna apenas os negócios autorizados por OAuth e utilizáveis no Money. - Se retornar um, pode selecioná-lo automaticamente. - Se retornar vários, o agente deve usar o negócio que você indicar ou perguntar qual deseja usar; não deve adivinhar. Depois deve executar get\_business\_context para o negócio selecionado e informar sua moeda, fuso horário, capacidades e limites. Em todas as tools seguintes manterá o mesmo business\_id quando a seleção for necessária. Teste depois uma consulta somente leitura: > Liste minhas contas e suas moedas. Antes de uma escrita, o agente deve mostrar a alteração exata proposta e pedir confirmação, a menos que você já tenha autorizado essa mesma operação na conversa atual. ## O que o plugin inclui O plugin Money: - Configura o servidor MCP remoto https://money.derose.app/mcp. - Autentica-se via OAuth e DCR, sem credenciais compartilhadas em prompts, variáveis de ambiente ou arquivos do projeto. - Descobre os negócios autorizados por meio de list\_businesses e seleciona um para cada workflow. - Incorpora a skill padma-money, com o modelo financeiro do Money, workflows seguros e as limitações reais das ferramentas. - Consulta contas, categorias, contatos, movimentos e relatórios. - Analisa despesas, receitas, períodos, subtotais e possíveis anomalias. - Cria e atualiza movimentos, contas, categorias, movimentos recorrentes, planos e regras de automação. - Aplica confirmação, idempotência, controle de concorrência e verificação após cada escrita. OAuth define a lista de negócios permitidos. business\_id funciona apenas como seletor dentro dessa lista: não concede acesso por si só. Um ID inexistente ou não autorizado é rejeitado sem revelar se pertence a outro tenant. ## Exemplos - “Quanto gastamos no mês passado, separado por categoria?” - “Busque movimentos sem categoria e proponha como classificá-los.” - “Registre esta despesa depois de me mostrar exatamente o que vai criar.” - “Compare este mês com o anterior e explique as variações relevantes.” - “Revise esta conta contra o extrato e liste as diferenças sem modificar nada.” ## Segurança - Não cole códigos de autorização, access tokens nem refresh tokens em prompts, documentos compartilhados, repositórios, URLs ou logs. - Não compartilhe Client IDs registrados dinamicamente entre usuários ou equipes. - Se o negócio que você precisa não aparecer em list\_businesses, desconecte money e volte a autorizar incluindo a conta correspondente. - O acesso de escrita não amplia a permissão: o agente deve modificar apenas os campos e registros autorizados. - Se suspeitar que uma sessão foi exposta, feche-a pelo cliente MCP e autentique-se novamente. ## Solução de problemas - O plugin não aparece: atualize o marketplace com codex plugin marketplace upgrade padma-tools e abra o catálogo novamente. - O servidor aparece sem ferramentas: atualize ou reinstale o plugin, reinicie o agente e autentique money. - “The requested redirect URI is malformed or doesn\u0026#39;t match…”: há uma configuração OAuth estática ou anterior. Remova a conexão e adicione novamente para que o DCR registre o callback exato. Não adicione um callback com \*. - Erro 401: a sessão OAuth está ausente, expirou ou foi revogada. Execute o login novamente ou Authenticate. - Erro 403: o usuário autenticado não tem acesso suficiente, a autorização não inclui os scopes requeridos ou o business\_id não pertence à lista autorizada. Não teste outros IDs aleatoriamente. - Erro business\_required: há vários negócios autorizados e a tool precisa que você selecione um. Execute list\_businesses e repita a operação com um dos IDs retornados. - Erro 429 durante o registro: mais de 10 registros foram feitos pela mesma IP em 60 segundos. Aguarde o tempo indicado em Retry-After e tente novamente. - Falta o negócio esperado: desconecte a sessão e volte a autorizar incluindo a conta correspondente no PADMA Accounts. - O agente pede confirmação para escrever: é o comportamento esperado e ajuda a evitar mudanças acidentais. ## Mais informações - Repositório PADMA Tools - PADMA Money - PADMA Accounts