Referencia de herramientas MCP
AB Projects expone herramientas MCP que permiten a los asistentes de IA (como Claude) trabajar con sus proyectos, tareas y documentos. Cuando un asistente cambia algo a través de estas herramientas, sigue la misma ruta que la aplicación: una entrada en el historial de cambios con la nota que usted proporciona, una entrada en el registro de auditoría y una tarjeta adaptable (Adaptive Card) publicada en el canal de Microsoft Teams vinculado — con la actividad de IA divulgada claramente. Las herramientas de solo lectura simplemente devuelven datos y no cambian nada.
Herramientas de proyecto
| Herramienta | Descripción | Parámetros |
|---|---|---|
ab_get_my_projects |
Enumera todos los proyectos de los que es miembro, incluidas estadísticas como el número de tareas y las tasas de finalización. | Ninguno |
ab_get_project_members |
Enumera todos los miembros de un proyecto con sus roles e ID de membresía. Use esto para obtener el ID de membresía necesario para asignar una tarea. | project_id obligatorio |
ab_get_project_options |
Obtiene los ID válidos de estado, tipo y entorno de un proyecto. Llame a esto primero antes de pasar un estado, tipo o entorno a ab_create_task o ab_update_task. |
project_id obligatorio |
Herramientas de tareas
| Herramienta | Descripción | Parámetros |
|---|---|---|
ab_get_my_tasks |
Obtiene sus tareas activas — vencidas, que vencen hoy y en curso. Devuelve el ID de la tarea, el título, la prioridad, el estado, la fecha de vencimiento y el progreso. | project_id opcional — filtrar a un proyecto específico |
ab_search_tasks |
Busca tareas por palabra clave en todos sus proyectos. | query obligatorio — palabra clave de búsqueda project_id opcional — acotar a un proyecto específico |
ab_get_task |
Obtiene todos los detalles de una tarea — descripción, fechas, responsable, horas estimadas/reales, información de subtareas, ID de la tarea principal, rama de GitHub y los 50 comentarios más recientes en línea. El estado, el tipo y el entorno se devuelven como nombres legibles. | project_id obligatorio task_id obligatorio |
ab_create_task |
Crea una nueva tarea. Se registra una entrada en el historial de cambios y se publica una notificación en el canal de Teams vinculado. | project_id obligatorio title obligatorio description opcional — admite Markdown priority opcional — 1 = Alta, 2 = Media, 3 = Baja (predeterminado: 2) assignee_id opcional — ID de membresía del responsable due_date opcional — yyyy-MM-dd status / type / environment opcional — ID de ab_get_project_optionsparent_task_id opcional — clave de fila de la tarea principal; cuando se establece, esta se convierte en una subtarea y la marca "tiene subtareas" de la tarea principal se actualiza automáticamente note opcional — motivo, mostrado en el historial de cambios y en el canal de Teams |
ab_update_task |
Actualiza las propiedades de una tarea — título, descripción, estado, progreso, prioridad, responsable, tipo, entorno o tarea principal. Cada cambio se registra en el historial con la nota proporcionada. | project_id obligatorio task_id obligatorio title / description opcional (Markdown) status opcional — nuevo ID de estado progress opcional — 0 a 100 priority opcional — 1/2/3 assignee_id / type / environment opcional parent_task_id opcional — mover bajo una tarea principal diferente; cadena vacía para desvincular note opcional — motivo, mostrado en el historial de cambios y en el canal de Teams |
ab_complete_task |
Marca una tarea como completada. Establece el progreso al 100 % y registra una entrada de finalización en el historial de cambios. | project_id obligatorio task_id obligatorio note opcional — nota de finalización, mostrada en el historial de cambios y en el canal de Teams |
ab_add_comment |
Agrega un comentario a una tarea. El comentario aparece en el hilo de la tarea y ab_get_task lo incluye en línea, de modo que una llamada de seguimiento puede leerlo sin una segunda llamada a la herramienta. |
project_id obligatorio task_id obligatorio content obligatorio — texto del comentario |
Herramientas de agenda
| Herramienta | Descripción | Parámetros |
|---|---|---|
ab_get_schedule |
Obtiene su agenda de la semana actual — agrupada en vencidas, que vencen hoy y que vencen esta semana. | project_id opcional — filtrar a un proyecto específico |
Herramientas de Documentos (Wiki)
| Herramienta | Descripción | Parámetros |
|---|---|---|
ab_get_wiki_tree |
Obtiene el árbol de navegación de Documentos (carpetas y páginas) de un proyecto. | project_id obligatorio |
ab_get_wiki_article |
Lee el contenido completo, los metadatos y la información de versión de un documento. | project_id obligatorio article_id obligatorio — de ab_get_wiki_tree o ab_search_wiki |
ab_search_wiki |
Enumera los documentos bajo una ruta de carpeta específica. | project_id obligatorio parent_path opcional — carpeta desde la que enumerar (predeterminado: / para la raíz) |
ab_create_wiki_article |
Crea un nuevo documento en Markdown. Publica una notificación en el canal de Teams vinculado. | project_id obligatorio title obligatorio content obligatorio — Markdown parent_path opcional — carpeta, p. ej. / o /Engineering (predeterminado: /)tags opcional — separados por comas |
ab_update_wiki_article |
Actualiza un documento existente. Crea una nueva versión con una nota de edición y publica una notificación en el canal de Teams. | project_id obligatorio article_id obligatorio content obligatorio — Markdown actualizado edit_note obligatorio — qué cambió; mostrado en el historial de versiones tags opcional — etiquetas actualizadas separadas por comas |
ab_add_wiki_comment |
Agrega un comentario a un documento. | project_id obligatorio article_id obligatorio content obligatorio — texto del comentario |
Cómo se mantienen visibles los cambios de IA
Cuando se crea, actualiza o completa una tarea o un documento a través de una herramienta MCP, AB Projects automáticamente:
- Registra el cambio en el historial de cambios del elemento con el nombre del usuario y la nota proporcionada
- Escribe una entrada en el registro de operaciones con fines de auditoría
- Publica o actualiza una tarjeta adaptable (Adaptive Card) en el canal de Microsoft Teams vinculado del proyecto, con la actividad divulgada claramente como generada por IA
Así, los cambios impulsados por IA tienen la misma visibilidad y trazabilidad que los cambios realizados directamente en la aplicación de AB Projects o en la pestaña de Teams. Para saber cómo conectar un asistente, consulte Conectar asistentes de IA mediante MCP.