Cómo conectar Rivile GAMA a Cursor vía MCP

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

Rivile GAMA + Cursor

Conecta Rivile GAMA, el sistema ERP y de contabilidad de Lituania, con Claude o ChatGPT a través de la Rivile API v2: clientes, productos, existencias y precios, documentos de compra y venta, deudas y pagos, saldos contables y plan de cuentas, con filtros T-SQL. Las modificaciones vienen desactivadas.

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:

RIVILE_API_KEY

Paso 1 — Obtener credenciales

Configurar el conector lleva unos minutos una vez que Rivile te ha habilitado la API v2. Necesitas Rivile GAMA 119 o posterior, un contrato de acceso a la API con Rivile, el Manorivile-Gateway funcionando junto a tu base de datos GAMA y la clave de API que Rivile entrega con el servicio.

1. Comprueba que el Manorivile-Gateway está instalado en un equipo o servidor que llega a tu base de datos GAMA. Lo instala tu partner de Rivile. Tiene que estar en marcha o ninguna llamada funcionará.
2. Pega la clave de API que te dio Rivile en RIVILE_API_KEY, sola, sin comillas ni espacios. Tiene la forma usuario, punto, secreto, por ejemplo XW3CDDX.Bfnjvrurjygzuj....
3. Instala el conector y ejecuta rivile_list_divisions: lista tus divisiones (padaliniai), lo que demuestra que la clave y el gateway funcionan.

La clave trabaja como un usuario de GAMA: la parte antes del punto es el usuario de Rivile GAMA con el que actúa la API, así que la IA ve lo que ve ese usuario. Además, Rivile habilita los métodos por clave en tu contrato de API: un método no habilitado responde con el mensaje "neturi leidimo vykdyti metodą".

Rivile puede facturar cada llamada: Rivile factura la API por número de peticiones. Por eso la IA prefiere una llamada bien filtrada a muchas páginas, y filtra por la clave del último registro recibido en lugar de paginar a fondo.

Cómo nombra Rivile las cosas: las tablas tienen una letra y dos cifras (N08 clientes, N17 productos y servicios, I06 documentos de compra y venta con sus líneas I07), y los campos llevan el código de la tabla más un sufijo: N08_KODAS_KS es el código de cliente en la tabla N08. Los filtros son condiciones T-SQL sin la palabra WHERE, como n08_pav like '%ACME%' o una fecha de documento entre dos fechas YYYY-MM-DD. Los códigos van en mayúsculas y los decimales con punto.

Qué lee: fichas de cliente (clientes y proveedores por igual) con códigos, números de IVA, dirección y condiciones de pago; fichas de productos y servicios; existencias por producto, división, objeto y serie, incluidas las reservadas; precios por división; documentos de compra y venta con sus líneas, también cruzados con campos de división, cliente y producto; operaciones internas como traspasos y bajas; deudas por documento con su vencimiento (la mejor fuente para una lista de vencidos) y saldos totales por cliente; operaciones de debe y haber; pagos de banco y caja con los documentos que liquidan; el registro de cobros y pagos; asientos contables y saldos de cuentas con movimientos de un periodo; el plan de cuentas, objetos, códigos de compra y venta, clasificadores de IVA (PVM klasifikatoriai), monedas, contratos y lotes de importación y exportación. rivile_call_read_method llega a cualquier otro método de lectura, por ejemplo tarifas, unidades, activos fijos, CRM o empleados.

Desactivadas al instalar: rivile_edit_client, rivile_edit_product, rivile_edit_document y rivile_create_document. Cada llamada crea, modifica o borra un registro en Rivile GAMA, y rivile_create_document contabiliza un documento de compra o venta completo con sus líneas. Un administrador activa solo lo necesario, e incluso entonces la IA te muestra el cliente, las líneas y los totales y espera tu sí.

Límites: cada lista devuelve como máximo 100 registros, y sin filtro la primera página de documentos trae los más recientes. Rivile permite 10 peticiones por segundo y clave; tras un 429 la IA espera al menos un segundo.

Errores comunes: 401 significa que la clave de API es incorrecta o ha caducado. 502 significa que el Manorivile-Gateway no está en marcha o no llega a la base de datos. 504 significa que la base de datos tardó demasiado: acota el filtro. 400 indica el campo o filtro erróneo con el mensaje de la base de datos, o dice que la clave no puede ejecutar ese método.

El conector no tiene herramientas de escritura para pagos, TPV, tarjetas regalo ni nóminas, y ninguna herramienta mueve dinero.

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 Rivile GAMA.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué clientes tienen deudas vencidas hace más de 30 días y cuánto debe cada uno?"
• "¿Cuánto tenemos del producto 10045 en cada división y cuánto está reservado?"
• "Enséñame los documentos de venta de este mes de UAB Statybų centras con totales e IVA."
• "Dame los saldos y movimientos de las cuentas contables de septiembre, sumados por cuenta."
• "¿Qué cobros recibimos la semana pasada y qué facturas liquidaron?"

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