Cómo conectar Moedelo a Gemini vía MCP

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

Moedelo + Gemini

Conecta Moedelo (Моё Дело), el servicio ruso de contabilidad en línea, con Claude o ChatGPT: contrapartes y contratos, facturas de venta, actas, albaranes, facturas de IVA y UPD, documentos de compra, el registro de banco y caja, almacenes y mercancías, plan de cuentas, empleados y el calendario fiscal. Las escrituras 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:

MOEDELO_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos y solo necesitas tu cuenta de Moedelo.

1. Entra en Moedelo y abre Настройки (Ajustes), luego Интеграция с партнерами (integración con socios).
2. Activa la integración y copia la clave de API que aparece. Tiene forma de GUID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Si tu cuenta no tiene esa opción, solicita el acceso a la API en moedelo.org o en [email protected].
3. Pega la clave en MOEDELO_API_KEY, sola, sin comillas ni espacios.
4. Instala el conector y ejecuta moedelo_list_kontragents con tamaño de página 1: si devuelve una contraparte, la clave funciona.

Una clave, una empresa: la clave abre los datos de una empresa. Si llevas la contabilidad de una segunda empresa, instala el conector otra vez con la clave de esa empresa.

Cómo se organiza Moedelo: las contrapartes (контрагенты) son a la vez clientes y proveedores, y su id numérico filtra cualquier lista de documentos. En ventas hay facturas (счета), actas de servicios prestados (акты), albaranes (накладные, ТОРГ-12), facturas de IVA (счета-фактуры, normales y de anticipo) y UPD; los documentos vinculados a una factura muestran las actas, albaranes y pagos que la cierran. Los documentos de compra hacen lo mismo con los proveedores. El estado de factura 4 es sin pagar, 5 pagada en parte y 6 pagada. Los importes van en rublos.

Qué lee: contrapartes con INN, KPP, OGRN, direcciones, cuentas bancarias y personas de contacto; contratos (договоры); facturas de venta, actas, albaranes, facturas de IVA, facturas de anticipo y UPD con sus líneas e IVA, además de los documentos vinculados a una factura o un UPD; informes de ventas al por menor; actas, albaranes, facturas de IVA y UPD recibidos de proveedores; el registro de todas las operaciones de banco y caja de un periodo, cada operación en detalle, las cuentas bancarias propias, las cajas y su saldo en una fecha; almacenes, mercancías y servicios; el plan de cuentas y los asientos (проводки) que Moedelo generó para un documento; los empleados; y el calendario fiscal con los plazos de declaraciones y pagos.

Filtros: las listas de documentos filtran por número, por fecha del documento (docAfterDate, docBeforeDate) o de modificación y por contraparte, y se paginan con pageNo (desde 1) y pageSize. Un resultado vacío significa que nada coincide con los filtros.

Desactivadas al instalar: moedelo_create_kontragent, moedelo_update_kontragent y moedelo_create_bill. moedelo_update_kontragent reemplaza el registro completo, así que también hay que enviar todos los campos que deben conservarse. Una factura solo registra lo que se debe: no se hace ni se registra ningún pago. Un administrador activa solo lo necesario, e incluso entonces la IA te muestra la contraparte, las líneas y el IVA y espera tu sí.

Datos personales: los empleados y las contrapartes que son personas (particulares y autónomos) son datos personales según la ley rusa 152-FZ. Comparte lo que la IA lea sobre ellos solo con quien tenga permiso para verlo.

Errores comunes: 401 o 403 significa que la clave es incorrecta, fue revocada o pertenece a otra empresa. 404 en una herramienta de detalle indica un id equivocado.

El conector nunca hace, registra ni borra pagos, 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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Moedelo.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué facturas nuestras de septiembre siguen sin pagar y a qué contrapartes van?"
• "Busca la contraparte OOO Romashka y enséñame sus contratos y sus datos bancarios."
• "Muéstrame todas las operaciones de banco y caja de la semana pasada, cobros y pagos."
• "¿Qué declaraciones y pagos de impuestos vencen el próximo mes según el calendario fiscal?"
• "¿Qué actas y albaranes cierran la factura n.º 152, y ya está pagada?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT