Resumen
Gestión de proyectos YouGile: proyectos, tableros kanban, columnas, tareas con plazos, listas de verificación y asignados, mensajes de chat de tareas, empleados, departamentos, adhesivos personalizados y de sprint y suscripciones a webhooks. Clave API.
Configuración guiada
Conecta YouGile a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta YouGile con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para YouGile
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → YouGile, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
YouGile + Cursor
Gestión de proyectos YouGile: proyectos, tableros kanban, columnas, tareas con plazos, listas de verificación y asignados, mensajes de chat de tareas, empleados, departamentos, adhesivos personalizados y de sprint y suscripciones a webhooks. Clave API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
YOUGILE_API_KEY
Paso 1 — Obtener credenciales
La configuración tarda unos 5 minutos.
YouGile no tiene una página que muestre una clave API: se crea una clave con una llamada API que toma tu inicio de sesión y contraseña de YouGile. Ejecútala una vez desde un terminal; el conector nunca ve tu contraseña.
- Encuentra tu id de empresa: en la aplicación web de YouGile presiona Ctrl+Alt+Q (Ctrl+Option+Q en un Mac), o ejecuta
curl -X POST https://yougile.com/api-v2/auth/companies -H "Content-Type: application/json" -d '{"login":"<tu correo electrónico>","password":"<tu contraseña>"}'y tomacontent[].idde tu empresa. - Crea la clave:
curl -X POST https://yougile.com/api-v2/auth/keys -H "Content-Type: application/json" -d '{"login":"<tu correo electrónico>","password":"<tu contraseña>","companyId":"<id de la empresa>"}'. La respuesta es{"key":"..."}. - Pega la clave en
YOUGILE_API_KEY.
Una clave no expira. Una cuenta puede tener como máximo 30 claves; listarlas con POST /auth/keys/get (mismo cuerpo de inicio de sesión) y eliminar una con DELETE /auth/keys/<clave>. La clave actúa como el empleado que la creó y ve solo lo que ese empleado ve, así que créala con una cuenta que pueda abrir los proyectos en los que deseas trabajar.
Por dónde empezar: yougile_get_current_user verifica la clave. Luego sigue: yougile_list_projects, yougile_list_boards con el id del proyecto, yougile_list_columns con el id del tablero, yougile_list_tasks con el id de la columna.
Estructura: yougile_get_project, yougile_get_board, yougile_get_column; crea con yougile_create_project, yougile_create_board, yougile_create_column; cambia con yougile_update_project, yougile_update_board, yougile_update_column. Una tarea pertenece a una columna, una columna a un tablero, un tablero a un proyecto.
Tareas: yougile_list_tasks (filtrar por columna, asignado, título o estado del adhesivo), yougile_get_task, yougile_create_task, yougile_update_task, y yougile_move_task para cambiar la columna. yougile_delete_task se instala desactivado; establece archived con yougile_update_task para trabajos finalizados.
Chat: cada tarea tiene un chat cuyo id es el id de la tarea. Léelo con yougile_list_task_messages y escribe con yougile_send_task_message. yougile_list_group_chats lista los chats de la empresa, que utilizan las mismas dos herramientas.
Personas: yougile_list_users, yougile_get_user, yougile_list_departments, yougile_get_department.
Adhesivos: los campos personalizados de una tarea son adhesivos. yougile_list_string_stickers y yougile_get_string_sticker devuelven adhesivos con un conjunto fijo de estados (prioridad, tipo); yougile_list_sprint_stickers y yougile_get_sprint_sticker devuelven sprints. Créelos con yougile_create_string_sticker y yougile_create_sprint_sticker, actívalos para un tablero con yougile_update_board, luego configúralos en una tarea como id de adhesivo a id de estado.
Webhooks: yougile_list_webhooks muestra las suscripciones y sus contadores de fallos.
Listas y paginación: las herramientas de lista responden con paging (conteo, límite, desplazamiento, siguiente) y content. Tamaño de página predeterminado 50, como máximo 1000; mientras paging.next sea verdadero, llama de nuevo con offset aumentado por limit. Los objetos eliminados se omiten a menos que include_deleted sea verdadero.
Tiempos: los tiempos de tareas y mensajes son milisegundos desde 1970 (timestamp, deadline.deadline, mensaje id); el begin y end del sprint son segundos. Los ids son UUIDs; los ids de estado de adhesivos son cadenas hexadecimales cortas.
Límite de tasa: 50 solicitudes por minuto para toda la empresa, compartidas por todas sus claves. Páginas con un gran limit en lugar de muchas llamadas pequeñas.
Errores: una llamada fallida tiene un estado de 4xx o 5xx y un campo error o message. 401 significa que la clave es incorrecta o fue eliminada; 403 o 404 en un objeto que existe significa que el propietario de la clave no tiene acceso a él.
Paso 2 — Instalar el adaptador
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 — Agregar 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 muestraYOUR_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" }
}
}
}
- 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. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
YouGile.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
yougile_get_current_user | Lee el empleado al que pertenece la clave API: id, correo electrónico, nombre real, esAdmin, estado (en línea o fuera de línea) y lastActivity. Úsalo para verificar el… |
yougile_list_users | Lista los empleados de la empresa: id, correo electrónico, nombre real, esAdmin, messengerOnly, estado y lastActivity. Filtra por correo electrónico o por proyecto. El… |
yougile_get_user | Lee un empleado por id: correo electrónico, nombre real, esAdmin, messengerOnly, estado, lastActivity y customStatus. Solo lectura |
yougile_list_departments | Lista los departamentos de la empresa: id, título, parentId (el departamento superior, ausente en el nivel superior) y usuarios (id de empleado mapeado a… |
yougile_get_department | Lee un departamento por id: título, parentId y usuarios (id de empleado mapeado a gerente o miembro). Solo lectura |
yougile_list_projects | Lista los proyectos que el propietario de la clave puede ver: id, título, timestamp (hora de creación, milisegundos) y usuarios (id de empleado mapeado al rol… |
yougile_get_project | Lee un proyecto por id: título, timestamp, usuarios con sus roles y departamentos con su mapeo de roles. Solo lectura |
yougile_create_project | Crea un proyecto y devuelve su id. Proporciona los empleados que trabajan en él con sus roles; un empleado que no esté listado no puede ver el… |
yougile_update_project | Cambia el nombre de un proyecto o cambia quién trabaja en él. Solo los campos que pases cambian; en users y departments un valor de - elimina eso… |
yougile_list_boards | Lista tableros: id, título, projectId y adhesivos (qué adhesivos de tarea muestra el tablero: fecha límite, asignado, seguimiento de tiempo, temporizador, cronómetro… |
yougile_get_board | Lee un tablero por id: título, projectId y los adhesivos activados para sus tareas. Solo lectura |
yougile_create_board | Crea un tablero en un proyecto y devuelve su id. Un nuevo tablero no tiene columnas: añádelas con yougile_create_column. Escribe en YouGile |
yougile_update_board | Cambia el nombre de un tablero, muévelo a otro proyecto o cambia qué adhesivos muestran sus tareas. Solo los campos que pases cambian. Devuelve el id del tablero.… |
yougile_list_columns | Lista las columnas de un tablero: id, título, color (1 a 16) y boardId. Las tareas viven en columnas, así que este es el paso entre un tablero y sus… |
yougile_get_column | Lee una columna por id: título, color y el tablero al que pertenece. Solo lectura |
yougile_create_column | Crea una columna en un tablero y devuelve su id. Las nuevas columnas se añaden después de las existentes. Escribe en YouGile |
yougile_update_column | Cambia el nombre de una columna, cambia su color o muévela a otro tablero. Solo los campos que pases cambian. Devuelve el id de la columna. Escribe en YouGile |
yougile_list_tasks | Lista tareas: id, título, columnId, descripción, completada, archivada, asignada (ids de empleados), fecha límite (milisegundos), seguimiento de tiempo… |
yougile_get_task | Lee una tarea por id con todos sus campos: título, descripción (HTML), columnId, completada y completedTimestamp, archivada, asignada… |
yougile_create_task | Crea una tarea en una columna y devuelve su id. Sin una columna, la tarea se crea fuera de cualquier tablero y solo es accesible por id, así que siempre… |
yougile_update_task | Cambia una tarea: título, descripción, asignados, fecha límite, seguimiento de tiempo, listas de verificación, adhesivos, subtareas, color, hecha o archivada. Solo los… |
yougile_move_task | Mueve una tarea a otra columna, en el mismo tablero o en otro. Así es como una tarea cambia su etapa (Por hacer, En progreso, Hecho).… |
yougile_delete_task | Marca una tarea como eliminada. Desaparece de su tablero para todos; aún se puede leer con include_deleted. Instalado desactivado… |
yougile_list_task_messages | Lee el chat de una tarea o de un chat grupal: por id de mensaje (también su hora de creación en milisegundos), fromUserId, texto, textHtml, etiqueta… |
yougile_send_task_message | Escribe un mensaje en el chat de una tarea (o un chat grupal) como el propietario de la clave. Todos los suscritos al chat son notificados. Devuelve el… |
yougile_list_group_chats | Lista los chats grupales de la empresa: id, título, usuarios (id de empleado mapeado a configuración de notificación) y userRoleMap. El id es el id del chat… |
yougile_list_string_stickers | Lista los adhesivos personalizados con un conjunto de estados (prioridad, tipo, estado y similares): id, nombre, icono y estados con id, nombre y color. Un… |
yougile_get_string_sticker | Lee un adhesivo de estado por id: nombre, icono y sus estados (id, nombre, color). Solo lectura |
yougile_create_string_sticker | Crea un adhesivo personalizado con un conjunto de estados, por ejemplo, Prioridad con Alto y Bajo, y devuelve su id. Actívalo para un tablero con… |
yougile_list_sprint_stickers | Lista los adhesivos de sprint: id, nombre y estados, donde cada estado es un sprint con id, nombre, inicio y fin (segundos desde 1970; un estado… |
yougile_get_sprint_sticker | Lee un adhesivo de sprint por id: nombre y sus sprints (id, nombre, inicio y fin en segundos desde 1970). Solo lectura |
yougile_create_sprint_sticker | Crea un adhesivo de sprint con sus sprints y devuelve su id. Actívalo para un tablero con yougile_update_board antes de que se puedan poner tareas en… |
yougile_list_webhooks | Lista las suscripciones a webhooks de la empresa: id, url, evento (como tarea-creada, o un patrón como task-*), deshabilitado, lastSuccess y… |
Ejemplos de mensajes
- "¿Qué tareas en el tablero Marketing están atrasadas, y quién las tiene?"
- "Crea una tarea Preparar el informe Q1 en la columna En progreso, fecha límite el próximo viernes, asignada a Anna."
- "Mueve la tarea Copia de la página de aterrizaje a la columna Hecho."
- "¿Qué se discutió en el chat de la tarea Relanzamiento del sitio web esta semana?"
- "Muestra las tareas del sprint actual por asignado."
Preguntas frecuentes
¿Cómo obtengo una clave API de YouGile? YouGile no tiene una página que muestre una clave: creas una una vez con una llamada API que toma tu inicio de sesión de YouGile, contraseña e id de empresa, y pegas la respuesta en YOUGILE_API_KEY. El conector nunca ve tu contraseña. Una clave no expira y actúa como el empleado que la creó, así que créala con una cuenta que pueda abrir los proyectos que necesitas.
¿Qué cubre? Proyectos, tableros y columnas, tareas con plazos, listas de verificación, asignados y adhesivos, mover tareas entre columnas, mensajes de chat de tareas y grupos, empleados y departamentos, adhesivos personalizados y de sprint, y las suscripciones a webhooks. Toda la empresa comparte 50 solicitudes por minuto entre todas sus claves.
¿Qué herramientas se instalan desactivadas? yougile_delete_task. Actívala en la página del conector solo si la IA debería usarla; para trabajos finalizados, la IA archiva la tarea en su lugar.
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Próximos pasos
¿Te ha sido útil esta guía?