Cómo conectar Connecteam a Cursor vía MCP

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

Connecteam + Cursor

Connecteam, la app para equipos que no trabajan en una oficina: usuarios y campos personalizados, el reloj de fichaje con turnos fichados, totales de partes de horas y fichaje de entrada y salida, turnos del scheduler, trabajos, formularios y envíos, quick tasks, saldos y solicitudes de ausencia y mensajes de chat. Connecteam API con una API key.

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:

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos y necesita un propietario o administrador de Connecteam.

1. En Connecteam abre Settings > API Keys y haz clic en Add API key. Copia la clave en CONNECTEAM_API_KEY. Da acceso a toda la cuenta, así que trátala como una contraseña.
2. Pon CONNECTEAM_API_HOST en https://api.connecteam.com, o en https://api-au.connecteam.com si inicias sesión en app-au.connecteam.com (cuentas australianas).
3. Instala el conector: connecteam_get_account es la comprobación de instalación.

El acceso a la API requiere el plan Expert o superior, por hub: Operations para el reloj de fichaje, el scheduler, los trabajos y las tareas; Communications para el chat; HR & Skills para las ausencias. Usuarios, cuenta y publishers funcionan con cualquier hub que cumpla el requisito.

Datos personales: los usuarios llevan nombres, teléfonos, emails y campos de perfil personalizados como cumpleaños, dirección o números de documento; las actividades de tiempo pueden llevar posiciones GPS. Pide solo lo que necesita la tarea.

Primero los ids: cada reloj de fichaje, scheduler y task board es una instancia de app propia. La IA obtiene sus ids con connecteam_list_time_clocks, connecteam_list_schedulers y connecteam_list_task_boards antes de llamar a las herramientas que piden timeClockId, schedulerId o taskBoardId.

Qué lee:

• Cuenta y personas: connecteam_get_account, connecteam_list_users (filtros por ids, nombres, emails, teléfonos, estado o fecha de cambio), connecteam_list_custom_fields, connecteam_list_custom_field_categories y connecteam_list_smart_groups.
• Reloj de fichaje: connecteam_list_time_activities devuelve turnos fichados, pausas manuales y ausencias por usuario, como máximo 92 días por llamada; connecteam_get_timesheet_totals devuelve las horas por usuario y día con pausas, horas extra, pago y estado de aprobación, envío y bloqueo.
• Planificación: connecteam_list_shifts (rango de tiempo en segundos Unix), connecteam_get_shift, connecteam_list_shift_custom_fields y connecteam_list_user_unavailabilities.
• Trabajos (los clientes, obras o proyectos a los que se imputan turnos y horas fichadas): connecteam_list_jobs, connecteam_get_job y connecteam_list_job_custom_fields.
• Formularios: connecteam_list_forms, connecteam_get_form (las preguntas), connecteam_list_form_submissions y connecteam_get_form_submission con cada respuesta, incluidas imágenes y enlaces a archivos.
• Tareas: connecteam_list_tasks y connecteam_list_task_labels.
• Ausencias: connecteam_list_time_off_policy_types, connecteam_list_time_off_balances y connecteam_list_time_off_requests, que solo devuelve solicitudes aprobadas si no pasas statuses.
• Chat: connecteam_list_conversations y connecteam_list_publishers.

Qué escribe:

• Reloj de fichaje: connecteam_clock_in y connecteam_clock_out fichan la entrada o la salida de un usuario ahora o en un instante dado, opcionalmente en un trabajo o un turno planificado. connecteam_create_time_activities añade turnos o pausas manuales pasados (por ejemplo, un fichaje olvidado) y connecteam_update_time_activities los corrige. Los días bloqueados o aprobados se rechazan.
• Planificación: connecteam_create_shifts y connecteam_update_shifts; con isPublished true y notifyUsers true el personal ve el turno y recibe un aviso.
• Trabajos: connecteam_create_jobs (también subtrabajos con parentId) y connecteam_update_job (title es obligatorio).
• Tareas: connecteam_create_task y connecteam_update_task. La API sustituye la tarea entera, así que la IA envía cada vez userIds, status y title; el estado completed la cierra.
• Ausencias: connecteam_create_time_off_request (pendiente o ya aprobada) y connecteam_update_time_off_request (aprobar o denegar con status).
• Usuarios: connecteam_create_users (cada uno necesita firstName, lastName, phoneNumber y userType; sendActivation envía el SMS de activación), connecteam_update_users, connecteam_archive_users (reversible: actualizar con isArchived false) y connecteam_create_user_note.
• Chat: connecteam_send_message publica en una conversación y connecteam_send_private_message escribe a un usuario, ambos con un id de publisher de connecteam_list_publishers como senderId. Los mensajes se entregan al momento.

Desactivadas al instalar: connecteam_delete_user, connecteam_delete_shift y connecteam_delete_task. No se pueden deshacer; un administrador del workspace las activa cuando el equipo las necesita. Archivar un usuario es la alternativa reversible.

Formatos de datos: las respuestas tienen la forma { "requestId": "...", "data": {...}, "paging": { "offset": n } }. Las horas de turnos, fichajes y tareas son marcas de tiempo Unix en segundos con un timezone IANA aparte; las fechas de los filtros son YYYY-MM-DD. Los ids de usuario son enteros; los de turnos, trabajos, tareas y solicitudes son cadenas. Las escrituras por lotes (connecteam_create_users, connecteam_create_shifts, connecteam_create_jobs y las actualizaciones) aceptan una lista y responden por elemento.

Paginación: limit (10 por defecto; el máximo depende de la herramienta, hasta 500) y offset. La IA aumenta offset en limit hasta que una página devuelve menos elementos que limit.

Límites y errores comunes: los límites de peticiones son por cuenta y plan (Expert: 100 por minuto y 10.000 al día) y responden 429. 401 o 403 indica una clave errónea, la dirección de API equivocada (global o australiana) o un plan o hub sin acceso a la API; 404 un id desconocido; 422 un error de validación, con el campo indicado en el cuerpo.

El conector no procesa nóminas, no edita formularios ni envía respuestas a formularios y no crea relojes de fichaje, schedulers ni task boards.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Connecteam.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas horas trabajó cada empleado la semana pasada en el reloj de fichaje Almacén, incluidas las horas extra?"
• "Muéstrame los turnos abiertos de mañana en el scheduler Equipo de campo."
• "¿Qué solicitudes de ausencia siguen pendientes y cuánto saldo le queda a cada persona?"
• "Lista los envíos de esta semana del formulario de inspección de vehículos con sus respuestas."
• "Crea en la board Tienda una tarea para Daniel de reponer la cámara frigorífica antes del viernes y publícala."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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