Servidor MCP de TeamRetro

Servidor de Protocolo de Contexto de Modelo (MCP) para la integración de TeamRetro.

Notas importantes

Servidor MCP no oficial

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

Integración API oficial

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

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

Fuente de la documentación de la API

Todos los puntos finales y la funcionalidad de la API se basan en la documentación oficial de TeamRetro:

Artículo de ayuda de la API: https://help.teamretro.com/article/320-teamretro-api
Especificaciones de API: https://groupmap.stoplight.io/docs/teamretro/
La implementación sigue estrictamente las especificaciones de la API pública.
Cualquier cambio en la API de TeamRetro puede afectar la funcionalidad de este servidor MCP

Cómo utilizar

NPX (Recomendado, Fácil configuración)

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

Del código fuente

Clonar el repositorio, instalar las dependencias y compilar el proyecto:

git clone https://github.com/adepanges/teamretro-mcp-server.git
cd teamretro-mcp-server
npm install
npm run build

Ejecución en el cliente de IA

Configure el cliente de IA con las siguientes configuraciones:

{
  "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"
      }
    }
  }
}

Corriendo con Inspector

Configure las variables de entorno copiando .env.example a .env y modificándolo según sus necesidades.
Ejecute el servidor con el inspector:

npm run inspector

Ejemplos de variables de entorno

URL base

La URL base de la API de TeamRetro se puede configurar mediante la variable de entorno TEAMRETRO_BASE_URL . Por defecto, es https://api.teamretro.com .

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

Autenticación de clave API

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

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

Usuarios

list_users : enumera los usuarios con paginación utilizando parámetros de desplazamiento y límite para controlar la cantidad de resultados devueltos
add_user : agrega un nuevo usuario o actualiza la información de un usuario existente mediante su dirección de correo electrónico, especificando un nombre y una dirección de correo electrónico opcionales
update_user : Actualiza los detalles de un usuario existente, como su nombre y dirección de correo electrónico, proporcionando su correo electrónico actual
delete_user : Eliminar 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 de equipos de TeamRetro con filtrado por etiquetas e ID, y paginación mediante parámetros de desplazamiento 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 la identificación del equipo
create_team : Crea un nuevo equipo con un nombre obligatorio y etiquetas y miembros opcionales
delete_team : Eliminar un equipo existente por su ID

Miembros del equipo

list_team_members : recupera una lista de miembros del equipo para un ID de equipo específico con controles de paginación para desplazamiento y límite
get_team_member : busca un miembro del equipo por su dirección de correo electrónico dentro de un equipo específico
update_team_member : Actualizar 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 específico
remove_team_member : eliminar a un miembro de un equipo por su dirección de correo electrónico
add_team_member : agrega un nuevo miembro al equipo mediante su dirección de correo electrónico, con especificación opcional del estado de administrador del equipo

Comportamiento

list_actions : recupera una lista de acciones de TeamRetro con filtrado opcional por etiquetas de equipo e ID de equipo, y controles de paginación para desplazamiento y límite
create_action : crea una nueva acción en TeamRetro con los detalles requeridos, como ID del 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 : Actualizar 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 de acuerdos de TeamRetro con filtrado opcional por etiquetas de equipo e ID 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 único 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

Controles de salud

list_health_checks : Lista de comprobaciones de estado de TeamRetro con filtrado opcional por ID de modelo de estado, etiquetas de equipo e ID de equipo, así como controles de paginación
get_health_check : recupera un único control de salud por su identificador único con atributos opcionales para incluir
delete_health_check : elimina un control de salud existente especificando su identificador único

Modelos de salud

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

Retrospectivas

list_retrospectives : enumera las retrospectivas de TeamRetro con filtrado por etiquetas e identificaciones de equipo, y paginación mediante parámetros de desplazamiento y límite
get_retrospective : recupera información detallada sobre una sola retrospectiva mediante su ID único
delete_retrospective : elimina una retrospectiva existente por su ID

Registro de cambios

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

TeamRetro MCP Server