Бесплатный open-source плагин для Redmine

Подключите AI-клиенты к Redmine через MCP

Redmine MCP запускает сервер Model Context Protocol внутри Redmine. AI-клиенты с поддержкой MCP могут работать с задачами, проектами, трудозатратами, Wiki и файлами с учетом прав пользователя.

Как это работает

Предоставьте AI-клиентам контролируемый доступ к Redmine

Model Context Protocol — открытый стандарт, который позволяет AI-клиентам использовать инструменты внешних систем через единый интерфейс. Redmine MCP предоставляет этот интерфейс непосредственно из Redmine, без необходимости в отдельном сервисе интеграции.

60+: встроенных инструментов
GPL v2+: open-source лицензия
6.0–7.0: поддерживаемые версии Redmine

Что можно делать через Redmine MCP

Сервер предоставляет специализированные MCP-инструменты вместо прямого доступа к базе данных. Доступные инструменты зависят от прав пользователя, доступа к проектам и включённых расширений.

Проекты и участники

Получать список проектов, просматривать активность и версии, проверять модули и управлять участниками при наличии необходимых прав.

Задачи и комментарии

Искать, создавать и изменять задачи, добавлять комментарии и вложения, работать со связями, подзадачами, наблюдателями и категориями.

Поиск и сохранённые запросы

Искать по задачам и Wiki, фильтровать списки задач и использовать сохранённые запросы Redmine без повторной настройки фильтров в клиенте.

Учёт времени

Получать, создавать и изменять записи трудозатрат, смотреть типы активности и импортировать несколько записей за одну операцию.

Wiki и форумы

Читать, создавать и изменять Wiki-страницы проектов; просматривать форумы, темы и цепочки сообщений.

Файлы и вложения

Получать список файлов проекта, загружать файлы и вложения, смотреть метаданные вложений и скачивать поддерживаемые вложения с учётом установленных ограничений.

Начало работы

Установите плагин и подключите клиент

Установка выполняется по стандартной схеме для плагинов Redmine. Администратор включает MCP и назначает доступ, а каждый пользователь подключается с помощью своего API-ключа Redmine.

1. Установите Redmine MCPКлонируйте git-репозиторий в каталог плагинов Redmine.
```
cd /path/to/redmine/plugins
git clone https://github.com/rkteam/redmine_mcp.git
```
2. Установите зависимостиИз корневого каталога Redmine установите зависимости.
```
cd /path/to/redmine
bundle install
```
3. Включите MCP и REST APIВключите MCP в настройках плагина и REST API в настройках Redmine.
4. Назначьте доступВключите глобальное разрешение Use MCP для нужных ролей. Администраторы получают доступ к MCP автоматически.
5. Настройте клиентУкажите URL MCP-сервера https://your-redmine.example.com/mcp и используйте API-ключ пользователя Redmine для аутентификации. Ключ доступен в разделе «Моя учётная запись» → «Ключ доступа к 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 6.0–7.0 · требуется REST API

Расширяемая архитектура

Расширяйте MCP с помощью других плагинов Redmine

Другие плагины Redmine могут регистрировать собственные инструменты, ресурсы, промпты и возможности через API расширений Redmine MCP без внесения изменений в Redmine MCP. Администраторы выбирают, какие обнаруженные расширения включить.

Вопросы о Redmine MCP

Redmine MCP поддерживает Redmine 6.0–7.0. Версии протокола и SDK указаны в документации по совместимости.
Redmine MCP можно использовать с любым MCP-клиентом, который поддерживает Streamable HTTP и пользовательские HTTP-заголовки. В документации приведён пример настройки Cursor.
Каждый пользователь проходит аутентификацию с помощью API-ключа Redmine в заголовке X-Redmine-API-Key. В Redmine должен быть включён REST API.
Да. Плагин проверяет глобальное разрешение Use MCP в дополнение к стандартным правам пользователя в Redmine.
Да. Режим только для чтения блокирует создание, изменение и удаление данных, сохраняя доступ к инструментам чтения.
Нет. MCP-клиенту нужен только сетевой доступ к endpoint Redmine /mcp. Подключение может быть публичным или частным — это зависит от места запуска клиента.
Да. Другие плагины Redmine могут регистрировать собственные инструменты, ресурсы, промпты и возможности через API расширений Redmine MCP. Администраторы выбирают, какие обнаруженные расширения включить. См. инструкцию.

Изучите код и установите Redmine MCP

В репозитории есть инструкция по установке, пример настройки клиента, полный справочник инструментов и раздел диагностики.

RedmineKanban

Наш бот в Телеграм

Наш канал в Телеграм

[email protected]

Кастомная разработка Redmine Cloud Блог Политика конфиденциальности Контакты Условия и положения Политика возврата