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 1. Agregá el marketplace de PADMA Tools: ```bash codex plugin marketplace add dwaynemac/padma-tools ``` 1. Abrí /plugins en Codex CLI o Plugins en la app de Codex. 1. Elegí PADMA Tools y luego instalá Money. 1. Iniciá una tarea nueva para que el agente cargue la skill y las herramientas. Para actualizar el catálogo y los 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 ``` 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á: ```bash 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 1. Abrí Claude Code y ejecutá /mcp. 1. Seleccioná money y elegí Authenticate. 1. Dejá vacíos Client ID y Client Secret: DCR los obtiene automáticamente. 1. 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 - Repositorio PADMA Tools - PADMA Money - PADMA Accounts