Cómo conectar SAP Sales Cloud and Service Cloud (C4C) a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → SAP Sales Cloud and Service Cloud (C4C), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

SAP Sales Cloud and Service Cloud (C4C) + Gemini

Lectura de SAP Sales Cloud y Service Cloud (Cloud for Customer, C4C) a través de su API OData: cuentas, contactos, leads, oportunidades, ofertas de venta, solicitudes de servicio, productos y empleados, además de herramientas OData genéricas para cualquier otro entity set. Autenticación Basic, solo lectura.

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_C4C_HOST, SAP_C4C_USER, SAP_C4C_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos. Necesitas un tenant de SAP Sales Cloud o Service Cloud (Cloud for Customer, C4C) y un usuario con autenticación Basic, idealmente un usuario técnico de integración.

1. Recomendado: un usuario técnico de integración. En C4C ve a Administrator > Integration > Communication Systems y crea un sistema de comunicación. Después, en Communication Arrangements, crea un acuerdo con el escenario OData Services for Business Objects y la autenticación User ID and Password, y selecciona los servicios OData (como mínimo c4codataapi). El acuerdo muestra el id de usuario; la contraseña se define ahí.
2. Como alternativa, usa un usuario de negocio con autenticación Basic cuyos roles de negocio den acceso de lectura a los work centers que deba ver la IA.
3. Pon en SAP_C4C_HOST el host del tenant, por ejemplo my123456.crm.ondemand.com, sin https:// ni ruta, y rellena SAP_C4C_USER y SAP_C4C_PASSWORD.
4. Instala el conector y ejecuta sap_c4c_list_accounts con top 1 para comprobar el acceso.

Solo lectura: el conector lee la API OData V2 estándar del tenant, https://<tenant>.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi, y nunca escribe. SAP comprueba las autorizaciones del usuario en cada llamada, así que la IA solo ve lo que permiten el acuerdo de comunicación o los roles de negocio del usuario.

Qué lee: las cuentas corporativas (clientes y prospectos) con rol, estado, clasificación ABC, sector, responsable, dirección principal, teléfono y correo; las personas de contacto con su cuenta; los leads con estado del ciclo de vida, nivel de cualificación, origen y responsable; las oportunidades con fase de venta, estado, probabilidad, valor esperado y fecha de cierre prevista, para el pipeline de ventas; las ofertas de venta con importe neto y bruto, fecha de validez y la oportunidad a la que pertenecen; las solicitudes de servicio (tickets) con cliente, contacto, estado, prioridad, responsable de tramitación, categoría de servicio, vencimientos y tiempos de SLA, para la cartera pendiente de servicio; los productos; y los empleados, para convertir en nombres los ids de responsables y tramitadores. sap_c4c_guide explica el flujo de trabajo y no cuesta ninguna llamada a la API.

Cualquier otro entity set: las herramientas OData genéricas llegan al resto del servicio. sap_c4c_list_services indica dónde está el servicio, sap_c4c_describe_service lista todos los entity sets (una respuesta grande, en caché durante un día), sap_c4c_describe_entity muestra los campos con sus etiquetas, sap_c4c_query lee filas y sap_c4c_get_entity lee un registro por su ObjectID.

Consultas: los filtros admiten eq, ne, ge, le, gt, lt, and, startswith y endswith; or solo funciona sobre un campo. Las fechas se escriben datetimeoffset'2026-01-01T00:00:00Z', y EntityLastChangedOn encuentra lo que cambió desde un momento dado. search es la búsqueda de texto libre de SAP. Los registros tienen como clave ObjectID; los ids de negocio como AccountID o ID son campos aparte. La IA pide con select solo los campos que necesita.

Límites: como máximo 1000 filas por página (top, luego skip); las listas devuelven el recuento total. expand es lento en conjuntos grandes.

Errores comunes: 401 indica un usuario o contraseña incorrectos, o un usuario bloqueado. 403 significa que el acuerdo de comunicación o los roles de negocio del usuario no cubren este objeto de negocio. Un 404 en todas las llamadas suele indicar un SAP_C4C_HOST incorrecto. Un 400 nombra un campo o filtro que la API no acepta; sap_c4c_describe_entity muestra los nombres de campo correctos.

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 Sales Cloud and Service Cloud (C4C).

Herramientas disponibles

Ejemplos de prompts

• "Muéstrame las oportunidades abiertas con cierre previsto este trimestre, con fase de venta, probabilidad y valor esperado."
• "Busca la cuenta Ejemplo Industrias S.A. y lista sus contactos y sus solicitudes de servicio abiertas."
• "¿Qué solicitudes de servicio de prioridad alta están vencidas y quién las está tramitando?"
• "Lista los leads creados en los últimos 7 días por origen y nivel de cualificación."
• "¿Qué ofertas de venta caducan este mes y a qué oportunidades pertenecen?"

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