Cómo conectar SAP SuccessFactors a Microsoft Copilot vía MCP

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

SAP SuccessFactors + Microsoft Copilot

Lee SAP SuccessFactors Employee Central a través de su OData API: empleados, información del puesto, personas, empresas, departamentos, posiciones y ausencias, además de herramientas OData genéricas para cualquier otra entidad. OAuth 2.0 SAML bearer, 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:

SF_API_URL, SF_COMPANY_ID, SF_CLIENT_ID, SF_SAML_ASSERTION

Paso 1 — Obtener credenciales

1. En SuccessFactors abre Admin Center → Manage OAuth2 Client Applications → Register Client Application. Genera ahí un certificado X.509 (o sube el tuyo), descarga la clave privada y copia en SF_CLIENT_ID la API Key que aparece tras el registro.
2. Genera una aserción SAML para el usuario de API con el generador offline de aserciones SAML de SAP (SAP Note 3031657): URL del token <api-server>/oauth/token, la API key como client id, el usuario de API, la clave privada y expireInMinutes con el tiempo durante el que la aserción debe seguir siendo válida. Pega la aserción en base64 en SF_SAML_ASSERTION.
3. Configura SF_API_URL con el servidor de OData API de tu centro de datos, sin /odata/v2, por ejemplo https://api4.successfactors.com o https://api012.successfactors.eu. Aparece en la List of SAP SuccessFactors API Servers de SAP y coincide con el host de tu URL de inicio de sesión.
4. Configura SF_COMPANY_ID con tu company ID: aparece bajo tu nombre (arriba a la derecha) → Show version information, y en la URL de inicio de sesión como company=.
5. Da al usuario de API el permiso de Employee Central API (Role-Based Permissions → Employee Central API: OData API access) y permiso de lectura sobre las entidades y los campos que la IA debe ver.
6. Instala el conector. Empieza con sap_successfactors_guide, que no consume llamadas a la API, y luego ejecuta sap_successfactors_list_users: una lista de empleados confirma que la conexión funciona.

Tokens: el conector cambia la aserción por un token de acceso válido durante 24 horas y lo renueva automáticamente mientras la aserción sea válida. Cuando la aserción caduque, genera una nueva y pégala en SF_SAML_ASSERTION. SAP retira la autenticación HTTP Basic para estas API el 20 de noviembre de 2026, por eso no se ofrece.

Solo lectura: la IA lee y no cambia nada en SuccessFactors. Cada llamada se ejecuta como el usuario de API que indica la aserción, así que los permisos basados en roles de SuccessFactors deciden qué ve.

Qué lee: perfiles de empleados con su userId, información del puesto (empresa, departamento, posición, responsable, estado laboral), registros de personas con datos personales, correos y teléfonos, entidades legales, departamentos, posiciones con vacante y FTE, y solicitudes de ausencia. Para cualquier otra entidad, sap_successfactors_get_entity_metadata enumera sus campos y las herramientas OData genéricas la leen.

Vigencia por fecha: la información del puesto, las empresas, los departamentos y las posiciones devuelven el registro vigente hoy. Pide una fecha o un rango de fechas cuando necesites el historial.

Límites: una página tiene como máximo 1000 filas, y la IA acota las listas grandes con filtros. SAP limita el uso intensivo de la API por tenant, así que la IA filtra por fecha de última modificación en lugar de leer todos los usuarios una y otra vez.

Conviene saber: los usuarios inactivos solo aparecen si los pides por estado, y los campos de lista de selección vuelven como códigos salvo que la IA expanda sus etiquetas.

El conector no contrata, no cambia datos del puesto ni de retribución, no aprueba ausencias ni escribe en ninguna entidad de SuccessFactors.

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de SAP SuccessFactors.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos empleados activos tenemos por departamento y quién dirige cada uno?"
• "¿Quién está ausente la semana que viene y qué solicitudes de ausencia siguen pendientes de aprobación?"
• "Enumera nuestras posiciones vacantes con su empresa, departamento y FTE."
• "Muéstrame el historial del puesto del empleado 10234 en los últimos dos años: cambios de departamento, posición y responsable."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse