TeamRetro

Integra con TeamRetro para la gestión y análisis de equipos.

GitHub

Documentación

TeamRetro Servidor MCP

Smithery Badge

MseeP.ai Security Assessment Badge

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración impulsada por IA con la plataforma de TeamRetro. Este servidor actúa como un puente entre los clientes de IA y la API oficial de TeamRetro, permitiendo una interacción fluida con la gestión de equipos, retrospectivas, comprobaciones de salud y otras características de TeamRetro a través de herramientas MCP estandarizadas.

Características principales:

  • Cobertura completa de la API de TeamRetro con más de 20 herramientas para gestionar equipos, usuarios, acciones y más
  • Integración simplificada de clientes de IA a través de interfaces MCP estandarizadas
  • Soporte integrado de paginación y filtrado para un manejo eficiente de datos
  • Manejo seguro de autenticación de API y configuración de entorno
  • Documentación completa y opciones de configuración fáciles

Ya sea que estés construyendo análisis de equipos impulsados por IA, gestión automatizada de retrospectivas o integrando TeamRetro en tu flujo de trabajo de IA, este servidor MCP proporciona la base que necesitas.

Notas Importantes

Servidor MCP No Oficial

Este servidor MCP es una interfaz no oficial desarrollada por la comunidad para los servicios de TeamRetro. Aunque no está desarrollado ni respaldado por TeamRetro, proporciona acceso estandarizado a su plataforma.

Integración con la API Oficial

El servidor se conecta directamente a la API pública oficial de TeamRetro:

  • Utiliza endpoints documentados de las especificaciones de la API de TeamRetro
  • Mantiene el cumplimiento total de la API y el seguimiento de versiones
  • Implementa todos los métodos de autenticación requeridos
  • Conserva las respuestas originales de la API sin modificaciones

Fuente de Documentación de la API

Todos los endpoints y funcionalidades de la API se basan en la documentación oficial de TeamRetro:

Cómo Usar

NPX (Recomendado, Configuración Fácil)

{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "npx",
      "args": ["-y", "teamretro-mcp-server"],
      "env": {
        "TEAMRETRO_AUTH_TYPE": "apiKey",
        "TEAMRETRO_API_KEY": "your-api-key"
      }
    }
  }
}

Instalación mediante Smithery

Para instalar TeamRetro MCP Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @adepanges/teamretro-mcp-server --client claude

Desde el Código Fuente

  1. Clona el repositorio, instala las dependencias y compila el proyecto:
git clone https://github.com/adepanges/teamretro-mcp-server.git
cd teamretro-mcp-server
pnpm install
pnpm run build

Ejecución en Cliente de IA

  1. Configura el cliente de IA con los siguientes ajustes:
{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "node",
      "args": ["/path/to/teamretro-mcp-server/dist/index.js"],
      "env": {
        "TEAMRETRO_AUTH_TYPE": "apiKey",
        "TEAMRETRO_API_KEY": "your-api-key"
      }
    }
  }
}

Ejecución con Inspector

  1. Configura las variables de entorno copiando .env.example a .env y modificándolo según tus necesidades.
  2. Ejecuta el servidor con inspector:
pnpm run inspector

Ejemplos de Variables de Entorno

URL Base

La URL base para la API de TeamRetro se puede configurar usando la variable de entorno TEAMRETRO_BASE_URL. Por defecto, está establecida en https://api.teamretro.com.

{
  "env": {
    "TEAMRETRO_BASE_URL": "https://api.teamretro.com"
  }
}

Autenticación con Clave de API

{
  "env": {
    "TEAMRETRO_AUTH_TYPE": "apiKey",
    "TEAMRETRO_API_KEY": "your-api-key"
  }
}

Herramientas Disponibles

El servidor proporciona las siguientes herramientas:

Usuarios

  • list_users: Lista usuarios con paginación usando parámetros de offset y límite para controlar el número de resultados devueltos
  • add_user: Agrega un nuevo usuario o actualiza la información de un usuario existente por su dirección de correo electrónico, especificando nombre y emailAddress opcionales
  • update_user: Actualiza los detalles de un usuario existente, como su nombre y emailAddress, proporcionando su correo electrónico actual
  • delete_user: Elimina un usuario por su dirección de correo electrónico
  • get_user: Recupera información detallada sobre un solo usuario por su dirección de correo electrónico

Equipos

  • list_teams: Lista equipos de TeamRetro con filtrado por etiquetas e IDs, y paginación usando parámetros de offset y límite
  • detail_team: Recupera información detallada sobre un solo equipo por su ID único
  • update_team: Actualiza los detalles de un equipo existente, como su nombre y etiquetas asociadas, proporcionando el ID del equipo
  • create_team: Crea un nuevo equipo con un nombre requerido, y etiquetas y miembros opcionales
  • delete_team: Elimina un equipo existente por su ID

Miembros del Equipo

  • list_team_members: Recupera una lista de miembros del equipo para un ID de equipo especificado con controles de paginación para offset y límite
  • get_team_member: Obtiene un miembro del equipo por su dirección de correo electrónico dentro de un equipo especificado
  • update_team_member: Actualiza los detalles de un miembro del equipo, como su nombre o estado de administrador del equipo, por su dirección de correo electrónico dentro de un equipo especificado
  • remove_team_member: Elimina un miembro del equipo de un equipo por su dirección de correo electrónico
  • add_team_member: Agrega un nuevo miembro del equipo a un equipo por su dirección de correo electrónico, con especificación opcional del estado de administrador del equipo

Acciones

  • list_actions: Recupera una lista de acciones de TeamRetro con filtrado opcional por etiquetas de equipo e IDs de equipo, y controles de paginación para offset y límite
  • create_action: Crea una nueva acción en TeamRetro con detalles requeridos como ID de equipo, título, fecha de vencimiento, estado de finalización y usuario asignado
  • get_action: Obtiene una sola acción por su ID único de TeamRetro
  • update_action: Actualiza una acción existente en TeamRetro con nuevos detalles como título, fecha de vencimiento, estado de finalización, prioridad y usuario asignado
  • delete_action: Elimina una acción existente de TeamRetro por su ID de acción

Acuerdos

  • list_agreements: Lista acuerdos de TeamRetro con filtrado opcional por etiquetas de equipo e IDs de equipo, así como controles de paginación
  • create_agreement: Crea un nuevo acuerdo en TeamRetro especificando el equipo al que pertenece y su título
  • get_agreement: Recupera un solo acuerdo por su identificador único
  • update_agreement: Actualiza los detalles de un acuerdo existente, como su título o equipo asociado
  • delete_agreement: Elimina un acuerdo existente especificando su identificador único

Comprobaciones de Salud

  • list_health_checks: Lista comprobaciones de salud de TeamRetro con filtrado opcional por IDs de modelo de salud, etiquetas de equipo e IDs de equipo, así como controles de paginación
  • get_health_check: Recupera una sola comprobación de salud por su identificador único con atributos opcionales a incluir
  • delete_health_check: Elimina una comprobación de salud existente especificando su identificador único

Modelos de Salud

  • list_health_models: Lista modelos de salud de TeamRetro con controles de paginación
  • get_health_model: Recupera un solo modelo de salud por su identificador único

Retrospectivas

  • list_retrospectives: Lista retrospectivas de TeamRetro con filtrado por etiquetas de equipo e IDs, y paginación usando parámetros de offset y límite
  • get_retrospective: Recupera información detallada sobre una sola retrospectiva por su ID único
  • delete_retrospective: Elimina una retrospectiva existente por su ID

Informes

  • team_activity_report: Genera un informe de actividad del equipo de TeamRetro con filtrado por etiquetas de equipo e IDs de equipo
  • team_actions_activity_report: Genera un informe de actividad de acciones del equipo de TeamRetro con filtrado por etiquetas de equipo e IDs de equipo. Devuelve datos CSV con estadísticas de acciones que incluyen recuentos de acciones abiertas, completadas y vencidas agrupadas por rangos de antigüedad
  • retrospective_activity_report: Genera un informe de actividad de retrospectivas de TeamRetro con filtrado por rango de fechas, etiquetas de equipo e IDs de equipo. Devuelve datos CSV con estadísticas de retrospectivas que incluyen tasa de participación, número de ideas, número de comentarios, número de acciones y número de acuerdos
  • health_check_activity_report: Genera un informe de actividad de comprobaciones de salud de TeamRetro con filtrado por rango de fechas, etiquetas de equipo e IDs de equipo. Devuelve datos CSV con estadísticas de comprobaciones de salud que incluyen tasa de participación, número de comentarios, número de acciones y número de acuerdos
  • team_health_latest_report: Genera un informe de salud del equipo (más reciente) de TeamRetro para un modelo de salud específico con filtrado por rango de fechas, etiquetas de equipo e IDs de equipo. Devuelve datos CSV con las puntuaciones de salud más recientes del equipo, incluyendo dimensiones de salud
  • team_health_historical_report: Genera un informe de salud del equipo (histórico) de TeamRetro para un modelo de salud específico con filtrado por rango de fechas, etiquetas de equipo e IDs de equipo. Devuelve datos CSV con puntuaciones históricas de salud del equipo, incluyendo dimensiones de salud
  • users_report: Genera un informe de usuarios de TeamRetro con filtrado por etiquetas de equipo e IDs de equipo. Devuelve datos CSV con información de usuarios que incluye roles de cuenta, membresías de equipo y estadísticas de actividad

Registro de Cambios

Para obtener una lista detallada de cambios y actualizaciones, consulta CHANGELOG.md.