Aikount

MCP de contabilidad

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.

Guías de configuración

• ChatGPT + Aikount
• Claude + Aikount

Servidor remoto (hospedado)

Aikount hospeda un servidor MCP:

https://api.aikount.com/mcp

• Transporte streamable-HTTP.
• No hay que instalar nada: apuntas tu cliente MCP a la URL.

Hay dos formas de autenticarse, y el cliente elige la que sabe hablar:

Con OAuth (conectores de Claude y similares)

Si tu cliente soporta el flujo OAuth de MCP —el caso de los conectores personalizados de Claude —, basta con pegar la URL. El cliente se registra solo, te abre el navegador, inicias sesión en Aikount y autorizas la conexión para la empresa activa. Puedes marcar solo lectura si quieres que el agente consulte pero no escriba.

El acceso concedido queda en Ajustes → API → Apps conectadas, y puedes revocarlo desde ahí en cualquier momento.

Con una API key

Si tu cliente permite cabeceras fijas, envía tu token igual que en la API: Authorization: Bearer <token> (una clave agl_; ver Autenticación). Por ejemplo, en Claude Code:

claude mcp add --transport http aikount https://api.aikount.com/mcp \
  --header "Authorization: Bearer agl_..."

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 clave agl_.

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.