Conectar un agente
Conectar un agente a Aikount son dos pasos: conseguir un token y enchufar ese token en tu cliente de agente. A partir de ahí, el agente lleva la contabilidad por ti mientras tú o tu gestor supervisáis.
Paso 1 — Consigue una clave de API
Desde una sesión iniciada, acuña una clave de API (prefijo agl_) en POST /api/v1/auth/api-keys. Guárdala como secreto; se muestra una sola vez. Los detalles están en Autenticación y claves de API.
Comprueba que funciona antes de seguir:
curl https://api.aikount.com/api/v1/tenants/me \
-H "Authorization: Bearer agl_tu_clave_aqui"
Paso 2 — Enchúfala en tu agente
Un agente puede usar Aikount de dos formas: por MCP (el agente descubre las herramientas de contabilidad) o por HTTP directo (el agente llama a los endpoints). La ruta MCP es la más cómoda para clientes de agente:
- Claude Code — añade el servidor MCP de Aikount. Remoto:
https://api.aikount.com/mcpcon la cabeceraAuthorization: Bearer agl_.... Local:uvx aikount-mcpconAIKOUNT_TOKEN=agl_.... - Cursor — configura Aikount como servidor MCP, remoto o local, con el mismo token.
- Gemini CLI — regístralo como servidor MCP, con el token en la cabecera (remoto) o en
AIKOUNT_TOKEN(local). - Codex — igual: añade el servidor MCP de Aikount con tu clave
agl_.
Los detalles de transporte y autenticación de cada modo (streamable-HTTP con cabecera, o stdio con AIKOUNT_TOKEN) están en MCP.
El fichero de skill (drop-in)
Para que un agente entienda de golpe cómo se usa Aikount —qué es, cómo se autentica, qué endpoints hay— publicamos un fichero de skill listo para incorporar:
https://aikount.com/skills/agentledger/SKILL.md
Dáselo a tu agente como contexto (o colócalo donde tu cliente cargue skills). Resume el modelo de autenticación y los endpoints principales, para que el agente empiece a operar sin que tú se lo expliques.
Buenas prácticas
- Usa una clave por agente/entorno, así puedes revocar una sin afectar a las demás.
- No metas la clave en el repositorio ni en logs; pásala por variable de entorno o gestor de secretos.
- Empieza en la demo o en datos de prueba antes de dejar al agente operar sobre datos reales.