MCP ( Agentes de IA )

Tradução automática. Ver original

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

Adicione o marketplace do PADMA Tools:

codex plugin marketplace add dwaynemac/padma-tools

Abra /plugins no Codex CLI ou Plugins no app do Codex.
Escolha PADMA Tools e depois instale Money.
Inicie uma nova tarefa para que o agente carregue a skill e as ferramentas.

Para atualizar o catálogo e os plugins instalados:

codex plugin marketplace upgrade padma-tools

Claude Code

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:

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

Abra o Claude Code e execute /mcp.
Selecione money e escolha Authenticate.
Deixe vazios Client ID e Client Secret: DCR obtém automaticamente.
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

Preciso de mais ajuda

Voltar para MONEY