Conectar un agente (MCP)

Usa esto cuando quieras que un asistente de IA, como Claude, maneje Cadrumo contigo. El asistente lee tus registros, pide al motor que ejecute cálculos y explica los resultados en lenguaje llano. Toda cifra sigue procediendo del motor determinista, y nunca se envía nada a la Agencia Estatal de Administración Tributaria (AEAT): la superficie del agente expone las mismas órdenes locales y protegidas que la CLI.

Qué es la conexión del agente

Al instalar Cadrumo se instalan dos comandos: aeat, la aplicación, y cadrumo-mcp, un servidor MCP (Model Context Protocol) que la expone. MCP es un estándar abierto que permite a los asistentes invocar herramientas. Cualquier cliente compatible con MCP puede conectarse; Claude es uno de ellos.

El servidor expone como herramientas las operaciones de lectura y preparación de la CLI, además de una búsqueda fundamentada sobre el corpus legal del BOE y de la AEAT incluido. Rechaza la presentación en directo por diseño, exactamente igual que la CLI.

Comprueba que el servidor está instalado

cadrumo-mcp --help

Si no se encuentra el comando, instala primero Cadrumo — consulta Obtener Cadrumo.

Registrar el servidor

Registra cadrumo-mcp como servidor stdio. En los clientes que aceptan una definición de servidor JSON:

{
  "mcpServers": {
    "cadrumo": {
      "command": "cadrumo-mcp"
    }
  }
}

Esa es toda la configuración. Tras la instalación, el comando está en tu PATH y encuentra tu perfil del mismo modo que aeat, por lo que no necesita un directorio de trabajo ni una ruta propia.

Antes de la primera sesión del agente

El servidor usa el mismo almacén local cifrado y el mismo perfil activo que la CLI. Un servidor no puede responder a una petición de frase de contraseña, así que configura primero la frase de contraseña para ejecuciones desatendidas; consulta Ejecutar sin que se pida la frase de contraseña.

Qué puede y qué no puede hacer el agente

El agente puede importar y clasificar registros, ejecutar cálculos, verificar borradores y preparar exportaciones, porque son operaciones locales. No puede presentar, notificar ni enviar nada a la AEAT, y no puede inventar una cifra: los cálculos siempre se ejecutan dentro del motor determinista, y cada valor conserva sus referencias legales. Tú mismo revisas y presentas, exactamente igual que en la Guía de inicio rápido y en la guía de presentación.