Cómo conectar Deputy a Microsoft Copilot vía MCP

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

Deputy + Microsoft Copilot

Gestión de personal con Deputy para una instalación: empleados, ubicaciones y áreas, turnos (rosters) con copia y publicación, partes de horas con fichaje de entrada y salida y aprobación, ausencias e indisponibilidad, memos, notas del responsable y cualquier otro registro a través de la resource query API. Se conecta con un token permanente.

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:

DEPUTY_HOST, DEPUTY_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos y necesita un administrador del sistema de Deputy.

1. Apunta la dirección de tu instalación desde la barra del navegador con la sesión iniciada, por ejemplo mycompany.au.deputy.com (regiones au, eu, uk y na para EE. UU.). Ponla en DEPUTY_HOST sin https:// y sin ruta.
2. Abre https://<la dirección de tu instalación>/exec/devapp/oauth_clients, añade un cliente OAuth (cualquier nombre y descripción; el client id no se usa) y haz clic en Get an Access Token.
3. Copia enseguida el token permanente (solo se muestra una vez) en DEPUTY_ACCESS_TOKEN. Instala el conector: deputy_get_me es la comprobación de instalación.

El token solo funciona en la instalación que lo emitió y actúa como el usuario que lo creó, con sus permisos. Un administrador del sistema ve todas las ubicaciones.

Datos personales: los registros de empleados contienen nombres, fechas de nacimiento, datos de contacto, direcciones y datos salariales. Pide solo lo que necesita la tarea.

El vocabulario de Deputy: una ubicación (centro de trabajo) es una Company, un área (departamento) una OperationalUnit, un turno un Roster, el tiempo realmente trabajado un Timesheet y un tipo de ausencia un registro LeaveRules.

Qué lee:

• El usuario del token: deputy_get_me y sus propios turnos, partes de horas, ausencias, indisponibilidades, ubicaciones y compañeros (deputy_get_my_rosters, deputy_get_my_timesheets, deputy_get_my_leave, deputy_get_my_unavailability, deputy_get_my_locations, deputy_get_my_colleagues).
• Estructura y personas: deputy_list_locations, deputy_list_areas (cada área pertenece a una ubicación; turnos y partes de horas usan ids de área), deputy_list_employees, deputy_get_employee, deputy_query_employees para filtrar y deputy_get_employee_shift_status para saber quién está trabajando ahora.
• Turnos: deputy_list_rosters cubre de 12 horas atrás a 36 horas adelante; deputy_query_rosters cualquier periodo, empleado o área (filtros sobre Date, Employee, OperationalUnit).
• Tiempo: deputy_query_timesheets y deputy_get_timesheet (tramos, pausas, líneas de pago, comentarios y estado de aprobación).
• Ausencias y disponibilidad: deputy_query_leave, deputy_get_employee_leave, deputy_get_employee_unavailability y deputy_query_availability. Los tipos de ausencia salen de deputy_query_resource con object LeaveRules.
• Todo lo demás (equipos, festivos, eventos, formación, campos personalizados, datos de ventas, periodos de pago y más): deputy_get_resource_info lista los campos de un objeto, deputy_query_resource lo busca y deputy_get_resource lee un registro.

Qué escribe:

• Turnos: deputy_save_shift añade un turno o, con roster_id, lo actualiza; deputy_copy_rosters copia hacia delante un rango de fechas de algunas áreas (por ejemplo, de la semana pasada a esta); deputy_publish_rosters publica turnos con la notificación elegida (notify 1 SMS y email, 2 SMS, 3 email, 4 ninguna, 5 pedir confirmación a los empleados).
• Tiempo: deputy_start_timesheet, deputy_pause_timesheet (llamarlo de nuevo termina la pausa) y deputy_end_timesheet fichan la entrada y la salida de un empleado; deputy_save_timesheet añade o corrige un parte de horas terminado; deputy_approve_timesheet aprueba el tiempo para que pueda exportarse a nómina.
• Ausencias y disponibilidad: deputy_add_leave (estado 0 espera la aprobación del responsable, 1 registra una ausencia ya aprobada que afecta a partes de horas y saldos), deputy_update_leave (aprobar, rechazar o cancelar con status 1, 2 o 3) y deputy_add_unavailability (puntual o periódica, por ejemplo un lunes de cada dos).
• Empleados: deputy_add_employee, deputy_update_employee, deputy_invite_employee (envía por email una invitación para acceder), deputy_terminate_employee (ya no puede entrar ni recibir turnos; reversible) y deputy_reactivate_employee.
• Notas y noticias: deputy_post_journal añade una nota privada del responsable al perfil de un empleado; deputy_post_memo publica en el feed de noticias de una ubicación, opcionalmente a usuarios concretos y pidiendo confirmación de lectura.

Los turnos publicados, las invitaciones y los memos llegan a empleados reales, así que revisa turnos y notificación antes de pedirlos.

Desactivadas al instalar: deputy_delete_employee, deputy_discard_rosters y deputy_discard_timesheet. No se pueden deshacer; un administrador del workspace las activa cuando el equipo las necesita. Dar de baja a un empleado con deputy_terminate_employee es la alternativa reversible a borrarlo.

Herramientas de consulta: deputy_query_* y deputy_query_resource envían POST pero solo leen. El cuerpo search lleva condiciones que deben cumplirse todas, por ejemplo {"s1":{"field":"Date","type":"ge","data":"2026-11-01"},"s2":{"field":"Date","type":"le","data":"2026-11-07"}}, con los operadores eq, ne, gt, ge, lt, le, in, not in, starts, contains, is e is not. sort ({"Date":"asc"}) y join (["EmployeeObject"]) son opcionales.

Formatos de datos: los ids son enteros. StartTime, EndTime y las entradas start y end son marcas de tiempo Unix en segundos; los campos Date son fechas locales de la ubicación (2026-11-03T00:00:00+11:00), así que las horas se convierten con la zona horaria de la ubicación. Un roster con Employee 0 es un turno abierto, Published false un borrador. El estado del parte de horas está en TimeApproved, PayRuleApproved, Discarded e IsInProgress; TotalTime va en horas. Status de ausencias: 0 pendiente de aprobación, 1 aprobada, 2 rechazada, 3 cancelada, 4 pago aprobado. Añadir o actualizar un turno responde 200 con el cuerpo vacío; la IA comprueba el resultado con deputy_query_rosters.

Paginación: una respuesta tiene como máximo 500 registros. Las herramientas de consulta aceptan max (hasta 500) y start (desplazamiento); cuando una página llega llena, la IA vuelve a llamar con start aumentado en max. Las herramientas de lista sin paginación devuelven en una respuesta todo lo que Deputy permite.

Errores comunes: 401 indica un token erróneo o de otra instalación, 403 un permiso que le falta al usuario del token, 404 una dirección de instalación o un id de registro incorrectos, 400 un nombre de campo erróneo en un filtro (compruébalo con deputy_get_resource_info).

El conector no exporta por sí mismo los partes de horas a un sistema de nómina, no crea ubicaciones ni áreas y no borra nada mientras las herramientas de borrado estén desactivadas.

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 Deputy.
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

• "¿Quién está trabajando ahora en la tienda de Sydney y quién entra después?"
• "Muéstrame los turnos de la semana que viene del área Cocina, incluidos los turnos abiertos."
• "Lista los partes de horas de la semana pasada que aún no están aprobados, con empleado y horas totales."
• "Copia los turnos de la semana pasada del área Bar a esta semana y enséñame los borradores antes de publicarlos."
• "¿Qué solicitudes de ausencia están pendientes de aprobación este mes?"

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