Cómo conectar Invoice123 a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Invoice123, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Invoice123 + Cursor

Invoice123 (Saskaita123), facturación para Lituania y Letonia, de solo lectura: facturas de venta con pagos, enlaces de pago y PDF, compras, clientes, productos, proyectos, albaranes, tipos de IVA, series y cuentas bancarias.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

INVOICE123_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Invoice123 (Saskaita123 en Lituania) en la que puedas instalar integraciones.

1. En Invoice123 abre el menú de la cuenta (arriba a la derecha), luego Integrations (icono de puzle) o Account settings > Integrations, e instala la integración API.
2. Pulsa Generate your API key, ponle un nombre y marca los permisos que la IA puede usar: como mínimo invoice:index, y además expense:index, client:index, product:index, project:index y waybills:index para esas áreas. El PDF de las facturas comprueba invoice:store, y el de las ofertas commercial:store.
3. Pega solo la clave en INVOICE123_API_TOKEN, sin la palabra Bearer, espacios ni comillas. El conector la envía como Authorization: Bearer.
4. Instala el conector y ejecuta invoice123_get_company para comprobar el token.

Qué lee: facturas de venta con cliente, líneas, IVA, totales, moneda, pagos e indicador de pagada; los pagos de una factura, es decir, cómo y cuándo se pagó (transferencia, efectivo, tarjeta, ticket de caja); el enlace de pago online de una factura cuando la empresa tiene Montonio o Paysera activado; PDF de facturas y ofertas comerciales en lituano, inglés o letón; facturas de compra (gastos) con tipos de gasto, IVA y pagos; clientes (clientes y proveedores); el catálogo de productos con precios y stock por almacén; proyectos con presupuesto; albaranes; y los datos de referencia: series de documentos, tipos de IVA de ventas y compras, cuentas bancarias, unidades, actividades, cajas registradoras y plantillas de correo.

Cómo lo usa la IA: cuando necesita ids, lee primero los datos de referencia, en una sola llamada con invoice123_get_invoice_data (actividades, series, bancos, unidades, tipos de IVA y almacenes) o lista a lista. Para partidas abiertas filtra invoice123_list_invoices por status unpaid o late, por un periodo con range y por un cliente con client_id; después, invoice123_list_invoice_payments muestra cómo se liquidó una factura.

Solo lectura: las 21 herramientas solo leen. En Invoice123 no se emite, envía ni cambia nada, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Páginas, fechas e importes: las listas devuelven data.result y data.pagination (current_page, last_page, total); la IA pasa page (desde 1) y limit (20 por defecto) y se detiene en last_page. Un rango de fechas son dos fechas YYYY-MM-DD unidas por una coma. Los importes son cadenas en la moneda de la factura, normalmente EUR.

Límites: 60 peticiones por minuto en el plan Standard, 1.000 por hora en Business. Por encima, Invoice123 responde 429.

Errores comunes: 401 significa un token incorrecto o eliminado. 403 significa que al token le falta el permiso indicado en la descripción de la herramienta; las compras, los albaranes y las ofertas necesitan además su módulo activado en la cuenta.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Invoice123.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas están vencidas, por qué importes y de qué clientes son?"
• "¿Cómo y cuándo se pagó la última factura a UAB Pavyzdys?"
• "Enumera las facturas de compra de este mes por tipo de gasto, con su IVA."
• "Dame el enlace de pago online de la factura abierta de UAB Pavyzdys."
• "Descarga el PDF de nuestra última factura en inglés."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot