Cómo conectar SAP S/4HANA (OData) a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → SAP S/4HANA (OData), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

SAP S/4HANA OData + Gemini

Deja que tu IA lea SAP S/4HANA on-premise o Private Cloud a través de los servicios OData: encontrar servicios en el catálogo de SAP, leer sus campos con las etiquetas de SAP y consultar asientos contables, documentos de facturación, pedidos de cliente, interlocutores comerciales, stock y productos. Solo lectura, con un usuario técnico SAP.

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:

SAP_ODATA_BASE_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_ODATA_USER, SAP_ODATA_PASSWORD

Paso 1 — Obtener credenciales

1. Con la transacción SU01, crea en el mandante que la IA debe leer un usuario técnico de tipo System (no Dialog) con una contraseña productiva.
2. Asígnale un rol (PFCG) con S_SERVICE para los servicios OData que la IA puede usar y autorizaciones de negocio solo de visualización (actividad 03). Para que la IA pueda explorar el catálogo, permite también el servicio de catálogo V2 /IWFND/CATALOGSERVICE y el catálogo de servicios V4.
3. Comprueba que los servicios estén activos: /IWFND/MAINT_SERVICE para V2, /IWFND/V4_ADMIN para V4. Las herramientas listas usan las APIs liberadas de SAP API_JOURNALENTRYITEMBASIC_SRV, API_BILLING_DOCUMENT_SRV, API_SALES_ORDER_SRV, API_BUSINESS_PARTNER, API_MATERIAL_STOCK_SRV y API_PRODUCT_SRV.
4. Pon en SAP_ODATA_BASE_URL el host del Gateway con su puerto HTTPS y sin ruta, por ejemplo https://s4.example.com:44300. En SAP_CLIENT va el mandante de tres dígitos (por ejemplo 100), en SAP_LANGUAGE el idioma de acceso (por ejemplo ES; las etiquetas de los campos vuelven en este idioma), y en SAP_ODATA_USER y SAP_ODATA_PASSWORD el nombre y la contraseña del usuario técnico.
5. Instala el conector. No hay paso Authorize with Provider: el conector inicia sesión con Basic auth como el usuario técnico y envía el mandante y el idioma en cada llamada.
6. Llama primero a s4_guide (no cuesta nada y no contacta con SAP) y después a s4_list_services con un término de negocio como billing para comprobar que el usuario llega al catálogo.

Red: el puerto HTTPS del Gateway suele ser accesible solo dentro de la red de la empresa. Aloja AnythingMCP en esa red o conéctalo por VPN, y añade el host del Gateway a SSRF_ALLOWED_HOSTS, porque si no AnythingMCP rechaza las direcciones privadas. AnythingMCP Cloud solo funciona si el Gateway es accesible desde internet.

Cómo encuentra la IA los datos: s4_list_services busca un término de negocio en el catálogo de SAP (V2 y V4), s4_describe_service lista los entity sets de un servicio y marca los analíticos y los parametrizados, s4_describe_entity da cada campo con su etiqueta de SAP, el campo de moneda o unidad de cada importe y los filtros que exige un set, y s4_query y s4_get_entity leen filas. Los nombres de campo se comprueban contra el $metadata del servicio antes de enviar la llamada. Para los casos más comunes, s4_journal_entry_items, s4_billing_documents, s4_sales_orders, s4_business_partners, s4_material_stock y s4_products llaman directamente a las APIs liberadas, con filter, select, orderby, top y skip. Las herramientas del catálogo también funcionan con ECC o BW con SAP Gateway; las herramientas listas necesitan S/4HANA.

Permisos y configuración de solo lectura: las 12 herramientas solo leen. SAP comprueba las autorizaciones del usuario técnico en cada llamada, así que son el límite real: da al rol solo autorizaciones de visualización, y solo para las sociedades, organizaciones de ventas y centros que la IA puede ver. Para acotarlo más, indica en Allowed services, en los ajustes OData del conector, las rutas de servicio que la IA puede llamar (* sirve como comodín); los demás servicios se rechazan. Puedes desactivar herramientas sueltas en la página del conector.

Política de APIs de SAP: SAP espera que las integraciones de terceros usen sus APIs publicadas (los servicios API_* del SAP Business Accelerator Hub) o servicios desarrollados por ti. Prefiérelos a los servicios internos que hay detrás de las apps Fiori, y ajusta Allowed services en consecuencia.

Basic auth u OAuth: el conector se instala con Basic auth. Si tu Gateway está configurado para OAuth 2.0, puedes cambiar la autenticación del conector a OAuth 2.0 en la página del conector.

Límites: una consulta devuelve como máximo 1.000 filas, y las herramientas listas 100 por defecto (top). Para totales, la IA agrega en servicios analíticos o filtra por sociedad, organización de ventas o centro y por fecha o periodo contable, en lugar de recorrer todo página a página. Los importes llegan con su moneda y las cantidades con su unidad; los decimales vuelven como cadenas para que sigan siendo exactos.

Errores comunes: 401 significa usuario o contraseña incorrectos, o un usuario bloqueado en ese mandante. 403 Forbidden en un servicio significa que al usuario técnico le falta la autorización (S_SERVICE o el rol de negocio), y 404 que el servicio no está activo en este sistema. Si se rechaza una dirección privada, falta el host en SSRF_ALLOWED_HOSTS. Si las filas parecen datos de demostración, SAP_CLIENT apunta al mandante equivocado.

¿Mejor HANA SQL? Si la IA debe leer las tablas y vistas CDS de S/4HANA directamente con SQL, mediante un usuario de base de datos de solo lectura en lugar de las autorizaciones de aplicación de SAP, usa el conector SAP S/4HANA (HANA SQL). Para cualquier otro servicio OData V2 o V4, consulta el tipo de conector OData.

El conector no escribe en SAP: no contabiliza nada ni crea o modifica pedidos, documentos o datos maestros.

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 SAP S/4HANA OData.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué servicios OData de nuestro catálogo SAP tienen que ver con documentos de facturación, y cuáles de ellos son APIs liberadas?"
• "Muéstrame las ventas netas facturadas del mes pasado por organización de ventas a partir de los documentos de facturación, sin documentos anulados, con la moneda."
• "¿Cuánto stock tenemos del material FG-100 en el centro 1000, por almacén?"
• "Lista las 20 posiciones de asientos contables más grandes contabilizadas el mes pasado en la sociedad 1000, con cuenta de mayor, importe y moneda."

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