TeamRetro MCPサーバー

「TeamRetro」MCPサーバーは何をするのか？

TeamRetro MCPサーバーは、AIアシスタントとTeamRetroプラットフォームを統合するためのModel Context Protocol (MCP) サーバーです。AIクライアントとTeamRetro公式APIの橋渡し役となり、チーム管理やふりかえり、ヘルスチェックなどのコラボレーション機能へシームレスにアクセス可能にします。20種類以上の標準化MCPツールを公開しており、チームやユーザー、アクションの管理、分析インサイトの取得などのタスク自動化が可能です。TeamRetro MCPサーバーは安全なAPI認証をサポートし、効率的なデータ処理のためのページネーションやフィルタリングも内蔵。これにより、AIアプリケーションは簡単にTeamRetroの機能をワークフローへ組み込み、生産性向上やAI主導のチーム分析・管理を実現します。

プロンプト一覧

利用可能なドキュメントやリポジトリファイルにはプロンプトテンプレートの記載はありません。

リソース一覧

利用可能なドキュメントやリポジトリファイルには明示的なリソースの記載はありません。

ツール一覧

• READMEには、サーバーが20以上のチーム・ユーザー・アクション管理などのツールを公開していると記載されていますが、これらのツールの名前や詳細はドキュメントやファイルからは確認できません。*

このMCPサーバーのユースケース

• AIによるチーム分析
  TeamRetroのデータを活用し、自動インサイトやレポートを生成。チームの健康状態やパフォーマンスに基づく意思決定を支援。

• ふりかえり管理の自動化
  AIでふりかえりのスケジューリング、実施、要約を自動化し、手作業の負担を軽減しつつ実効性を担保。

• カスタムAIワークフローへの統合
  TeamRetroの各種機能を他のAIツールやダッシュボードと連携し、チーム管理プロセスを効率化。

• ヘルスチェック自動化
  ヘルスチェックのトリガーや分析を自動化し、リーダーにリアルタイムでチームの感情やエンゲージメントデータを提供。

• 効率的なチーム・ユーザー管理
  チームやユーザーの新規作成・削除・変更などをAIインターフェースから簡単に実施し、管理効率を向上。

セットアップ方法

Windsurf

1. ご利用のシステムにNode.jsとnpmがインストールされていることを確認します。

2. Windsurfの設定ファイル（例: windsurf.config.json）を探します。

3. mcpServersセクションにTeamRetro MCPサーバーを追加します:

   {
     "mcpServers": {
       "teamretro-mcp": {
         "command": "npx",
         "args": ["@teamretro/mcp-server@latest"]
       }
     }
   }
   

4. 設定を保存し、Windsurfを再起動します。

5. MCPサーバーがプラットフォームで正常に稼働し、アクセスできるか確認します。

APIキーの安全管理

TeamRetro APIキーは環境変数で設定してください。例:

{
  "mcpServers": {
    "teamretro-mcp": {
      "command": "npx",
      "args": ["@teamretro/mcp-server@latest"],
      "env": {
        "TEAMRETRO_API_KEY": "your-teamretro-api-key"
      }
    }
  }
}

Claude

1. Node.jsとnpmがインストールされていない場合は導入します。

2. Claudeの設定ファイルを開きます。

3. TeamRetro MCPサーバーを以下のように追加します:

   {
     "mcpServers": {
       "teamretro-mcp": {
         "command": "npx",
         "args": ["@teamretro/mcp-server@latest"]
       }
     }
   }
   

4. Claudeを再起動し、新しいMCPサーバーを読み込みます。

5. Claude内のMCP接続状況を確認してセットアップを検証します。

Cursor

1. Node.jsとnpmが利用できる状態にします。

2. Cursorのsettings.json（またはプラットフォーム専用設定）を編集します。

3. TeamRetro MCPサーバーを含めます:

   {
     "mcpServers": {
       "teamretro-mcp": {
         "command": "npx",
         "args": ["@teamretro/mcp-server@latest"]
       }
     }
   }
   

4. 変更を保存し、Cursorを再起動します。

5. MCP統合の状況を確認します。

Cline

1. Node.jsとnpmをインストールします。

2. ClineのMCP設定ファイルを開きます。

3. 以下のエントリを追加します:

   {
     "mcpServers": {
       "teamretro-mcp": {
         "command": "npx",
         "args": ["@teamretro/mcp-server@latest"]
       }
     }
   }
   

4. 保存してClineを再起動します。

5. TeamRetro MCPサーバーが正常動作しているか検証します。

APIキーの安全管理

機密情報の管理には必ず環境変数を利用してください。例:

{
  "mcpServers": {
    "teamretro-mcp": {
      "command": "npx",
      "args": ["@teamretro/mcp-server@latest"],
      "env": {
        "TEAMRETRO_API_KEY": "your-teamretro-api-key"
      }
    }
  }
}

フロー内でこのMCPを使う方法

FlowHuntでMCPを使う

FlowHuntワークフローにMCPサーバーを統合するには、まずフローにMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションで、以下のJSON形式でMCPサーバー情報を入力します:

{
  "teamretro-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPをツールとして利用でき、すべての機能へアクセスできます。“teamretro-mcp"はご利用のMCPサーバー名に、“url"はご自身のMCPサーバーURLに置き換えてください。

概要

提供されたドキュメントによると、TeamRetro MCPサーバーは概要とセットアップガイドが充実していますが、プロンプトテンプレートや明示的なリソース、ツールの詳細な公開ドキュメントが不足しています。環境変数による安全なAPIキー管理をサポートしていますが、Rootsやサンプリング対応については記載がありません。プロジェクトはオープンソースでApache-2.0ライセンスです。

当社の所感

本MCPサーバーはセットアップ・統合のドキュメントや信頼性の高いオープンソースライセンスが魅力です。一方で、ツールやプロンプト、リソースの詳細なドキュメントが不足しており、即時利用性や発見性が低下しています。もし不足部分が補完されれば、ユーザー体験や開発者統合が大きく向上するでしょう。

MCPスコア