Mini Accountant

Facturación, gastos, IVA y multimoneda para pequeñas empresas, gestionado desde tu asistente de IA a través de un servidor MCP remoto con OAuth — sin necesidad de pegar una clave API.

GitHubPrueba este MCPPatrocinado

Documentación

Mini Accountant — Configuración de MCP

Conecta tu asistente de IA a tu espacio de trabajo de Mini Accountant a través de nuestro servidor Model Context Protocol (MCP) alojado. Sin configuración local, sin claves API — el servidor es remoto y está protegido por OAuth 2.1, por lo que inicias sesión una vez con tu cuenta de Mini Accountant y tu asistente actúa en tu nombre.

  • Servidor: mini-accountant
  • Transporte: HTTP transmisible
  • URL: https://mcp.miniaccountant.app/v1beta
  • Autenticación: OAuth 2.1 / OIDC (Código de Autorización + PKCE) — se te pedirá iniciar sesión.

Lo que puedes hacer

Una vez conectado, el asistente puede:

  • Facturas — crear, leer, actualizar, eliminar; añadir/actualizar/eliminar posiciones y transacciones; cambiar el cliente en una factura.
  • Clientes — crear, leer, actualizar, eliminar; establecer el método de pago de un cliente.
  • Gastos — crear, leer, actualizar, eliminar; obtener gastos de un período.
  • Servicios — gestionar tu catálogo reutilizable de productos/servicios.
  • Configuración de pagos — gestionar los documentos de métodos de pago que los clientes consultan.
  • Analítica — ejecutar consultas de informes; obtener facturas/transacciones/gastos de un rango de fechas; estimar impuestos de un período.
  • Cuenta — leer y actualizar tu perfil de usuario y la configuración de la aplicación.

También se exponen habilidades y prompts guiados (por ejemplo, "crear una factura") para que el asistente descubra automáticamente el flujo de trabajo correcto.

Instalar en Claude Code (plugin)

La vía más rápida — instala el servidor remoto como plugin, sin archivo de configuración manual.

/plugin marketplace add miniaccountant/mcp-setup
/plugin install mini-accountant@miniaccountant
/reload-plugins

Luego ejecuta /mcp y completa el inicio de sesión OAuth cuando se te solicite. Eso es todo — las herramientas de mini-accountant ya están disponibles en tu sesión.

¿Prefieres no usar el marketplace? Añade el servidor directamente:

claude mcp add --transport http mini-accountant https://mcp.miniaccountant.app/v1beta

Conectar desde otros clientes

Misma URL remota, mismo inicio de sesión OAuth — solo cambia la ubicación de la configuración.

Conectores de Claude Desktop / claude.ai

Añade un conector personalizado que apunte a la URL del servidor:

  1. Abre Configuración → Conectores → Añadir conector personalizado (claude.ai) o el equivalente en Claude Desktop.
  2. Nombre: Mini Accountant
  3. URL: https://mcp.miniaccountant.app/v1beta
  4. Guarda, luego conéctate e inicia sesión con tu cuenta de Mini Accountant cuando se te solicite.

Cursor

Añade a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "mcpServers": {
    "mini-accountant": {
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

Recarga Cursor y luego autoriza el servidor cuando Cursor abra el prompt de OAuth.

VS Code (GitHub Copilot / MCP) y otros clientes

Cualquier cliente que admita servidores MCP remotos/HTTP transmisible funciona con el mismo endpoint. Usa el formulario de servidor HTTP del cliente:

{
  "servers": {
    "mini-accountant": {
      "type": "http",
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

Autenticación

El servidor implementa OAuth 2.1 / OpenID Connect con:

  • Concesión de Código de Autorización + PKCE (S256), tokens de actualización.
  • Registro Dinámico de Clientes (RFC 7591) — los clientes se registran automáticamente.
  • Documentos de descubrimiento:
    • https://mcp.miniaccountant.app/.well-known/oauth-authorization-server
    • https://mcp.miniaccountant.app/.well-known/oauth-protected-resource
    • https://mcp.miniaccountant.app/.well-known/openid-configuration

Los clientes MCP compatibles descubren estos automáticamente — solo necesitas la URL del servidor. Los tokens se emiten para tu cuenta; el asistente solo puede ver y cambiar tus datos.

Solución de problemas

  • 401 Unauthorized / se te pide iniciar sesión de nuevo — el token de acceso expiró (TTL de 1 hora). Vuelve a ejecutar la acción de conectar/autorizar del cliente.
  • Las herramientas no aparecen — confirma que el cliente completó el flujo OAuth (en Claude Code, ejecuta /mcp y verifica que el servidor muestra conectado).
  • Espacio de trabajo incorrecto — cierra sesión del conector y vuelve a conectar con la cuenta correcta de Mini Accountant.

Soporte