MCP ( AI Agents )

Este contenido conserva su idioma original.

Conectá tu agente de IA a Money para consultar y administrar la información financiera de tu escuela mediante el plugin oficial de PADMA Tools.

Antes de empezar

Necesitás:

Un usuario de PADMA con acceso a la escuela.
Una versión reciente de Codex o Claude Code con soporte para servidores MCP remotos y OAuth.

Instalar el plugin

Codex

Agregá el marketplace de PADMA Tools:

codex plugin marketplace add dwaynemac/padma-tools

Abrí /plugins en Codex CLI o Plugins en la app de Codex.
Elegí PADMA Tools y luego instalá Money.
Iniciá una tarea nueva para que el agente cargue la skill y las herramientas.

Para actualizar el catálogo y los plugins instalados:

codex plugin marketplace upgrade padma-tools

Claude Code

claude plugin marketplace add dwaynemac/padma-tools
claude plugin install money@padma-tools

Iniciá o reiniciá Claude Code para cargar la skill y las herramientas.

Autenticar la conexión

Money usa Dynamic Client Registration (DCR). Cada instalación registra automáticamente su propio cliente OAuth y abre PADMA Accounts para que inicies sesión y autorices una o más cuentas. Money mostrará únicamente los negocios habilitados que también puedas usar localmente.

Codex

Después de instalar o actualizar el plugin, iniciá una tarea nueva. Si Codex no abre el navegador automáticamente, ejecutá:

codex mcp login money --scopes openid,profile,account,money

Completá el inicio de sesión y la autorización en PADMA Accounts. Codex recibe el resultado en un callback local y guarda la sesión OAuth en su almacenamiento seguro.

Claude Code

Abrí Claude Code y ejecutá /mcp.
Seleccioná money y elegí Authenticate.
Dejá vacíos Client ID y Client Secret: DCR los obtiene automáticamente.
Completá el inicio de sesión y la autorización en PADMA Accounts.

Verificar la conexión

Pedile al agente:

Listá los negocios de Money que tengo autorizados.

El agente debe ejecutar list_businesses, que devuelve únicamente los negocios autorizados por OAuth y utilizables en Money.

Si devuelve uno, puede seleccionarlo automáticamente.
Si devuelve varios, el agente debe usar el negocio que indiques o preguntarte cuál querés usar; no debe adivinarlo.

Después debe ejecutar get_business_context para el negocio seleccionado e informar su moneda, zona horaria, capacidades y límites. En todas las tools siguientes conservará el mismo business_id cuando la selección sea necesaria.

Probá después una consulta de solo lectura:

Listá mis cuentas y sus monedas.

Antes de una escritura, el agente debe mostrar el cambio exacto propuesto y pedir confirmación, salvo que ya hayas autorizado esa misma operación en la conversación actual.

Qué incluye el plugin

El plugin Money:

Configura el servidor MCP remoto https://money.derose.app/mcp.
Se autentica mediante OAuth y DCR, sin credenciales compartidas en prompts, variables de entorno o archivos del proyecto.
Descubre los negocios autorizados mediante list_businesses y selecciona uno para cada workflow.
Incorpora la skill padma-money, con el modelo financiero de Money, workflows seguros y las limitaciones reales de las herramientas.
Consulta cuentas, categorías, contactos, movimientos y reportes.
Analiza gastos, ingresos, períodos, subtotales y posibles anomalías.
Crea y actualiza movimientos, cuentas, categorías, movimientos recurrentes, planes y reglas de automatización.
Aplica confirmación, idempotencia, control de concurrencia y verificación después de cada escritura.

OAuth define la lista de negocios permitidos. business_id funciona únicamente como selector dentro de esa lista: no concede acceso por sí mismo. Un ID inexistente o no autorizado se rechaza sin revelar si pertenece a otro tenant.

Ejemplos

“¿Cuánto gastamos el mes pasado, separado por categoría?”
“Buscá movimientos sin categoría y proponé cómo clasificarlos.”
“Registrá este gasto después de mostrarme exactamente qué vas a crear.”
“Compará este mes con el anterior y explicá las variaciones relevantes.”
“Revisá esta cuenta contra el extracto y listá las diferencias sin modificar nada.”

Seguridad

No pegues códigos de autorización, access tokens ni refresh tokens en prompts, documentos compartidos, repositorios, URLs o logs.
No compartas Client IDs registrados dinámicamente entre usuarios o equipos.
Si el negocio que necesitás no aparece en list_businesses, desconectá money y volvé a autorizar incluyendo la cuenta correspondiente.
El acceso de escritura no amplía el pedido: el agente debe modificar únicamente los campos y registros autorizados.
Si sospechás que una sesión fue expuesta, cerrala desde el cliente MCP y volvé a autenticar.

Solución de problemas

El plugin no aparece: actualizá el marketplace con codex plugin marketplace upgrade padma-tools y volvé a abrir el catálogo.
El servidor aparece sin herramientas: actualizá o reinstalá el plugin, reiniciá el agente y autenticá money.
“The requested redirect URI is malformed or doesn't match…”: hay una configuración OAuth estática o anterior. Eliminá la conexión y volvé a agregarla para que DCR registre el callback exacto. No agregues un callback con *.
Error 401: la sesión OAuth falta, venció o fue revocada. Ejecutá nuevamente el login o Authenticate.
Error 403: el usuario autenticado no tiene acceso suficiente, la autorización no incluye los scopes requeridos o el business_id no pertenece a la lista autorizada. No pruebes otros IDs al azar.
Error business_required: hay varios negocios autorizados y la tool necesita que selecciones uno. Ejecutá list_businesses y repetí la operación con uno de los IDs devueltos.
Error 429 durante el registro: se superaron 10 registros desde la misma IP en 60 segundos. Esperá el tiempo indicado en Retry-After y volvé a intentar.
Falta el negocio esperado: desconectá la sesión y volvé a autorizar incluyendo la cuenta correspondiente en PADMA Accounts.
El agente pide confirmación para escribir: es el comportamiento esperado y ayuda a evitar cambios accidentales.

Más información

Necesito más ayuda

Volver a MONEY