Conectar Kuenta por MCP desde Claude, ChatGPT y otras IAs

Qué es MCP en Kuenta

MCP (Model Context Protocol) permite que un asistente de IA consulte y registre movimientos en tu Kuenta con tu permiso: resumen del mes, gastos, ingresos, ahorros, historial y más.

La conexión usa OAuth: la IA nunca ve tu contraseña de Google. Inicias sesión en kuenta.lat, autorizas los permisos y el asistente recibe un token de acceso limitado en el tiempo.

URL del servidor MCP: https://api.kuenta.lat/mcp. Los clientes compatibles descubren la autenticación automáticamente en https://api.kuenta.lat/.well-known/oauth-protected-resource/mcp.

Claude (claude.ai)

En Claude, ve a Configuración → Conectores / Integraciones (o la sección MCP según tu plan) y elige añadir un conector personalizado o remoto.

Indica la URL del servidor: https://api.kuenta.lat/mcp. Claude detectará el flujo OAuth y te pedirá iniciar sesión.

Se abrirá kuenta.lat/oauth/authorize. Pulsa «Continuar con Google», revisa los permisos (leer resumen, transacciones, ahorros; registrar movimientos si lo autorizas) y confirma.

Al volver a Claude, el conector queda activo. Puedes pedirle cosas como «¿cuánto me queda este mes?», «registra un gasto de 45.000 en comida» o «muéstrame mis gastos fijos pendientes».

ChatGPT y apps con conectores MCP

En ChatGPT (conectores / apps / developer mode, según tu versión), crea un conector MCP remoto apuntando a https://api.kuenta.lat/mcp.

ChatGPT registrará el cliente vía OAuth (registro dinámico) y te redirigirá a kuenta.lat para autorizar con tu cuenta de Google, igual que en Claude.

Si la app pide scopes, acepta al menos read:summary y read:transactions para consultar; añade write:transactions si quieres que registre gastos o ingresos por ti.

Tras autorizar, las herramientas inteligentes (smart_add_expense, smart_get_period_summary, etc.) resuelven categorías y cuentas por nombre sin que memorices UUIDs.

Cursor, IDE y otros clientes MCP

Cualquier cliente MCP con transporte HTTP y OAuth puede usar Kuenta. En el manifiesto del conector suele bastar con la URL https://api.kuenta.lat/mcp; el cliente leerá /.well-known/oauth-authorization-server para los endpoints de token.

En desarrollo local, el API suele estar en http://localhost:5142/mcp y la autorización en http://localhost:3000/oauth/authorize (ajusta según tu entorno).

Gestiona conexiones activas desde tu cuenta en Kuenta (sección de integraciones OAuth) y revoca el acceso cuando ya no uses un asistente.

Requisitos antes de conectar

Necesitas una cuenta en Kuenta con onboarding completado (categorías, fuentes de dinero y, si aplica, gastos recurrentes).

Debes haber aceptado los términos y la política de privacidad vigentes en la app. Si no, las herramientas MCP responderán que falta la aceptación legal; complétala en kuenta.lat e intenta de nuevo.

Los permisos son granulares: puedes autorizar solo lectura o también escritura. Puedes revocar el token en cualquier momento sin borrar tus datos financieros.

Qué puede hacer la IA conectada

Consultar: resumen del período, transacciones, desglose por categoría, compromisos pendientes, ahorros, dashboard, historial entre meses.

Registrar: gastos ocasionales o fijos, ingresos, movimientos de ahorro, saldo real de cierre, categorías nuevas.

Editar o eliminar movimientos del mes abierto, cerrar período, snapshots de metas de ahorro y más — según los scopes que hayas concedido.