Conectar un agente
Elige cómo conectar tu agente a Aikount. ChatGPT y Claude usan MCP remoto con inicio de sesión OAuth; los agentes de desarrollo también pueden usar una API key.
ChatGPT y Claude: conexión sin código
Abre Conectar agente en la app, copia https://api.aikount.com/mcp y sigue la guía de tu asistente. Autoriza la empresa y los permisos desde Aikount.
Los pasos con API key que siguen son para clientes de desarrollo y scripts.
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"
En Windows PowerShell (5.1, la que trae Windows) curl no es el curl de verdad; usa:
Invoke-RestMethod -Uri "https://api.aikount.com/api/v1/tenants/me" -Headers @{ 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.
Para instalarlo como skill de Claude Code (carpeta ~/.claude/skills/agentledger/; en Windows, %USERPROFILE%\.claude\skills\agentledger\):
# macOS / Linux
mkdir -p ~/.claude/skills/agentledger
curl -fsSL https://aikount.com/skills/agentledger/SKILL.md -o ~/.claude/skills/agentledger/SKILL.md
# Windows PowerShell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\agentledger" | Out-Null
Invoke-WebRequest -UseBasicParsing -Uri "https://aikount.com/skills/agentledger/SKILL.md" -OutFile "$env:USERPROFILE\.claude\skills\agentledger\SKILL.md"
El botón Conectar agente de la app te da estos comandos con tu token ya incluido y elige solo la variante de tu sistema.
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.