MCP
MCP (Model Context Protocol) es el estándar por el que un agente de IA descubre y usa herramientas externas. Aikount expone su contabilidad como herramientas MCP, de modo que un agente compatible puede emitir facturas, capturar gastos, conciliar el banco o consultar impuestos sin que tú escribas código.
Hay dos maneras de conectarse, con las mismas herramientas de contabilidad por debajo. Elige según dónde corra tu agente.
Servidor remoto (hospedado)
Aikount hospeda un servidor MCP:
https://api.aikount.com/mcp
- Transporte streamable-HTTP.
- Autenticación por cabecera: envías tu token igual que en la API, con
Authorization: Bearer <token>(usa una claveagl_; ver Autenticación). - No hay que instalar nada: apuntas tu cliente MCP a la URL y le das el token.
Es la opción recomendada cuando tu agente vive en la nube o quieres evitar instalaciones locales.
Servidor local (aikount-mcp)
Para agentes que corren en tu máquina, publicamos el paquete aikount-mcp en PyPI. Lo más rápido es lanzarlo con uvx, sin instalar nada de forma permanente:
AIKOUNT_TOKEN=agl_tu_clave_aqui uvx aikount-mcp
- Transporte stdio (entrada/salida estándar), el habitual para clientes MCP de escritorio.
- Autenticación por la variable de entorno
AIKOUNT_TOKEN, con tu claveagl_.
Es la opción indicada cuando tu cliente MCP habla por stdio con procesos locales (muchos editores y CLIs de agentes lo hacen).
Remoto o local
Remoto (/mcp) | Local (aikount-mcp) | |
|---|---|---|
| Transporte | streamable-HTTP | stdio |
| Autenticación | Cabecera Authorization: Bearer | Env AIKOUNT_TOKEN |
| Instalación | Ninguna | uvx aikount-mcp |
| Herramientas | Las mismas de contabilidad | Las mismas de contabilidad |
Ambos caminos operan sobre tu empresa con el token que les des. Las mismas precauciones de una clave
agl_aplican aquí: es acceso completo a tu contabilidad.
Siguiente paso
Para enchufar esto en Claude Code, Cursor, Gemini CLI o Codex, sigue Conectar un agente.