Cómo conectar tu asistente de IA a AdminJR con MCP

AdminJR expone una API pensada para que un asistente de IA conectado por MCP (Model Context Protocol) pueda leer y registrar información en tu cuenta a nombre tuyo: consultar tus cuentas y saldos, revisar transacciones o registrar un gasto que le dictas por chat o voz.

Todo el acceso se controla con tokens personales: cadenas secretas que tú generas, con permisos y fecha de vencimiento definidos por ti. Cualquier aplicación o asistente que tenga el token puede actuar como si fueras tú, así que trátalo con el mismo cuidado que una contraseña.

1. Crea tu token de acceso

Inicia sesión en AdminJR y entra a Integraciones IA en el menú lateral.
Lee el aviso de beneficios y riesgos, y confirma que lo entiendes.
Completa el formulario:
- Nombre: algo que te ayude a identificarlo después, ej. "Asistente de gastos en Claude".
- Descripción: para qué lo vas a usar y qué IA lo consumirá.
- Permisos: "Solo lectura" si solo quieres consultar datos, o "Lectura y escritura" si también quieres que registre movimientos.
- Vence en: 7, 30, 90 días o 1 año. No existen tokens permanentes.
Copia el token que se muestra: solo se ve una vez. Guárdalo en un lugar seguro (tu gestor de contraseñas, por ejemplo).

2. Úsalo desde tu asistente o herramienta de automatización

El token se envía como un Bearer token en el header Authorization de cada solicitud. Por ejemplo, para confirmar que el token funciona y ver qué permisos tiene:

curl https://tu-dominio.com/api/mcp/whoami \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Accept: application/json"

Si configuras un servidor o cliente MCP genérico, normalmente solo necesitas indicarle la URL base (/api/mcp) y el token como credencial de autenticación tipo Bearer. Consulta la referencia técnica para ver todos los endpoints disponibles.

3. Ejemplos de automatización

Registro de gastos por chat: le dices a tu asistente "gasté 250 pesos en gasolina" y este llama a la API para crear la transacción en la cuenta correcta.
Consulta de saldos: tu asistente responde "¿cuánto tengo en mi cuenta BBVA?" leyendo /api/mcp/cuentas en tiempo real.
Reportes automáticos: un flujo programado (n8n, Zapier, un script propio) consulta tus transacciones del mes y te envía un resumen.

4. Buenas prácticas de seguridad

Crea un token distinto por cada asistente o automatización, con un nombre y descripción claros.
Usa "Solo lectura" salvo que realmente necesites que la IA registre información por ti.
Nunca compartas el token por chat, correo o lo subas a un repositorio público.
Si sospechas que se filtró, revócalo de inmediato desde Integraciones IA: el acceso se corta al instante.
Un token nunca puede leer ni escribir datos de otro usuario, sin importar qué le pidas o qué IDs use: siempre queda limitado a tu propia cuenta.