Conecta Claude con tu gestión financiera en Alfi
Consulta, registra y ajusta tus proyectos financieros directamente desde una conversación con Claude. Sin exportar datos, sin copiar tablas.
"Registra un gasto de $120.000 en transporte"
// Claude actúa en Alfi:
"tool": "create_gasto",
"valor": 120000,
"concepto": "transporte"
// Confirma con el disponible actualizado
"disponible_subrubro": 880000
1. ¿Qué puede hacer Claude con Alfi?
El conector MCP (Model Context Protocol) de Alfi conecta a Claude con tu plataforma financiera en tiempo real. No es solo lectura: Claude puede consultar, registrar y ajustar datos según los permisos que tienes en cada proyecto.
Consultar
Claude accede a presupuestos, gastos, ingresos, cashflow, órdenes y fechas clave de tus proyectos. Disponible para todos los roles.
Registrar y editar
Claude puede crear gastos, ingresos, presupuestos y proyectos. También editarlos. Requiere rol admin o gestor en el proyecto.
Eliminar
Claude puede eliminar gastos, ingresos y categorías. Requiere rol administrador en el proyecto.
Siempre con tu autorización
Claude solo actúa con los permisos que tienes en Alfi. Nada ocurre sin que tú lo pidas. Puedes revocar el acceso en cualquier momento.
2. Requisitos
Cuenta en Alfi
Necesitas una cuenta activa en alfi.com.co con acceso a al menos un proyecto financiero.
Registrarse gratisCuenta en Claude.ai
El conector funciona con planes Free, Pro, Max, Team y Enterprise. Los usuarios Free pueden agregar un conector MCP personalizado.
Ir a Claude.ai3. Cómo conectarlo
El proceso es guiado y toma menos de 2 minutos:
Abre Claude y ve a la configuración de conectores
En claude.ai, ve a Settings → Connectors (o Integrations según tu versión) y haz clic en "Add connector".
Busca Alfi o agrégalo manualmente
Si Alfi aparece en el directorio de conectores, selecciónalo directamente. Si no, elige "Add custom connector" e ingresa la siguiente URL:
Inicia sesión con tu cuenta de Alfi
Claude abrirá automáticamente una pantalla de autorización. Ingresa el correo y contraseña de tu cuenta Alfi. Tus credenciales nunca se comparten con Anthropic — solo se generan tokens de acceso temporales.
Confirma los permisos
Verás una pantalla de consentimiento que describe lo que Claude podrá hacer: consultar y, según tu rol, registrar o editar datos en tus proyectos de Alfi. Haz clic en "Autorizar".
¡Listo! Empieza a pedir consultas o acciones
El conector aparecerá como activo. Abre una nueva conversación en Claude y pídele que consulte tus proyectos, registre un gasto o ajuste el presupuesto.
4. Herramientas disponibles
Claude dispone de más de 30 herramientas agrupadas por intención. Las usa automáticamente según lo que le pidas.
Disponible para todos los roles (admin, gestor, observador).
list_projects
Lista todos los proyectos a los que tienes acceso activo.
get_project_summary
Resumen financiero del mes actual: gastos, ingresos, presupuesto y balance.
get_project_context
Contexto financiero completo por mes, año o rango personalizado.
query_gastos
Busca gastos con filtros: fechas, proveedor, subrubro, monto, estado. Devuelve totales reales + paginación.
query_ingresos
Busca ingresos con filtros: fechas, pagador, subitem, monto, estado. Devuelve totales reales + paginación.
get_catalog
Catálogo ligero del proyecto: rubros, subitems de flujo, centros de costo y sus IDs.
Requiere rol admin o gestor en el proyecto.
create_gasto
Registra un gasto. Crea el proveedor automáticamente si no existe. Devuelve el disponible actualizado del subrubro.
create_ingreso
Registra un ingreso. Vincula al pagador en el catálogo de la organización.
create_project
Crea un nuevo proyecto con rubros y subitems iniciales, distribuyendo presupuesto y flujo por todos los meses.
Admin: edita cualquier registro. Gestor: solo edita los registros que él mismo creó.
edit_gasto
Modifica fecha, concepto, valor, proveedor, subrubro o soporte de un gasto existente.
edit_ingreso
Modifica fecha, pagador, valor o descripción de un ingreso existente.
edit_project
Renombra el proyecto o ajusta fechas de inicio/fin. Solo admin.
edit_presupuesto
Actualiza el presupuesto de un subrubro para un mes (YYYY-MM) o distribuye un total anual (YYYY). Solo admin.
edit_flujo_caja
Actualiza el flujo planeado de un subitem de ingreso para un mes o año. Solo admin.
Edición eficiente en lote
Usa estas herramientas cuando necesites actualizar múltiples subrubros o períodos en una sola operación (hasta 50 operaciones por llamada). Son mucho más rápidas que múltiples llamadas individuales.
batch_edit_presupuesto
Actualiza presupuesto de varios subrubros y períodos en una sola transacción. Soporta rangos YYYY-MM:YYYY-MM.
batch_edit_flujo_caja
Actualiza flujo planeado de varios subitems y períodos en una sola transacción. Soporta rangos de meses.
Requiere rol administrador en el proyecto.
create_rubro_presupuesto
Crea un rubro con sus subrubros. Genera automáticamente las entradas de presupuesto para todos los meses del proyecto.
create_subrubro_presupuesto
Agrega un subrubro a un rubro existente.
rename_rubro_presupuesto
Renombra un rubro de presupuesto.
rename_subrubro_presupuesto
Renombra un subrubro de presupuesto.
create_categoria_flujo
Crea una categoría de flujo de ingresos con sus subcategorías.
create_subcategoria_flujo
Agrega una subcategoría a una categoría de flujo existente.
rename_categoria_flujo
Renombra una categoría de flujo de ingresos.
rename_subcategoria_flujo
Renombra una subcategoría de flujo.
Requiere rol administrador en el proyecto. Las eliminaciones son permanentes.
delete_gasto
Elimina un gasto independiente. Gastos vinculados a órdenes de compra o pago deben gestionarse desde la plataforma.
delete_ingreso
Elimina un ingreso y su registro de tasa ponderada asociado.
delete_rubro_presupuesto
Elimina un rubro y sus subrubros si no tienen gastos asociados.
delete_categoria_flujo
Elimina una categoría de flujo y sus subcategorías si no tienen ingresos asociados.
5. Ejemplos de uso
Consultas
Acciones
6. Solución de problemas
- Elimina el conector en Claude.ai y agrégalo de nuevo — a veces queda cacheado un intento fallido.
- Verifica que alfi.com.co esté disponible abriendo el sitio en tu navegador.
- Si el problema persiste, escribe a [email protected] con el código de referencia que te muestra Claude.
- Verifica que tu usuario tenga al menos un proyecto con estado de relación activo en Alfi.
- Confirma que el proyecto esté en estado activo y no archivado.
- Si usas múltiples cuentas, asegúrate de haber autorizado con el correo correcto.
- Observador: solo puede consultar información.
- Gestor: puede registrar gastos e ingresos, y editar los que él mismo creó.
- Administrador: puede crear, editar y eliminar cualquier registro.
7. Seguridad y privacidad
OAuth 2.0 + PKCE
El conector usa el estándar OAuth 2.0 con PKCE S256. Tus credenciales de Alfi nunca se comparten con Anthropic. Solo se entrega un token de acceso de tiempo limitado (1 hora).
Tokens como hash
Los tokens se almacenan en la base de datos solo como hash SHA-256. No existe forma de recuperar el token original desde el servidor de Alfi.
Acceso por usuario
Cada token está vinculado a un usuario específico. Claude solo puede ver y actuar sobre los proyectos a los que ese usuario tiene acceso activo en Alfi.
Permisos por rol
Las acciones de escritura respetan el rol del usuario dentro de cada proyecto. Claude no puede hacer nada que tú mismo no puedas hacer dentro de Alfi.
Solo actúa cuando tú lo pides
Claude no realiza acciones en segundo plano. Cada operación de escritura ocurre porque tú la solicitaste explícitamente en la conversación.
Revocación inmediata
Puedes eliminar el conector desde Claude.ai en cualquier momento. El token queda invalidado de inmediato en el servidor de Alfi.
Para más información sobre cómo Alfi protege tus datos, consulta nuestra Política de Tratamiento de Datos Personales.
Tu asistente financiero siempre disponible
Conecta Claude con Alfi y empieza a gestionar tus proyectos en lenguaje natural. Consulta, registra y ajusta sin salir de la conversación.
Alfi + Claude
conectados de forma segura