TeamRetro MCP サーバー

TeamRetro 統合用のモデルコンテキストプロトコル (MCP) サーバー。

重要な注意事項

非公式MCPサーバー

このMCPサーバーは、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（推奨、簡単なセットアップ）

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

ソースコードから

リポジトリをクローンし、依存関係をインストールして、プロジェクトをビルドします。

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 : アクションIDでTeamRetroから既存のアクションを削除します。

合意

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