Agentes IA — Conexión por MCP
1. Objetivo
Conectar tu cuenta de HazConta a asistentes de inteligencia artificial — Claude (Web, Desktop y Claude Code) y ChatGPT — para consultar y operar tu contabilidad conversando: saldos, libros de IVA, partidas, reportes financieros, planillas y más.
2. Qué es MCP y qué te permite
MCP (Model Context Protocol) es el estándar abierto que permite a los asistentes de IA usar herramientas de sistemas externos. HazConta expone su ERP como un servidor MCP — el asesor financiero — con más de un centenar de herramientas organizadas por módulo:
| Área | Ejemplos de lo que puedes pedirle al asistente |
|---|---|
| Contabilidad | "Dame el balance de comprobación de junio", "crea la partida del pago de alquiler" |
| Libros de IVA | "¿Cuánto crédito fiscal llevo este mes?", "lista las compras de mayo sin contabilizar" |
| Bancos | "¿Cómo van los saldos bancarios?", "concilia los movimientos pendientes" |
| CxP / CxC | "¿Qué facturas vencen esta semana?", "estado de cuenta del cliente X" |
| Planillas | "Calcula la planilla de la quincena", "lista los empleados activos" |
| Reportes | "Estado de resultados del trimestre en PDF" |
3. Seguridad: el agente eres tú
La conexión funciona con tu usuario de HazConta: el asistente solo ve las empresas a las que tienes acceso y solo puede hacer lo que tus permisos permiten. No existe un "usuario robot" con superpoderes.
| Principio | Cómo se aplica |
|---|---|
| Identidad propia | Autenticación OAuth 2.1 (inicias sesión con tu usuario y 2FA) o token personal |
| Mismos permisos | Los roles y permisos de tu usuario aplican a cada herramienta |
| Mismas empresas | Solo las empresas vinculadas a tu cuenta |
| Revocación | Los tokens tienen vencimiento y se revocan desde tu Perfil en cualquier momento |
Un token MCP equivale a tu sesión: quien lo tenga puede consultar y operar como tú. Trátalo como una contraseña — no lo compartas, no lo publiques en repositorios y revócalo si sospechas que se filtró.
4. Clientes soportados
| Cliente | Método de conexión | Requiere token |
|---|---|---|
| Claude Web (claude.ai) | Conector personalizado + OAuth | No |
| Claude Desktop | Conector personalizado + OAuth | No |
| Claude Code (CLI) | OAuth o token personal en .mcp.json | Opcional |
| ChatGPT | Conector (OAuth/OIDC) | No |
| Otros clientes MCP | HTTP + token personal | Sí |
5. Mapa de procedimientos
| Código | Procedimiento | Responsable | Frecuencia |
|---|---|---|---|
| POE-IA-001 | Conexión de Claude y ChatGPT por MCP | Cada usuario | Una vez por dispositivo/cliente |
Además del asesor financiero del ERP, HazConta ofrece servidores MCP para Factura Electrónica y HazConta Flow (gestor de tareas), que se conectan con el mismo procedimiento usando su propia URL.