TeamRetro

Integre com o TeamRetro para gerenciamento de equipe e análises.

Documentação

TeamRetro Servidor MCP

Um servidor Model Context Protocol (MCP) que fornece integração com tecnologia de IA com a plataforma do TeamRetro. Este servidor atua como uma ponte entre clientes de IA e a API oficial do TeamRetro, permitindo interação perfeita com gerenciamento de equipes, retrospectivas, health checks e outros recursos do TeamRetro por meio de ferramentas MCP padronizadas.

Principais recursos:

Cobertura completa da API do TeamRetro com mais de 20 ferramentas para gerenciar equipes, usuários, ações e muito mais
Integração simplificada de clientes de IA por meio de interfaces MCP padronizadas
Suporte integrado a paginação e filtragem para manipulação eficiente de dados
Manipulação segura de autenticação de API e configuração de ambiente
Documentação abrangente e opções fáceis de configuração

Esteja você construindo análises de equipe com IA, gerenciamento automatizado de retrospectivas ou integrando o TeamRetro ao seu fluxo de trabalho de IA, este servidor MCP fornece a base que você precisa.

Notas Importantes

Servidor MCP Não Oficial

Este servidor MCP é uma interface não oficial desenvolvida pela comunidade para os serviços do TeamRetro. Embora não seja desenvolvido ou endossado pelo TeamRetro, ele fornece acesso padronizado à plataforma.

Integração com a API Oficial

O servidor se conecta diretamente à API pública oficial do TeamRetro:

Usa endpoints documentados das especificações da API do TeamRetro
Mantém conformidade total com a API e rastreamento de versões
Implementa todos os métodos de autenticação necessários
Preserva as respostas originais da API sem modificação

Fonte da Documentação da API

Todos os endpoints e funcionalidades da API são baseados na documentação oficial do TeamRetro:

Artigo de Ajuda da API: https://help.teamretro.com/article/320-teamretro-api
Especificações da API: https://groupmap.stoplight.io/docs/teamretro/
A implementação segue estritamente as especificações da API pública
Quaisquer alterações na API do TeamRetro podem afetar a funcionalidade deste servidor MCP

Como Usar

NPX (Recomendado, Configuração Fácil)

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

Instalação via Smithery

Para instalar o TeamRetro MCP Server para Claude Desktop automaticamente via Smithery:

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

A partir do Código Fonte

Clone o repositório, instale as dependências e compile o projeto:

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

Executando em um Cliente de IA

Configure o cliente de IA com as seguintes configurações:

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

Executando com o Inspector

Configure as variáveis de ambiente copiando .env.example para .env e modificando-o de acordo com suas necessidades.
Execute o servidor com o inspector:

pnpm run inspector

Exemplos de Variáveis de Ambiente

URL Base

A URL base para a API do TeamRetro pode ser definida usando a variável de ambiente TEAMRETRO_BASE_URL. Por padrão, ela é definida como https://api.teamretro.com.

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

Autenticação por Chave de API

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

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas:

Usuários

list_users: Lista usuários com paginação usando os parâmetros offset e limit para controlar o número de resultados retornados
add_user: Adiciona um novo usuário ou atualiza as informações de um usuário existente pelo endereço de e-mail, especificando name e emailAddress opcionais
update_user: Atualiza os detalhes de um usuário existente, como name e emailAddress, fornecendo o e-mail atual
delete_user: Exclui um usuário pelo endereço de e-mail
get_user: Recupera informações detalhadas sobre um único usuário pelo endereço de e-mail

Equipes

list_teams: Lista equipes do TeamRetro com filtragem por tags e IDs, e paginação usando os parâmetros offset e limit
detail_team: Recupera informações detalhadas sobre uma única equipe pelo seu ID exclusivo
update_team: Atualiza os detalhes de uma equipe existente, como nome e tags associadas, fornecendo o ID da equipe
create_team: Cria uma nova equipe com um nome obrigatório e tags e membros opcionais
delete_team: Exclui uma equipe existente pelo seu ID

Membros da Equipe

list_team_members: Recupera uma lista de membros da equipe para um ID de equipe especificado com controles de paginação para offset e limit
get_team_member: Busca um membro da equipe pelo endereço de e-mail dentro de uma equipe especificada
update_team_member: Atualiza os detalhes de um membro da equipe, como nome ou status de administrador da equipe, pelo endereço de e-mail dentro de uma equipe especificada
remove_team_member: Remove um membro da equipe de uma equipe pelo endereço de e-mail
add_team_member: Adiciona um novo membro da equipe a uma equipe pelo endereço de e-mail, com especificação opcional do status de administrador da equipe

Ações

list_actions: Recupera uma lista de ações do TeamRetro com filtragem opcional por tags de equipe e IDs de equipe, e controles de paginação para offset e limit
create_action: Cria uma nova ação no TeamRetro com detalhes obrigatórios como ID da equipe, título, data de vencimento, status de conclusão e usuário atribuído
get_action: Busca uma única ação pelo seu ID exclusivo no TeamRetro
update_action: Atualiza uma ação existente no TeamRetro com novos detalhes como título, data de vencimento, status de conclusão, prioridade e usuário atribuído
delete_action: Exclui uma ação existente do TeamRetro pelo seu ID de ação

Acordos

list_agreements: Lista acordos do TeamRetro com filtragem opcional por tags de equipe e IDs de equipe, bem como controles de paginação
create_agreement: Cria um novo acordo no TeamRetro especificando a equipe à qual pertence e seu título
get_agreement: Recupera um único acordo pelo seu identificador exclusivo
update_agreement: Atualiza os detalhes de um acordo existente, como título ou equipe associada
delete_agreement: Exclui um acordo existente especificando seu identificador exclusivo

Health Checks

list_health_checks: Lista health checks do TeamRetro com filtragem opcional por IDs de modelo de saúde, tags de equipe e IDs de equipe, bem como controles de paginação
get_health_check: Recupera um único health check pelo seu identificador exclusivo com atributos opcionais a incluir
delete_health_check: Exclui um health check existente especificando seu identificador exclusivo

Modelos de Saúde

list_health_models: Lista modelos de saúde do TeamRetro com controles de paginação
get_health_model: Recupera um único modelo de saúde pelo seu identificador exclusivo

Retrospectivas

list_retrospectives: Lista retrospectivas do TeamRetro com filtragem por tags e IDs de equipe, e paginação usando os parâmetros offset e limit
get_retrospective: Recupera informações detalhadas sobre uma única retrospectiva pelo seu ID exclusivo
delete_retrospective: Exclui uma retrospectiva existente pelo seu ID

Relatórios

team_activity_report: Gera um relatório de atividade da equipe do TeamRetro com filtragem por tags de equipe e IDs de equipe
team_actions_activity_report: Gera um relatório de atividade de ações da equipe do TeamRetro com filtragem por tags de equipe e IDs de equipe. Retorna dados CSV com estatísticas de ações, incluindo contagens de ações abertas, concluídas e atrasadas agrupadas por faixas de idade
retrospective_activity_report: Gera um relatório de atividade de retrospectivas do TeamRetro com filtragem por intervalo de datas, tags de equipe e IDs de equipe. Retorna dados CSV com estatísticas de retrospectivas, incluindo taxa de participação, contagem de ideias, contagem de comentários, contagem de ações e contagem de acordos
health_check_activity_report: Gera um relatório de atividade de health checks do TeamRetro com filtragem por intervalo de datas, tags de equipe e IDs de equipe. Retorna dados CSV com estatísticas de health checks, incluindo taxa de participação, contagem de comentários, contagem de ações e contagem de acordos
team_health_latest_report: Gera um relatório de saúde da equipe (mais recente) do TeamRetro para um modelo de saúde específico com filtragem por intervalo de datas, tags de equipe e IDs de equipe. Retorna dados CSV com as pontuações de saúde mais recentes da equipe, incluindo dimensões de saúde
team_health_historical_report: Gera um relatório de saúde da equipe (histórico) do TeamRetro para um modelo de saúde específico com filtragem por intervalo de datas, tags de equipe e IDs de equipe. Retorna dados CSV com pontuações históricas de saúde da equipe, incluindo dimensões de saúde
users_report: Gera um relatório de usuários do TeamRetro com filtragem por tags de equipe e IDs de equipe. Retorna dados CSV com informações de usuários, incluindo funções de conta, associações de equipe e estatísticas de atividade

Changelog

Para uma lista detalhada de alterações e atualizações, consulte CHANGELOG.md.