Проекты и участники
Получать список проектов, просматривать активность и версии, проверять модули и управлять участниками при наличии необходимых прав.
Как это работает
Предоставьте 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. Назначьте доступВключите глобальное разрешение «Использовать 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.Да. Плагин проверяет глобальное разрешение «Использовать MCP» в дополнение к стандартным правам пользователя в Redmine.
Да. Режим только для чтения блокирует создание, изменение и удаление данных, сохраняя доступ к инструментам чтения.
Нет. MCP-клиенту нужен только сетевой доступ к эндпоинту Redmine /mcp. Подключение может быть публичным или частным — это зависит от места запуска клиента.
Да. Другие плагины Redmine могут регистрировать собственные инструменты, ресурсы, промпты и возможности через API расширений Redmine MCP. Администраторы выбирают, какие из обнаруженных расширений включить. См. руководство по расширениям.
Изучите код и установите Redmine MCP
В репозитории есть инструкция по установке, пример настройки клиента, полный справочник инструментов и раздел диагностики.
Наш бот в Телеграм