プロジェクトとメンバー
プロジェクトの一覧、活動とバージョンの確認、モジュールの参照、権限がある場合のプロジェクトメンバーの管理。
仕組み
AIクライアントに制御されたRedmineへのアクセスを提供
Model Context Protocolは、AIクライアントが共通インターフェイス経由で外部システムのツールを使えるオープン標準です。Redmine MCPは別の連携サービスなしに、Redmine内からそのインターフェイスを提供します。
- 60+
- 組み込みツール
- GPL v2+
- オープンソースライセンス
- 6.0–7.0
- 対応Redmineバージョン
Redmine MCP経由でクライアントができること
サーバーは無制限のデータベースアクセスではなく、専用のMCPツールを公開します。利用できるツールは、現在のユーザーの権限、プロジェクトへのアクセス、有効な拡張機能に依存します。
チケットとコメント
チケットの検索、作成、更新、注記と添付ファイルの追加、関連、子チケット、ウォッチャー、カテゴリの操作。
検索と保存されたクエリ
チケットとWikiページの検索、チケット一覧のフィルタ、クライアント側でフィルタを作り直さずに保存されたRedmineクエリの実行。
作業時間の記録
作業時間の参照、作成、更新、活動の種類の確認、複数件の一括インポート。
Wikiとフォーラム
プロジェクトのWikiページの参照、作成、更新。フォーラム、トピック、メッセージスレッドの閲覧。
ファイルと添付ファイル
プロジェクトファイルの一覧、ファイルと添付ファイルのアップロード、添付ファイルのメタデータの確認、文書化された制限内での対応添付ファイルのダウンロード。
はじめに
プラグインをインストールしてクライアントを接続
インストールは標準のRedmineプラグイン手順に従います。管理者がMCPを有効にしてアクセスを割り当て、各ユーザーは自身のRedmine APIキーで接続します。
- 1. Redmine MCPをインストールgitリポジトリをRedmineのプラグインディレクトリにクローンします
cd /path/to/redmine/plugins git clone https://github.com/rkteam/redmine_mcp.git - 2. 依存関係をインストールRedmineのルートディレクトリから依存関係をインストールし、Redmineを再起動します
cd /path/to/redmine bundle install - 3. MCPとREST APIを有効化プラグイン設定でMCPを有効にし、RedmineのAPI設定でRESTウェブサービスを有効にします。
- 4. アクセスを割り当て必要なロールにグローバル権限 Use MCP を有効にします。管理者は自動的にMCPへアクセスできます。
- 5. クライアントを設定MCPサーバーURLを https://your-redmine.example.com/mcp に設定し、ユーザーのRedmine APIキーで認証します。キーは「個人設定 → APIアクセスキー」で確認できます。
Cursorの設定例
.cursor/mcp.json{
"mcpServers": {
"redmine": {
"url": "https://your-redmine.example.com/mcp",
"headers": {
"X-Redmine-API-Key": "your_api_key"
}
}
}
}MCP設定の正確な形式はクライアントのバージョンによって異なる場合があります。APIキーをソース管理に含めないでください。
アクセス制御はRedmineが担います
プラグインはRedmineの権限モデルを迂回しません。MCPアクセスはRedmineの権限や可視性ルールを置き換えず、追加のアクセスチェックを行います。
権限と可視性
ツールは認証済みユーザーの既存のRedmine権限と可視性ルールを尊重します。
読み取り専用モード
管理者は作成、更新、削除を禁止し、読み取り専用ツールだけを利用可能にできます。
より安全な書き込み操作
一部の書き込み操作には、競合する更新や意図しない重複リソース作成への対策があります。
互換性
Redmine 6.0–7.0 · REST API必須
拡張できるように設計
他のRedmineプラグインからMCPを拡張
他のRedmineプラグインは、Redmine MCP自体を変更せずに、Redmine MCP拡張API経由で独自のツール、リソース、プロンプト、機能を登録できます。管理者は検出された拡張のうち有効にするものを選びます。
Redmine MCP FAQ
Redmine MCPは現在Redmine 6.0–7.0をサポートしています。プロトコルとSDKのバージョンは互換性ドキュメントを参照してください。
Streamable HTTPとカスタムHTTPヘッダーをサポートするMCPクライアントであれば接続できます。ドキュメントにはCursorの設定例があります。
各ユーザーは
X-Redmine-API-Keyヘッダー内のRedmine APIキーで認証します。RedmineでREST APIを有効にする必要があります。はい。プラグインは認証済みユーザーの既存のRedmine権限と可視性ルールに加え、グローバル権限 Use MCP を確認します。
はい。読み取り専用モードは作成、更新、削除をブロックし、読み取りツールは利用可能なままにします。
いいえ。MCPクライアントはRedmineの /mcp エンドポイントへのネットワークアクセスだけが必要です。接続はクライアントの実行場所に応じて公開でも非公開でも構いません。
はい。他のRedmineプラグインはRedmine MCP拡張API経由で独自のツール、リソース、プロンプト、機能を登録できます。管理者は検出された拡張のうち有効にするものを選びます。拡張ガイドを参照してください。
ソースを確認してRedmine MCPをインストール
リポジトリにはインストール手順、クライアント設定、ツールの完全なリファレンス、トラブルシューティングがあります。
Telegramボット