TeamRetro MCP 서버

TeamRetro 통합을 위한 MCP(Model Context Protocol) 서버.

중요 참고 사항

비공식 MCP 서버

이 MCP 서버는 TeamRetro 서비스를 위한 비공식 커뮤니티 개발 인터페이스입니다. TeamRetro에서 개발하거나 보증하지는 않지만, TeamRetro 플랫폼에 대한 표준화된 액세스를 제공합니다.

공식 API 통합

서버는 TeamRetro의 공식 공개 API에 직접 연결됩니다.

TeamRetro의 API 사양에서 문서화된 엔드포인트를 사용합니다.
API 규정 준수 및 버전 추적을 완벽하게 유지합니다.
필요한 모든 인증 방법을 구현합니다.
수정 없이 원래 API 응답을 보존합니다.

API 문서 소스

모든 API 엔드포인트와 기능은 TeamRetro의 공식 문서를 기반으로 합니다.

API 도움말 문서: https://help.teamretro.com/article/320-teamretro-api
API 사양: https://groupmap.stoplight.io/docs/teamretro/
구현은 공개 API 사양을 엄격히 따릅니다.
TeamRetro API의 변경 사항은 이 MCP 서버의 기능에 영향을 미칠 수 있습니다.

사용 방법

NPX(추천, 간편 설정)

지엑스피1

소스 코드에서

저장소를 복제하고 종속성을 설치한 다음 프로젝트를 빌드합니다.

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

AI 클라이언트에서 실행

다음 설정으로 AI 클라이언트를 구성하세요.

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

Inspector로 실행

.env.example``.env 로 복사하고 필요에 맞게 수정하여 환경 변수를 구성합니다.
검사기를 사용하여 서버를 실행합니다.

npm run inspector

환경 변수 예제

기본 URL

TeamRetro API의 기본 URL은 TEAMRETRO_BASE_URL 환경 변수를 사용하여 설정할 수 있습니다. 기본적으로 https://api.teamretro.com 으로 설정되어 있습니다.

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

API 키 인증

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

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

사용자

list_users : 오프셋 및 제한 매개변수를 사용하여 페이지 매김을 통해 사용자를 나열하고 반환되는 결과 수를 제어합니다.
add_user : 이메일 주소로 새 사용자를 추가하거나 기존 사용자 정보를 업데이트합니다. 이때 선택적 name과 emailAddress를 지정합니다.
update_user : 현재 이메일을 제공하여 이름, 이메일 주소 등 기존 사용자의 세부 정보를 업데이트합니다.
delete_user : 이메일 주소로 사용자를 삭제합니다.
get_user : 이메일 주소로 단일 사용자에 대한 자세한 정보를 검색합니다.

팀

list_teams : 오프셋 및 제한 매개변수를 사용하여 태그 및 ID로 필터링하고 페이징하여 TeamRetro의 팀을 나열합니다.
detail_team : 고유 ID로 단일 팀에 대한 자세한 정보를 검색합니다.
update_team : 팀 ID를 제공하여 기존 팀의 세부 정보(예: 이름 및 관련 태그)를 업데이트합니다.
create_team : 필수 이름, 선택적 태그 및 멤버를 사용하여 새 팀을 만듭니다.
delete_team : ID로 기존 팀을 삭제합니다.

팀원들

list_team_members : 오프셋 및 제한에 대한 페이지 매김 제어를 사용하여 지정된 팀 ID에 대한 팀 구성원 목록을 검색합니다.
get_team_member : 지정된 팀 내에서 이메일 주소로 팀원을 가져옵니다.
update_team_member : 지정된 팀 내에서 이메일 주소를 사용하여 이름이나 팀 관리자 상태와 같은 팀 구성원의 세부 정보를 업데이트합니다.
remove_team_member : 이메일 주소로 팀에서 팀원을 제거합니다.
add_team_member : 이메일 주소로 팀에 새 팀원을 추가합니다. 팀 관리자 상태를 선택적으로 지정할 수 있습니다.

행위

list_actions : 팀 태그 및 팀 ID로 선택적 필터링과 오프셋 및 제한에 대한 페이지 매김 제어를 통해 TeamRetro에서 작업 목록을 검색합니다.
create_action : 팀 ID, 직함, 마감일, 완료 상태, 할당된 사용자 등 필수 세부 정보를 사용하여 TeamRetro에서 새 작업을 만듭니다.
get_action : TeamRetro에서 고유 ID로 단일 작업을 가져옵니다.
update_action : 제목, 마감일, 완료 상태, 우선 순위, 할당된 사용자 등의 새로운 세부 정보로 TeamRetro의 기존 작업을 업데이트합니다.
delete_action : TeamRetro에서 작업 ID로 기존 작업을 삭제합니다.

계약

list_agreements : 팀 태그 및 팀 ID로 선택적 필터링과 페이지 매김 제어를 통해 TeamRetro의 계약 목록을 나열합니다.
create_agreement : 소속 팀과 제목을 지정하여 TeamRetro에 새 계약을 만듭니다.
get_agreement : 고유 식별자로 단일 계약을 검색합니다.
update_agreement : 기존 계약의 세부 정보(예: 제목 또는 관련 팀)를 업데이트합니다.
delete_agreement : 고유 식별자를 지정하여 기존 계약을 삭제합니다.

건강 검진

list_health_checks : TeamRetro의 상태 검사를 나열하며 상태 모델 ID, 팀 태그, 팀 ID로 필터링하고 페이지 매김 제어 기능을 제공합니다.
get_health_check : 선택적 속성을 포함하여 고유 식별자로 단일 상태 검사를 검색합니다.
delete_health_check : 고유 식별자를 지정하여 기존 상태 검사를 삭제합니다.

건강 모델

list_health_models : 페이지네이션 컨트롤을 사용하여 TeamRetro의 건강 모델 목록 표시
get_health_model : 고유 식별자로 단일 건강 모델을 검색합니다.

회고록

list_retrospectives : 오프셋 및 제한 매개변수를 사용하여 팀 태그 및 ID로 필터링하고 페이지 번호를 지정하여 TeamRetro의 회고록을 나열합니다.
get_retrospective : 고유 ID로 단일 회고에 대한 자세한 정보를 검색합니다.
delete_retrospective : ID로 기존 회고록을 삭제합니다.

변경 사항

변경 사항 및 업데이트에 대한 자세한 목록은 CHANGELOG.md를 참조하세요.

TeamRetro MCP Server