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

Related MCP server: MCP Server with Authentication

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

1. 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

1. 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

1. Configure las variables de entorno copiando .env.example a .env y modificándolo según sus necesidades.

2. 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 .