Cómo conectar 1C:Enterprise a Gemini vía MCP

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

1C:Enterprise + Gemini

Lee tu infobase de 1C:Enterprise 8.3 (1С:Бухгалтерия, Управление торговлей, 1С:ERP, УНФ y otras configuraciones) a través de su interfaz OData estándar: catálogos, documentos con sus secciones tabulares, saldos, movimientos y valores a fecha de los registros, con los nombres de los metadatos de tu propia configuración. Solo lectura, autenticación Basic, tu propio servidor.

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:

ONEC_BASE_URL, ONEC_USER, ONEC_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 30 minutos y necesita a tu administrador de 1C. Necesitas una infobase de 1C:Enterprise 8.3 (plataforma 8.3.5 o posterior) publicada en un servidor web con la interfaz OData estándar activada, y un usuario de 1C propio para el conector.

1. Publica la infobase en un servidor web (Apache o IIS con los módulos de extensión de servidor web de la plataforma). En el Designer abre Администрирование → Публикация на веб-сервере (Administration → Publish to web server), dale a la publicación un nombre en letras latinas, marca Публиковать стандартный интерфейс OData (Publish standard OData interface) y publica. Si tu infobase está en un proveedor de hosting de 1C (1cFresh, alquiler en la nube), pide al proveedor que active OData.
2. Elige qué puede mostrar OData. De fábrica la interfaz no expone ningún objeto. En las configuraciones típicas abre Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData (o Все функции → Обработки → Настройка стандартного интерфейса OData) y añade los catálogos, documentos y registros que la IA puede leer. En otras configuraciones un desarrollador llama a УстановитьСоставСтандартногоИнтерфейсаOData().
3. Crea un usuario de 1C propio con roles de solo lectura sobre esos objetos y el derecho a usar la interfaz OData estándar. El formulario de ajustes del paso 2 puede crear este usuario por ti.
4. Compruébalo en el navegador: abre la dirección de la publicación seguida de /odata/standard.odata/?$format=json e inicia sesión con ese usuario. Una lista JSON de objetos significa que OData funciona; una lista vacía significa que falta el paso 2.
5. Pega la dirección de la publicación en ONEC_BASE_URL: la dirección con la que abres el cliente web, sin /odata y sin barra final, por ejemplo https://1c.example.com/trade. En ONEC_USER va el nombre de usuario tal como aparece en la lista de usuarios de la infobase (los nombres en cirílico funcionan) y en ONEC_PASSWORD su contraseña.
6. Instala el conector y ejecuta onec_enterprise_describe_service: lista cada objeto publicado en OData con sus claves. Una lista vacía significa que todavía no se ha añadido nada a la composición de OData.

Tu servidor debe ser accesible: AnythingMCP Cloud solo llega a direcciones de internet pública, así que publica por HTTPS en un host público; la contraseña viaja con autenticación HTTP Basic. Si el servidor de 1C está en tu red interna, instala AnythingMCP allí en modo self-hosted (o conéctalo por VPN) y añade el host a SSRF_ALLOWED_HOSTS.

Qué lee: catálogos, documentos con sus secciones tabulares, registros de información, de acumulación y contables, planes de cuentas, constantes y diarios de documentos, con los nombres de los metadatos de tu configuración, normalmente en ruso: Catalog_Номенклатура, Document_РеализацияТоваровУслуг con sus líneas en Document_РеализацияТоваровУслуг_Товары, AccumulationRegister_ТоварыНаСкладах, AccountingRegister_Хозрасчетный. Funciona con cualquier configuración de la plataforma: 1С:Бухгалтерия предприятия, Управление торговлей, 1С:ERP, Комплексная автоматизация, УНФ, Розница, ЗУП y las desarrolladas a medida.

Saldos, movimientos y valores a fecha: en los registros la IA lee las tablas virtuales Balance, Turnovers, BalanceAndTurnovers, SliceLast y SliceFirst con onec_enterprise_get, de modo que 1C filtra y agrega en el servidor en lugar de que la IA sume miles de líneas de documentos. Así responde sobre el stock a una fecha, las ventas de un periodo, el último tipo de cambio o el saldo de la cuenta 62.01.

Cómo trabaja la IA: onec_enterprise_guide explica nombres, filtros y registros sin coste. onec_enterprise_describe_entity muestra los campos de un objeto y sus tipos, onec_enterprise_query lee listas con filtro, orden, selección de campos y paginación, y onec_enterprise_get_entity lee un objeto por su Ref_Key junto con sus secciones tabulares. Los campos de referencia como Контрагент_Key contienen un GUID; la IA busca el nombre en vez de mostrarte GUID.

Totales limpios: la IA cuenta solo los documentos contabilizados (Posted eq true) y deja fuera los objetos marcados para eliminar, salvo que los pidas. Las fechas no llevan zona horaria: son la hora local de la infobase. Los importes están en la moneda del documento, salvo que el campo diga otra cosa.

Solo lectura: ninguna herramienta escribe. El conector nunca crea, cambia, contabiliza ni elimina nada, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar. El límite real son los derechos del usuario de 1C: 1C los comprueba en cada llamada, y lo que el usuario no puede ver no aparece en la respuesta, lo que puede parecer que faltan datos.

Límites: no hay un límite fijo de llamadas, pero cada consulta se ejecuta en tu servidor de 1C. La IA siempre usa $top y $select en catálogos y registros grandes y recorre las listas largas por páginas.

Errores frecuentes: 401 significa que 1C rechazó el inicio de sesión: revisa el usuario, la contraseña y el derecho a usar la interfaz OData estándar. 403 significa que el usuario entró pero no puede leer ese objeto: da a su rol derechos de lectura. 404 significa que el objeto no está en la composición de OData, que su nombre está mal escrito o que ONEC_BASE_URL es incorrecto (no debe contener /odata). 400 con "Ошибка при разборе опции запроса" indica un filtro o un nombre de campo erróneo. 500 en una infobase de archivo suele significar que la cuenta del servidor web no tiene permiso de escritura en la carpeta de la infobase.

El conector no crea, contabiliza ni elimina documentos, y solo ve los objetos que tu administrador añadió a la composición de OData.

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 1C:Enterprise.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es hoy el stock de cada artículo en el almacén principal, y qué artículos están por debajo de 10 unidades?"
• "¿Cuánto enviamos a Romashka LLC en septiembre, desglosado por documento de venta contabilizado?"
• "Busca la contraparte con INN 7707083893 y lista las facturas que le emitimos el mes pasado."
• "¿Qué tipo de cambio del dólar estadounidense tiene registrado 1C para hoy?"
• "¿Cuál es el saldo de la cuenta 62.01 a final de septiembre, y qué clientes lo forman?"

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
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot